{"uid":"cap_Oe35K4MKniIr72Fws6uoq","slug":"holdings-by-security-institutional-ownership-lookup-449c0349","name":"Holdings by Security — Institutional Ownership Lookup","description":"All institutional holders of one security in a quarter, by ticker or CUSIP, with concentration and quarter-over-quarter institutional flow. This reverse index is deferred on this deployment and returns availability status; a manager's crypto ETF exposure is covered now by the holdings manager route.","url":"https://api.agentstools.dev/holdings/security","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"cusip":{"type":"string","description":"Security CUSIP (9 chars)"},"ticker":{"type":"string","description":"Security ticker, e.g. IBIT"},"quarter":{"type":"string","description":"Quarter period-end date, ISO YYYY-MM-DD (default latest)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OUZeoXkS7ZxrMeutAih-t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all institutional holders of a given security in a quarter, with concentration metrics and quarter-over-quarter flow, identified by ticker or CUSIP; currently returns availability/deferral status for this reverse-index route.","exampleAgentPrompt":"Show me all the institutional holders of IBIT for the latest available quarter, including their concentration and any quarter-over-quarter flow changes.","exampleUseCases":null,"resultDescription":"A list of all institutional holders of the requested security in the specified quarter, with each holder's position size, concentration percentage, and quarter-over-quarter flow change — or, when the reverse index is deferred on this deployment, an availability/status response indicating when the data will be accessible.","failureModes":["Missing both ticker and CUSIP: returns error requiring at least one identifier","Unknown ticker or CUSIP: returns not-found or empty holder list","Reverse index deferred: returns availability/status object rather than holder data","Invalid quarter date format: returns validation error","Rate limit or payment failure: 402 payment required or 429 throttle response"],"whenToPreferThis":"Use this endpoint when you need to see all institutional holders of a specific security (identified by ticker or CUSIP) rather than all holdings of a specific manager. Prefer this over the holdings-manager route when the question is 'who owns X?' rather than 'what does manager Y own?'. Note that this reverse-index route is currently deferred on this deployment and returns an availability status rather than full holder data; use the holdings-manager route for a specific manager's crypto ETF exposure instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:05:30.847Z","isFirstParty":false}