Agent API
The same JSON API your hosted agent uses — read-mostly access to your portfolios, watchlists, market data, and reports, with Bearer authentication.
The Agent API is the same JSON API your hosted agent uses to do its work. With an API key, you can call it yourself: read your portfolios and watchlists, pull market data, and work with reports from your own scripts and tools.
- Base URL:
https://blockmind.app/api/agent - Auth: Bearer token (an API key)
- Format: JSON only — requests and responses
API keys are currently available to a limited set of accounts while we finish rolling this out. If you don't have a key yet, that's expected — general availability is coming.
What it gives you
The API is read-mostly: it's built for getting your data out and into your own workflows, not for changing things. Access is gated by scopes on your key — portfolio read, watchlist read/write, market read, and reports read/write. See Authentication & keys for how scopes work.
Everything you can read is the same data your agent reasons over: the portfolios you've connected, the watchlists you maintain, and the market data and reports behind its research. See Portfolios and Watchlists for what that data looks like in the product.
What you could build
A few things the API is a natural fit for:
- Portfolio in a spreadsheet. Pull your holdings into a sheet or a script and build your own views on top — allocation breakdowns, custom performance tracking, whatever your agent's dashboard doesn't cover.
- Market data in scripts. Fetch prices and market context programmatically instead of copy-pasting from a browser.
- Watchlist automation. Read and update your watchlists from your own tooling, and let your agent pick up the changes.
- Reports in your pipeline. Read research reports into your own notes or archive.
The API is for reading data and managing your own lists — it can never trade, withdraw, or move funds. Like your agent, it deals in research, not financial advice.
How to get started
- Read Authentication & keys — how keys, scopes, rotation, and revocation work.
- Read Conventions — response envelopes, pagination, and rate limits, consistent across every endpoint.
- Make
GET /capabilitiesyour first call. It tells you exactly what your key can do.
There's also a machine-readable summary of BlockMind at https://blockmind.app/llms.txt — useful if you're pointing your own AI tools at the product.
Where's the endpoint reference?
There isn't one yet. For now, this section covers the parts that are stable and worth building against: authentication, envelopes, pagination, and rate limits. GET /capabilities is always the authoritative answer for what your key can reach.
Related
DeepDive reports
Free AI research reports on any coin — how the public DeepDive flow works, the signed-in flow, real limits, and how reports relate to your agent.
Authentication & keys
How Agent API keys work — Bearer auth, scopes, the GET /capabilities first call, zero-downtime rotation, instant revocation, and the audit log.