{"openapi":"3.1.0","info":{"title":"Registrai Data API","version":"1","description":"Hourly Arc index and per-app stablecoin data. Public, read-only, no key. Rate limit: 100 requests per 10 s per IP. Attribution \"Data: Registrai\".","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://builder.registrai.cc/api/v1"}],"externalDocs":{"url":"https://builder.registrai.cc/data-api/"},"paths":{"/indices":{"get":{"operationId":"getIndices","summary":"Latest close of ABI, AII and AEI, with parameters","parameters":[],"responses":{"200":{"description":"Latest close of ABI, AII and AEI, with parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Indices"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/indices/{index}/hourly":{"get":{"operationId":"getIndexHourly","summary":"Hourly closes of one index","parameters":[{"name":"index","in":"path","required":true,"schema":{"type":"string","enum":["abi","aii","aei"]}},{"name":"from","in":"query","required":false,"description":"First hour close (inclusive), an ISO hour like 2026-10-14T19:00:00Z.","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}},{"name":"to","in":"query","required":false,"description":"Last hour close (inclusive).","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}}],"responses":{"200":{"description":"Hourly closes of one index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexHourly"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/members":{"get":{"operationId":"listMembers","summary":"Every scored member of an index now","parameters":[{"name":"index","in":"query","required":true,"schema":{"type":"string","enum":["abi","aii","aei"]}}],"responses":{"200":{"description":"Every scored member of an index now","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Members"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/members/{id}/hourly":{"get":{"operationId":"getMemberHourly","summary":"One member's hourly points and activity","parameters":[{"name":"id","in":"path","required":true,"description":"Member id (index source), URL-encoded, e.g. domain%3Aarchery.wtf","schema":{"type":"string"}},{"name":"index","in":"query","required":true,"schema":{"type":"string","enum":["abi","aii","aei"]}},{"name":"from","in":"query","required":false,"description":"First hour close (inclusive), an ISO hour like 2026-10-14T19:00:00Z.","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}},{"name":"to","in":"query","required":false,"description":"Last hour close (inclusive).","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}}],"responses":{"200":{"description":"One member's hourly points and activity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberHourly"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/members/hourly":{"get":{"operationId":"listMembersHourly","summary":"Every member's hourly rows for one hour or a range (at most 168 h)","parameters":[{"name":"index","in":"query","required":true,"schema":{"type":"string","enum":["abi","aii","aei"]}},{"name":"hour","in":"query","required":false,"description":"One hour close; not with from/to.","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}},{"name":"from","in":"query","required":false,"description":"First hour close (inclusive), an ISO hour like 2026-10-14T19:00:00Z.","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}},{"name":"to","in":"query","required":false,"description":"Last hour close (inclusive).","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}}],"responses":{"200":{"description":"Every member's hourly rows for one hour or a range (at most 168 h)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembersHourly"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/members/new":{"get":{"operationId":"listNewMembers","summary":"Members first seen after an hour","parameters":[{"name":"index","in":"query","required":true,"schema":{"type":"string","enum":["abi","aii","aei"]}},{"name":"since","in":"query","required":true,"description":"Hour close; members first seen after it.","schema":{"type":"string","format":"date-time","example":"2026-10-14T19:00:00Z"}}],"responses":{"200":{"description":"Members first seen after an hour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembersNew"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/paid/indices/{index}/hourly":{"get":{"operationId":"paid_deep_index_history","summary":"Hourly closes of one Arc index for any window. Paid via x402: $0.002 (Circle Gateway) or $0.01 (standard EIP-3009).","parameters":[{"name":"index","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Hourly closes of one Arc index for any window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexHourly"}}}},"400":{"$ref":"#/components/responses/Error"},"402":{"description":"Payment required: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header). Retry with PAYMENT-SIGNATURE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/paid/members/{id}/hourly":{"get":{"operationId":"paid_deep_member_history","summary":"One app's hourly points and activity for any window. Paid via x402: $0.002 (Circle Gateway) or $0.01 (standard EIP-3009).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"One app's hourly points and activity for any window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberHourly"}}}},"400":{"$ref":"#/components/responses/Error"},"402":{"description":"Payment required: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header). Retry with PAYMENT-SIGNATURE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/paid/members/day":{"get":{"operationId":"paid_members_day","summary":"Every member's hourly rows and the closes of ABI, AII and AEI for one UTC day. Paid via x402: $0.03 (Circle Gateway) or $0.05 (standard EIP-3009).","parameters":[],"responses":{"200":{"description":"Every member's hourly rows and the closes of ABI, AII and AEI for one UTC day.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Error"},"402":{"description":"Payment required: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header). Retry with PAYMENT-SIGNATURE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/paid/events":{"get":{"operationId":"paid_events","summary":"Watch-feed events: deploys, upgrades, control changes, pauses and large outflows on Arc. Paid via x402: $0.002 (Circle Gateway) or $0.01 (standard EIP-3009).","parameters":[],"responses":{"200":{"description":"Watch-feed events: deploys, upgrades, control changes, pauses and large outflows on Arc.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Error"},"402":{"description":"Payment required: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header). Retry with PAYMENT-SIGNATURE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/paid/contract/{address}":{"get":{"operationId":"paid_contract","summary":"Facts for one contract: label, project, recent events and USDC balance. Paid via x402: $0.005 (Circle Gateway) or $0.01 (standard EIP-3009).","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Facts for one contract: label, project, recent events and USDC balance.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Error"},"402":{"description":"Payment required: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header). Retry with PAYMENT-SIGNATURE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/paid/projects/{source}/scope":{"get":{"operationId":"paid_project_scope","summary":"Every contract attributed to one project. Paid via x402: $0.01 (Circle Gateway) or $0.02 (standard EIP-3009).","parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Every contract attributed to one project.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Error"},"402":{"description":"Payment required: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header). Retry with PAYMENT-SIGNATURE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/verified":{"get":{"operationId":"listVerified","summary":"Projects whose builder proof validates against the Arc mainnet registry","parameters":[],"responses":{"200":{"description":"Projects whose builder proof validates against the Arc mainnet registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Verified"}}}},"304":{"description":"Not modified (If-None-Match)"},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"405":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}}},"components":{"schemas":{"Indices":{"type":"object","properties":{"version":{"type":"number"},"data_until":{"type":"string"},"indices":{"type":"object","properties":{"abi":{"type":"object","properties":{"name":{"type":"string"},"close":{"type":"number"},"close_24h_ago":{"type":["number","null"]},"base":{"type":"number"},"base_date":{"type":"string"},"members":{"type":"number"}},"required":["name","close","close_24h_ago","base","base_date","members"]},"aii":{"type":"object","properties":{"name":{"type":"string"},"close":{"type":"number"},"close_24h_ago":{"type":["number","null"]},"base":{"type":"number"},"base_date":{"type":"string"},"members":{"type":"number"}},"required":["name","close","close_24h_ago","base","base_date","members"]},"aei":{"type":"object","properties":{"name":{"type":"string"},"close":{"type":"number"},"close_24h_ago":{"type":["number","null"]},"base":{"type":"number"},"base_date":{"type":"string"},"members":{"type":"number"}},"required":["name","close","close_24h_ago","base","base_date","members"]}},"required":["abi","aii","aei"]},"params":{"type":"object","properties":{"half_life_days":{"type":"number"},"decay_per_hour_pct":{"type":"number"}},"required":["half_life_days","decay_per_hour_pct"]}},"required":["version","data_until","indices","params"]},"IndexHourly":{"type":"object","properties":{"version":{"type":"number"},"index":{"type":"string"},"data_until":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"hour_close":{"type":"string"},"hour":{"type":"number"},"close":{"type":"number"}},"required":["hour_close","hour","close"]}}},"required":["version","index","data_until","rows"]},"Members":{"type":"object","properties":{"version":{"type":"number"},"index":{"type":"string"},"data_until":{"type":"string"},"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"verified":{"type":"boolean"},"points":{"type":"number"},"share":{"type":"number"},"first_hour":{"type":"string"},"last_24h":{"type":"object","properties":{"points_earned":{"type":"number"},"payments":{"type":"number"},"usdc":{"type":"number"}},"required":["points_earned","payments","usdc"]}},"required":["id","name","kind","verified","points","share","first_hour","last_24h"]}}},"required":["version","index","data_until","members"]},"MemberHourly":{"type":"object","properties":{"version":{"type":"number"},"index":{"type":"string"},"id":{"type":"string"},"data_until":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"hour_close":{"type":"string"},"hour":{"type":"number"},"points":{"type":"number"},"points_earned":{"type":"number"},"payments":{"type":"number"},"wallets":{"type":"number"},"new_payers":{"type":"number"},"usdc":{"type":"number"}},"required":["hour_close","hour","points","points_earned","payments","wallets","new_payers","usdc"]}}},"required":["version","index","id","data_until","rows"]},"MembersHourly":{"type":"object","properties":{"version":{"type":"number"},"index":{"type":"string"},"data_until":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hour_close":{"type":"string"},"hour":{"type":"number"},"points":{"type":"number"},"points_earned":{"type":"number"},"payments":{"type":"number"},"wallets":{"type":"number"},"new_payers":{"type":"number"},"usdc":{"type":"number"}},"required":["id","hour_close","hour","points","points_earned","payments","wallets","new_payers","usdc"]}}},"required":["version","index","data_until","rows"]},"MembersNew":{"type":"object","properties":{"version":{"type":"number"},"index":{"type":"string"},"since":{"type":"string"},"data_until":{"type":"string"},"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"verified":{"type":"boolean"},"points":{"type":"number"},"share":{"type":"number"},"first_hour":{"type":"string"},"last_24h":{"type":"object","properties":{"points_earned":{"type":"number"},"payments":{"type":"number"},"usdc":{"type":"number"}},"required":["points_earned","payments","usdc"]}},"required":["id","name","kind","verified","points","share","first_hour","last_24h"]}}},"required":["version","index","since","data_until","members"]},"Verified":{"type":"object","properties":{"version":{"type":"number"},"updated":{"type":"string"},"verified":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"method":{"type":"string"},"since":{"type":"string"}},"required":["id","method","since"]}}},"required":["version","updated","verified"]},"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"PaymentRequired":{"type":"object","description":"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.","properties":{"x402Version":{"type":"number"},"error":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}}},"required":["x402Version","accepts"]}},"responses":{"Error":{"description":"Error with a plain sentence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}