POST /v1/keys, POST /v1/certificates/verify and GET /.well-known/jwks.json:
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 answers401 unauthorized at once.
Scopes
Every key has the scopesread, 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.