Documentation Index Fetch the complete documentation index at: https://demircancelebi.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
The stocks endpoints aggregate portfolio entry data at the security level, letting you see which funds hold a given stock, how market values have changed over time, and how portfolio weights have trended across reporting periods. Each security is identified by a URL-safe key derived from its name and ISIN. You can retrieve the key from the stocks listing and use it to fetch the full holder and history detail for any security.
Endpoints Method Path Description GET/stocksList and search securities held across fund portfolios GET/stocks/{stockKey}Retrieve holder list and history for a specific security
Base URL: https://mkk-roan.vercel.app/apiGET /stocks Returns a paginated list of securities aggregated from portfolio holdings across all funds and documents.
Query parameters Free-text search against security names, ISIN codes, and issuer names. Returns securities whose name, ISIN, or issuer contains the query string.
Maximum number of securities to return. Accepts values from 1 to 1000.
Number of results to skip. Use with limit to paginate through large result sets.
Response schema Total number of securities matching the query.
Effective offset applied.
Array of security summary objects. Show StockSummary properties
URL-safe key uniquely identifying this security. Use this as the stockKey path parameter in GET /stocks/{stockKey}.
Security name as it appears in portfolio tables.
ISIN code of the security.
Portfolio section labels under which this security has been classified across all documents.
Total number of portfolio entries referencing this security across all documents and periods.
Number of distinct documents that include this security.
Number of distinct funds that have held this security at any point.
Number of funds currently holding this security in the most recent available period.
Aggregate market value of this security across all funds in the most recent available period.
Average portfolio weight of this security across all holder funds and periods, as a decimal (e.g., 0.045 for 4.5%).
Maximum portfolio weight observed for this security in any single fund and period.
Most recent reporting period in which this security appears, in YYYY-MM format.
Example requests List all stocks
Search by ISIN
Search by security name
curl https://mkk-roan.vercel.app/api/stocks
Example response { "total" : 3847 , "limit" : 50 , "offset" : 0 , "stocks" : [ { "key" : "turkiye-cumhuriyeti-15032026-tr0000000001" , "security" : "TURKIYE CUMHURIYETI 15.03.2026" , "isin" : "TR0000000001" , "issuer" : "Hazine ve Maliye Bakanlığı" , "sections" : [ "Devlet İç Borçlanma Senetleri" ], "entry_count" : 2840 , "document_count" : 1240 , "fund_count" : 87 , "latest_holder_count" : 34 , "latest_market_value" : 4821000000.0 , "average_weight" : 0.047 , "max_weight" : 0.182 , "latest_period" : "2024-01" } ] }
GET /stocks/ Returns full detail for a single security, including the current list of funds holding it and a time-series history of its aggregate market value and portfolio weight across all reporting periods.
The stockKey is a URL-safe slug generated from the security’s name and ISIN. Retrieve it from the key field in GET /stocks results.
Path parameters The URL-safe key for the security (e.g., turkiye-cumhuriyeti-15032026-tr0000000001). Available from the key field in GET /stocks.
Query parameters Maximum number of fund holders to return in the holders array.
Response schema Full summary object for the security. See the StockSummary schema above.
List of funds currently holding this security, with per-fund position details. Show StockHolding properties
Fund code of the holding fund.
ID of the document where this holding was recorded.
MKK disclosure index of the source document.
File name of the source document.
Reporting period (YYYY-MM).
Date the report was filed.
Number of portfolio entries for this security in this document.
Parsed numeric market value.
Raw nominal value string.
Parsed numeric nominal value.
This fund’s portfolio weight for this security as a decimal (e.g., 0.042 for 4.2%).
How the portfolio weight was calculated (e.g., computed or extracted).
The effective limit applied to the holders array.
Total number of holders, regardless of the applied limit.
history
StockHistoryPoint[]
required
Time-series data showing aggregate market value and portfolio weight trends across all reporting periods in which this security appears. Show StockHistoryPoint properties
Reporting period (YYYY-MM).
Date of the report for this period.
Representative disclosure index for this period.
Number of funds holding this security in this period.
Number of documents referencing this security in this period.
Aggregate market value across all holding funds in this period.
Average portfolio weight across all holding funds in this period.
Maximum portfolio weight among holding funds in this period.
Error responses Status Description 404No security with the given stockKey exists.
Example requests Stock detail
Stock detail with expanded holder list
curl "https://mkk-roan.vercel.app/api/stocks/turkiye-cumhuriyeti-15032026-tr0000000001"
Example response { "stock" : { "key" : "turkiye-cumhuriyeti-15032026-tr0000000001" , "security" : "TURKIYE CUMHURIYETI 15.03.2026" , "isin" : "TR0000000001" , "issuer" : "Hazine ve Maliye Bakanlığı" , "sections" : [ "Devlet İç Borçlanma Senetleri" ], "entry_count" : 2840 , "document_count" : 1240 , "fund_count" : 87 , "latest_holder_count" : 34 , "latest_market_value" : 4821000000.0 , "average_weight" : 0.047 , "max_weight" : 0.182 , "latest_period" : "2024-01" }, "holders" : [ { "fund_code" : "OJB" , "fund_title" : "Oyak Jinsi Bono Fonu" , "document_id" : 1042 , "disclosure_index" : "2023-TR-00012345" , "file_name" : "OJB_202306.pdf" , "period" : "2023-06" , "report_date" : "2023-07-04" , "pdf_url" : "https://mkk.org.tr/..." , "kap_file_url" : "https://kap.org.tr/file/..." , "kap_url" : "https://kap.org.tr/disclosure/..." , "section" : "Devlet İç Borçlanma Senetleri" , "security" : "TURKIYE CUMHURIYETI 15.03.2026" , "isin" : "TR0000000001" , "issuer" : "Hazine ve Maliye Bakanlığı" , "currency" : "TRY" , "entries_count" : 1 , "market_value" : "9.875.000" , "numeric_market_value" : 9875000.0 , "nominal_value" : "10.000.000" , "numeric_nominal_value" : 10000000.0 , "portfolio_weight" : 0.042 , "weight_source" : "computed" } ], "holder_limit" : 100 , "holder_total" : 34 , "history" : [ { "period" : "2024-01" , "report_date" : "2024-02-02" , "disclosure_index" : "2024-TR-00001234" , "fund_count" : 34 , "document_count" : 34 , "market_value" : 4821000000.0 , "average_weight" : 0.047 , "max_weight" : 0.182 }, { "period" : "2023-12" , "report_date" : "2024-01-03" , "disclosure_index" : "2024-TR-00000812" , "fund_count" : 36 , "document_count" : 36 , "market_value" : 4590000000.0 , "average_weight" : 0.044 , "max_weight" : 0.176 } ] }
{ "error" : "Stock not found" , "key" : "unknown-security-key" }
