Registraibuilders

Data API

Version 1. Public, read-only, no key. JSON over HTTPS with CORS for any origin.

Free to use under CC BY 4.0 with the attribution "Data: Registrai". No warranty; not financial advice. See the Terms of use.

Base URL

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

For tools and agents: OpenAPI 3.1 · llms.txt · MCP server (read-only, Streamable HTTP) at https://builder.registrai.cc/api/mcp · Stablecoin 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'

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

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.