Getting Started

Quickstart

Read your first block from Arc Mainnet in under a minute, then query the same data with SQL.

1. Get an API key

Keys are free while ChainForge is in beta. Every request is authenticated with a bearer token.

bash

curl https://api.chainforge.cn/v1/arc/blocks/latest \
  -H "Authorization: Bearer $CHAINFORGE_KEY"

2. Read the response

Responses are canonical: field names match the dataset schema exactly, so a block from the API and a row in arc.blocks are the same shape.

json

{
  "block_number": 2918331,
  "block_hash": "0x7f3a…c21e",
  "timestamp": "2026-09-15T08:41:02Z",
  "gas_used": 14820331,
  "transaction_count": 67
}

3. Query with SQL

sql

SELECT toStartOfHour(timestamp) AS hour,
       count() AS blocks,
       sum(transaction_count) AS txns
FROM arc.blocks
WHERE timestamp > now() - INTERVAL 1 DAY
GROUP BY hour ORDER BY hour;

BuildingThe SQL console is not yet public. Queries above run against the same ClickHouse tables the API reads.