# 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](https://builder.registrai.cc/terms/).

## 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 AEI
- `arc_index_history` (Arc index: hourly history): hourly closes of one index, up to 31 days
- `arc_apps` (Arc apps): every app with its last 24 h of stablecoin payments and volume
- `arc_app` (Arc app: detail): one app's last 24 h and last 7 days
- `arc_app_history` (Arc app: hourly history): one app's hourly payments, paying wallets and USD
- `arc_new_apps` (Arc apps: newly seen): apps first seen after a given hour
- `arc_verified` (Arc builders: verified): projects with a valid builder proof on Arc
- `arc_ecosystem` (Arc ecosystem: directory): every project on Arc with category and status
- `arc_entity` (Arc project: detail): one project's status, evidence, contracts and sources
- `arc_numbers` (Arc in numbers): USDC and stablecoin supply, TVL, estimated transactions and volume
- `arc_apps_week` (Arc apps, last 7 days): apps ranked by stablecoin payments received over 7 days
- `arc_apps_daily` (Arc apps: daily USDC): USDC received per day by apps and projects since 2026-09-16
- `arc_address_label` (Arc address: label): who an address on Arc belongs to, with the label's source

## Base URL

`https://builder.registrai.cc/api/v1`

For tools and agents: [OpenAPI 3.1](https://builder.registrai.cc/api/v1/openapi.json) · [llms.txt](https://builder.registrai.cc/llms.txt) · MCP server (read-only, Streamable HTTP) at `https://builder.registrai.cc/api/mcp` · [Apps on Arc](https://builder.registrai.cc/apps/)

## 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 i

## 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`). Send `If-None-Match` with the last `ETag` to 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 i

## 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).

## Use this data

1. Arc in numbers: `GET https://builder.registrai.cc/api/v1/arc?ref=md-docs`. Every project in the directory: `GET https://builder.registrai.cc/api/v1/ecosystem?ref=md-docs`.
2. MCP server (Streamable HTTP, no key, read-only): `https://builder.registrai.cc/api/mcp?ref=md-docs`. Claude Code: `claude mcp add --transport http registrai https://builder.registrai.cc/api/mcp?ref=md-docs`.
3. Full API reference: https://builder.registrai.cc/data-api/?ref=md-docs (OpenAPI: https://builder.registrai.cc/api/v1/openapi.json). Free under CC BY 4.0, credit below.

Source: https://builder.registrai.cc/data-api/ · Registrai, builder.registrai.cc, CC BY 4.0
