The CryptoIA API
Source-cited research dossiers on 400+ crypto projects and the proof-of-work mining-launch radar, over a plain REST API. Every claim carries its source. Evidence gaps stay empty instead of guessed.
- DAY
- 100 / day
- BURST
- 10 / min
- PAGE
- 50 rows
- ■Project list & search
- ■Project profile + market data
- ■Market overview
- ■Dossier sections locked
- DAY
- 10,000 / day
- BURST
- 60 / min
- PAGE
- 100 rows
- ■Everything in Free
- ■Full source-cited dossiers (13 sections)
- ■Per-project source lists
- ■Mining radar: networks + launch calendar
- DAY
- 100,000 / day
- BURST
- 300 / min
- PAGE
- 500 rows
- ■Everything in Pro
- ■Bulk pages (500 rows)
- ■Internal commercial use
- ■Priority support
Monthly subscriptions through Stripe Checkout. Cancel or switch plans any time from your account; cancellation takes effect at the end of the paid period, after which the key continues on Free limits.
Need higher volume, redistribution rights or a data licence? data@cryptoia.ai
- Get a key (free, or subscribe above). Keys look like
cia_live_… - Send it in the
Authorization: Bearerheader. Query-string keys are not accepted. - Read
data;metacarries your tier, docs link and disclaimers.
curl -H "Authorization: Bearer $CRYPTOIA_KEY" \
"https://cryptoia.ai/api/v1/projects?limit=5"Base URL https://cryptoia.ai/api/v1 · JSON over HTTPS · CORS open for GET (never with cookies). Keep keys server-side; anyone with your key can spend your quota.
| METHOD | PATH | PLAN | DESCRIPTION |
|---|---|---|---|
| GET | /v1/status | NONE | Service status and plan limits. No key required. |
| GET | /v1/projects | FREE | Projects ordered by market cap. params: limit (≤ plan page size), offset, search, category |
| GET | /v1/projects/{slug} | FREE / PRO | Free: profile + market data, with locked section names. Pro/Desk: the full dossier exactly as shown on cryptoia.ai. |
| GET | /v1/projects/{slug}/sources | PRO | Every cited URL in the dossier, grouped by section. |
| GET | /v1/market | FREE | Top assets by market cap. params: limit (≤ 100) |
| GET | /v1/mining/networks | PRO | The Mining Nodes radar: tracked PoW/PoUW networks with status, algorithm, hardware and evidence fields. params: status (active | prelaunch | watch | archive), novel=true, seen_within_days, q |
| GET | /v1/mining/calendar | PRO | Dated mainnet, testnet and audit events from the launch radar. params: upcoming=true |
| GET | /v1/usage | FREE | Your plan, limits and remaining quota. |
{
"data": [ { "slug": "monero", "name": "Monero", "symbol": "XMR", "price_usd": "…", "market_cap": "…" } ],
"pagination": { "limit": 50, "offset": 0, "total": 426, "next": 50 },
"meta": { "tier": "pro", "docs": "https://cryptoia.ai/api", "disclaimer": "Analysis only, not financial advice…" }
}Dossier strings embed their citations as Source: https://… suffixes, exactly as the site renders source chips. A missing field means the evidence was not verified. It is not a zero. See the methodology.
Two windows apply per key: a per-minute burst limit and a daily quota that resets at 00:00 UTC. Every response reports them:
- X-RateLimit-Limit-Minute / X-RateLimit-Remaining-Minute
- X-RateLimit-Limit-Day / X-RateLimit-Remaining-Day
- X-CryptoIA-Tier · Retry-After (on 429)
Back off exponentially on 429 and 5xx. Mining feeds refresh about hourly and dossiers when evidence changes, so cache responses for at least 5 minutes.
| STATUS | ERROR | MEANING |
|---|---|---|
| 400 | invalid_slug / invalid_plan / invalid_email | Malformed input. |
| 401 | missing_api_key / invalid_api_key | No key sent, or the key is unknown or revoked. |
| 403 | upgrade_required | Your plan does not include this endpoint. |
| 404 | not_found | Unknown project or route. |
| 429 | rate_limited / daily_quota_exceeded | Slow down; see Retry-After. Daily quota resets 00:00 UTC. |
| 502 / 503 | feed_unavailable / auth_unavailable | Temporary upstream problem; retry with backoff. |
Errors are JSON: { "error": "code", "message": "…" }
- ■ Paid keys are shown once on the page you return to after checkout. We store only a hash.
- ■ Account: paste your key to see usage, rotate it (the old key stops working at once) or open the Stripe billing portal to change plan, update the card, download invoices or cancel.
- ■ Lost a key? Recover it by email: we send a single-use link to your account email that issues a new key and revokes the old one. Within 7 days of checkout you can also reissue from the welcome page in the same browser. Questions: support@cryptoia.ai.
- ■ Account endpoints (header auth):
GET /api/billing/me,POST /api/billing/rotate,POST /api/billing/portal. Recovery:POST /api/billing/recoverwith{"email"}.
- CryptoIA is analysis only. It is not financial, investment or legal advice, and it has no token. Third-party market data may be delayed or wrong.
- Attribute CryptoIA when you publish data from the API (for example “Source: CryptoIA”).
- Free and Pro are for your own apps and research. Bulk redistribution or resale of dossier content needs a Desk plan or a data licence.
- Don’t share keys or rotate them to evade limits. Abuse can lead to suspension. Plans renew monthly until cancelled, and fees already paid are not refundable except where the law requires.
- We may change endpoints with notice. Breaking changes ship under a new version path.