canonical: https://jentic.com/apis/corpstacking.com/corpstacking # CorpStacking API The CorpStacking API reports the Bitcoin, Ethereum, Solana, and XRP treasury holdings of corporate, government, and ETF holders, along with the SEC filings, prices, and historical purchases behind them. It lists tracked treasuries, returns a single holder's detail and purchase history, serves aggregate stats and live token prices, and carries a real-time signals feed over both polling and Server-Sent Events. Every holdings figure ships with how it was verified and a link to its primary source. ## For AI agents Query verified corporate, government, and ETF crypto treasury holdings, prices, historical purchases, and a real-time signals feed. Every holdings figure ships with how it was verified and a source link. ## Scope Does not handle trade execution, portfolio management, or custody. Use for querying verified crypto treasury holdings, prices, and signals only. ## Capabilities - Query corporate, government, and ETF treasury holdings of Bitcoin, Ethereum, Solana, and XRP - Retrieve a single treasury's holdings detail and purchase history - Pull aggregate treasury stats across all tracked holders - Read live token prices and global market stats - Stream a real-time treasury signals feed over Server-Sent Events - Subscribe a webhook to treasury activity and inspect its delivery history ## Use cases ### Agent-Monitored Treasury Signals An AI agent connected through Jentic watches the CorpStacking signals feed for new corporate crypto purchases and surfaces each one with the verification method and primary source attached. Because the feed is available over Server-Sent Events, the agent reacts as signals land rather than polling on a timer. Example prompt: Read the treasury signals feed, pick up a new purchase signal, and return the holder, token, and the primary source link behind it ### Corporate Crypto Holdings Research A research workflow pulls the full list of tracked treasuries and then the detail and purchase history for a specific holder, grounding each figure in the SEC filing or source CorpStacking verified it against. This replaces hand-collecting disclosures with a single queryable dataset of who holds what. Example prompt: List tracked treasuries, fetch one holder's detail by slug, and report its current holdings and most recent purchase ### Market Price Context An analytics job reads live token prices and global market stats alongside the holdings data, so a treasury's position can be valued at current prices in the same integration. The market endpoint keeps price context next to the holdings rather than wiring a separate price source. Example prompt: Read live token prices and combine them with a holder's reported holdings to estimate the position's current value ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/treasuries` | List all tracked treasuries | | GET | `/treasuries/{slug}` | Single treasury detail and activity history | | GET | `/stats` | Aggregate treasury stats | | GET | `/activity` | Paginated treasury activity feed | | GET | `/market` | Live token prices and global stats | | GET | `/signals` | Treasury signals feed | | POST | `/webhooks` | Create a webhook subscription | ## Key resources - **Treasuries** — List tracked treasuries and read a single holder's detail and activity history - **Market** — Read live token prices and global market stats - **Signals** — Read and stream the treasury signals feed - **Webhooks** — Create, list, and delete webhook subscriptions and inspect delivery history ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 69 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 99 / 100 - Developer Experience & Jentic Compatibility: 68 / 100 - AI-Readiness & Agent Experience: 52 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 86 / 100 - **View full report:** https://jentic.com/apis/corpstacking.com/corpstacking/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the CorpStacking API by hand means sending the x-api-key header on every call, handling its wrapped data-and-meta JSON responses, and treating the raw exports and event stream differently from the JSON endpoints. Through Jentic you install once, import CorpStacking from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** CorpStacking puts the treasury slug in the URL path (`/treasuries/{slug}`), so a rule can pin your agent to one treasury and the operations you pick, such as reading its holdings and activity. You choose the operations it may call, so the webhook-delete operation is not included unless you add it. - **Credential handling:** Your CorpStacking API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'which companies hold Bitcoin' or 'latest crypto treasury signals', and Jentic returns the matching CorpStacking operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **CoinAPI** — Serves broad crypto market and exchange data, where CorpStacking focuses specifically on verified corporate and institutional treasury holdings. - **CoinGecko API** — Supplies market caps and token prices that pair with CorpStacking's holdings figures. - **Polygon.io API** — Covers equities and market data for the public companies that appear as crypto treasury holders. ## FAQ ### What authentication does the CorpStacking API use? The CorpStacking API authenticates with an API key sent in the x-api-key header per its OpenAPI spec, and a key in the query string is not accepted. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's context. ### Can I query a single company's crypto treasury holdings with the CorpStacking API? Yes. Fetch a holder by its slug to get the treasury detail and purchase history, with every holdings figure carrying how it was verified and a link to its primary source. The list endpoint returns all tracked corporate, government, and ETF holders to pick from. ### Can I limit what my agent is allowed to do with the CorpStacking API? Yes. Write a rule that allows only the read operations, such as listing treasuries, reading a holder's detail, and the market and signals feeds, so your agent can research holdings but cannot create or delete webhook subscriptions, and every call it makes is logged. ### What are the rate limits for the CorpStacking API? The CorpStacking API exposes a usage endpoint that returns your current rate limit and quota, so your agent can read its own ceiling at runtime; the OpenAPI spec does not hard-code a numeric figure. Check the usage endpoint for the limit that applies to your key. ### How do I find which companies hold Bitcoin with the CorpStacking API through Jentic? Search Jentic for 'which companies hold Bitcoin in their treasury' and it returns the treasuries-listing operation with its input schema; your agent filters by token and reads each holder's detail. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Is there a CorpStacking MCP server? You don't need an MCP server to give your agent the CorpStacking API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the holdings, market, and signals operations with scoping and credential isolation applied.