Skip to main content
Send the key on every call except POST /v1/keys, POST /v1/certificates/verify and GET /.well-known/jwks.json:
The same key works for the REST API and the MCP server.

Two kinds of key

Both kinds call the same API and spend the same credits. Every key comes with three demo accounts: acct_demo_concentrated, acct_demo_etf and acct_demo_tech. Demo accounts do not count toward your plan’s portfolio limit.

Get a sandbox key in one call

201 Created. The response holds key (shown once), key_id, org_id, kind, plan, scopes, limits, claim_url, accounts (the three demo accounts) and next (a first call to make). Each demo account has a try hint: a question to analyze and a goal to propose. Keep the key in an environment variable, such as ABACUS_API_KEY; the examples in these docs use that name. A key made this way starts a new organisation on the free Personal plan: 3 portfolios and 300 credits a month. See Credits and plans.

Claim a key

An agent can get a key before any human signs up. claim_url (https://app.abacuslabs.ai/claim?token=...) is valid for 7 days. Show it to your human. When they sign in there, the key and its saved accounts move into their organisation, and the key then uses their plan and credits. The key itself does not change.

Live keys and the dashboard

Sign up at app.abacuslabs.ai/signup. In the dashboard you can create, roll and revoke keys (live or sandbox), see usage and request logs, choose a plan, buy credits and set a monthly spend cap for the organisation. A revoked key answers 401 unauthorized at once.

Scopes

Every key has the scopes read, propose and commit. /v1/accounts calls work with any valid key. A call without the scope it needs answers 403 forbidden.

Rate limits

Polling a running proposal counts as a call. Use ?wait=N on GET /v1/proposals/{id} so one call waits up to N seconds (see Proposals).

Request ids and versions

Every response has these headers: POST /v1/analyze, POST /v1/proposals, POST /v1/trades/check and POST /v1/accounts also take an optional Idempotency-Key header: a retry with the same key returns the first answer and charges nothing again. POST /v1/commits always needs one. See Errors. Every authenticated /v1 call also returns Abacus-Credits-Charged and Abacus-Credits-Remaining. See Credits and plans.