{"openapi":"3.1.0","info":{"title":"Arkolith REST API","version":"1.0.0","description":"Real-world financial data: SEC 13F institutional holdings, quarter-over-quarter changes, and search. Bearer-key auth, metered by credits. MCP server with the full tool set lives at /api/mcp (see /api/mcp/catalog)."},"servers":[{"url":"https://arkolith.com/api/v1"}],"security":[{"bearerAuth":[]}],"paths":{"/funds":{"get":{"summary":"List 13F filer funds by AUM","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"Funds + pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientCredits"}}}},"/funds/{cik}":{"get":{"summary":"Fund details, managers, and filing history","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Fund detail"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"No fund with that CIK"}}}},"/funds/{cik}/holdings":{"get":{"summary":"Holdings for a fund's filing with QoQ changes","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string"}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"quarter","in":"query","schema":{"type":"integer","minimum":1,"maximum":4}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"Holdings + filing + pagination"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientCredits"}}}},"/search":{"get":{"summary":"Search funds, managers, and holdings","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"type","in":"query","schema":{"type":"string","enum":["all","funds","managers","holdings"],"default":"all"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Search results"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/credits":{"get":{"summary":"Credit balance for the key's org (free, unmetered)","responses":{"200":{"description":"Credit balance + USD value"},"401":{"$ref":"#/components/responses/Unauthorized"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Arkolith API key (ak_live_...). Mint at https://arkolith.com/connect."}},"responses":{"Unauthorized":{"description":"Missing or invalid API key"},"InsufficientCredits":{"description":"Wallet out of credits","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"needed":{"type":"integer"},"balance":{"type":"integer"},"topup_url":{"type":"string"}}}}}}},"schemas":{"FundList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"cik":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"aum_cents":{"type":"string","description":"AUM in cents (BigInt as string)"},"latest_quarter":{"type":"string"},"holdings_count":{"type":"integer"},"manager":{"type":["string","null"]}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"}}}}}}}}