Arc data API
The Registrai Data API serves data on Arc, Circle's blockchain, as JSON: hourly stablecoin payments, paying wallets and volume for each app, the hourly Arc indices, the Arc ecosystem directory, verified builders and Arc chain figures. It does not serve raw blocks or transactions; read those from an Arc RPC.
Version 1. Public, read-only, no key. JSON over HTTPS with CORS for any origin.
Free to use under CC BY 4.0. Credit: "Registrai, builder.registrai.cc, CC BY 4.0". No warranty; not financial advice. See the Terms of use.
Is there an MCP server for Arc blockchain data?
Yes. Registrai runs a read-only MCP server for Arc blockchain data at https://builder.registrai.cc/api/mcp (Streamable HTTP, no sign-in or key), listed in the MCP registry as cc.registrai/arc-data. It serves the same data as the API: stablecoin payments per app, the Arc indices, the ecosystem directory and Arc chain figures.
arc_indices(Arc indices: latest): latest close of ABI, AII and AEIarc_index_history(Arc index: hourly history): hourly closes of one index, up to 31 daysarc_apps(Arc apps): every app with its last 24 h of stablecoin payments and volumearc_app(Arc app: detail): one app's last 24 h and last 7 daysarc_app_history(Arc app: hourly history): one app's hourly payments, paying wallets and USDarc_new_apps(Arc apps: newly seen): apps first seen after a given hourarc_verified(Arc builders: verified): projects with a valid builder proof on Arcarc_ecosystem(Arc ecosystem: directory): every project on Arc with category and statusarc_entity(Arc project: detail): one project's status, evidence, contracts and sourcesarc_numbers(Arc in numbers): USDC and stablecoin supply, TVL, estimated transactions and volumearc_apps_week(Arc apps, last 7 days): apps ranked by stablecoin payments received over 7 daysarc_apps_daily(Arc apps: daily USDC): USDC received per day by apps and projects since 2026-09-16arc_address_label(Arc address: label): who an address on Arc belongs to, with the label's source
Base URL
https://builder.registrai.cc/api/v1For tools and agents: OpenAPI 3.1 · llms.txt · MCP server (read-only, Streamable HTTP) at https://builder.registrai.cc/api/mcp · Apps on Arc
Endpoints
GET /indices
Parameters: none
Latest close, close 24 h earlier, base and member count of ABI, AII and AEI, plus the decay parameters.
curl -s 'https://builder.registrai.cc/api/v1/indices'GET /indices/{index}/hourly
Parameters: from, to (optional)
Hourly closes of one index, oldest first.
curl -s 'https://builder.registrai.cc/api/v1/indices/abi/hourly?from=2026-10-14T00:00:00Z&to=2026-10-14T23:00:00Z'GET /members
Parameters: index
Every scored member of an index now: points, share, verified, first hour and the last 24 h.
curl -s 'https://builder.registrai.cc/api/v1/members?index=aii'GET /members/{id}/hourly
Parameters: index, from, to (optional)
One member's hourly points and activity, oldest first.
curl -s 'https://builder.registrai.cc/api/v1/members/domain%3Aarchery.wtf/hourly?index=abi'GET /members/hourly
Parameters: index, and hour or from, to (optional; at most 168 h)
Every member's hourly rows for a range, ordered by hour, then id.
curl -s 'https://builder.registrai.cc/api/v1/members/hourly?index=aii&from=2026-10-14T00:00:00Z&to=2026-10-14T23:00:00Z'GET /members/new
Parameters: index, since
Members first seen after an hour.
curl -s 'https://builder.registrai.cc/api/v1/members/new?index=abi&since=2026-10-13T00:00:00Z'GET /verified
Parameters: none
Projects whose builder proof validates against the Arc mainnet builder registry.
curl -s 'https://builder.registrai.cc/api/v1/verified'GET /ecosystem
Parameters: category, status, q (optional)
Every project in the Arc ecosystem directory: category, status (live, deployed, announced), summary and page URL.
curl -s 'https://builder.registrai.cc/api/v1/ecosystem?category=dexs'GET /ecosystem/{slug}
Parameters: none
One project: summary, status with evidence, links, contracts on Arc, index ids and sources.
curl -s 'https://builder.registrai.cc/api/v1/ecosystem/aave'GET /ecosystem/corrections
Parameters: none
Every correction to the Arc ecosystem directory, newest first: date, project, field, what changed, source, and whether it came from the project or a reader.
curl -s 'https://builder.registrai.cc/api/v1/ecosystem/corrections'GET /arc
Parameters: none
Arc in numbers now: USDC and EURC supply, all stablecoins and TVL (DefiLlama), estimated 24 h stablecoin volume, apps and projects, index closes, timeline. Each figure with its source and date.
curl -s 'https://builder.registrai.cc/api/v1/arc'GET /arc/daily
Parameters: days (optional, 1-365, default 30)
Daily snapshots of Arc in numbers, newest first (one per UTC day, after the 00:00 close).
curl -s 'https://builder.registrai.cc/api/v1/arc/daily?days=7'GET /arc/apps-week
Parameters: none
Apps on Arc over the last 7 days (168 closed hours of the Arc Ecosystem Index): stablecoin payments received in USD, payments, new paying wallets and the hour each app was first seen in the index, ranked by USD.
curl -s 'https://builder.registrai.cc/api/v1/arc/apps-week'GET /arc/apps-daily
Parameters: app (optional: index app id or entity:<slug>), from, to (YYYY-MM-DD; up to 31 days for one app, 7 for all)
USDC received per UTC day by Arc apps and directory projects since mainnet's first day (2026-09-16), counted from every USDC transfer into their contracts before any index rule: USD, transfers and distinct payers per app and day. Longer windows: paid.
curl -s 'https://builder.registrai.cc/api/v1/arc/apps-daily?app=integration:uniswap'GET /arc/labels
Parameters: none
Every labelled address on Arc from the repository (directory contracts, stablecoins, Registrai's chain scan) with the project, role and source, the counts per origin, and the URL of the Arc indices' full contract map.
curl -s 'https://builder.registrai.cc/api/v1/arc/labels'GET /arc/labels/{address}
Parameters: none
Who one address on Arc belongs to: project or app, role, where the label comes from and its source; 404 when it has no label.
curl -s 'https://builder.registrai.cc/api/v1/arc/labels/0x3600000000000000000000000000000000000000'from, to, since are ISO hour closes such as 2026-10-14T19:00:00Z, URL-encoded; from and to are inclusive. Member ids are the index source, URL-encoded in paths (domain%3Aarchery.wtf).
Fields
points: The member's points stock at the hour's close: the index's value after decay and rise limits.points_earned: Raw points the member's payments earned within that hour, before rise limits.payments, wallets, new_payers, usdc: That hour's activity: counted payments, paying wallets, first-time payers and stablecoin volume in USD.hour_close, hour: The hour's close time in ISO UTC, and the same as unix seconds / 3600.data_until: The last closed hour served. It only moves forward.
Precision and timestamps
History
- Index closes from 2 Oct 2026, 00:00 UTC (base 1,000).
- Member rows from 10 Oct 2026, 23:00 UTC, the oldest archived hour.
Limits
- 100 requests per 10 seconds per IP; above that, requests are refused with 429 for 10 seconds.
- At most 744 hours per history request, 168 on
/members/hourly. - Responses are cached for 60 s (5 min on
/verified). SendIf-None-Matchwith the lastETagto get a 304.
Errors
Errors are JSON: { "error": "…" }.
400: A parameter is missing or invalid; the error says which. A from after the last closed hour returns 200 with no rows.404: Unknown endpoint, or a member id this index has never had.405: Only GET is supported.429: Too many requests from your IP; retry after the retry-after header.503: Data is not available right now; retry later. A response is never partial.
Paid extras
Not switched on yet: until then the paid paths answer 503 and nothing is charged. Once on, paid extras are sold per request through x402 on Arc mainnet. A request without payment answers 402 with two options: Circle Gateway Nanopayments (batched, gasless; the lower price) or a standard EIP-3009 USDC authorization (any x402 wallet). The response is built first and charged only if it can be delivered. The free tier above is unchanged.
| Path | Returns | Circle | Standard | MCP tool |
|---|---|---|---|---|
/paid/indices/{index}/hourly | Hourly closes of one Arc index for any window. Parameters: from, to (any window). | $0.002 | $0.01 | arc_index_history_deep |
/paid/members/{id}/hourly | One app's hourly points and activity for any window. Parameters: index, from, to (any window). | $0.002 | $0.01 | arc_app_history_deep |
/paid/members/day | Every member's hourly rows and the closes of ABI, AII and AEI for one UTC day. Parameters: date (YYYY-MM-DD). | $0.03 | $0.05 | arc_members_day |
/paid/events | Watch-feed events: deploys, upgrades, control changes, pauses and large outflows on Arc. Parameters: since_block, until_block, since_ts, kind, project, contract, labelled, min_balance, min_project_usdc_24h, limit. | $0.002 | $0.01 | arc_events |
/paid/contract/{address} | Facts for one contract: label with its source, deployment (deployer, tx), live USDC balance and recent watch-feed events. Parameters: none. | $0.005 | $0.01 | arc_contract |
/paid/apps-daily | Daily USDC received per app on Arc for any window since mainnet's first day (2026-09-16). Parameters: app, from, to (any window since 2026-09-16). | $0.002 | $0.01 | arc_apps_daily_deep |
/paid/projects/{source}/scope | Every contract attributed to one project: its directory contracts, the contracts the Arc indices count for it and the contracts its deployers created. Parameters: limit, offset. | $0.01 | $0.02 | arc_project_scope |
How to pay
Versioning
Every response carries "version": 1. Fields are only added within v1. A breaking change ships as /api/v2, with v1 kept for at least 90 days and dated below.
Changelog
- 2026-10-14: v1 released: indices, members, member history, verified projects.
- 2026-10-20: Arc ecosystem directory: /ecosystem and /ecosystem/{slug}.
- 2026-10-20: Arc in numbers: /arc and /arc/daily.
- 2026-10-21: Directory corrections log: /ecosystem/corrections.
- 2026-10-22: Arc apps over 7 days: /arc/apps-week.
- 2026-11-08: Arc address labels: /arc/labels and /arc/labels/{address}.
- 2026-11-08: Daily USDC per app since mainnet's first day: /arc/apps-daily (paid: any window).