API Arc mainnet

Больше ничего не нужно — ни ключа, ни заголовков, кроме типа содержимого.

curl -s -X POST https://rpc.arc-scan.io -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber"}'

Вернулось

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xe0d313"
}

Отклонённый метод получает −32601 — код, который любая клиентская библиотека уже понимает как «здесь не поддерживается», поэтому определение возможностей деградирует, а не падает с исключением.

curl -s -X POST https://rpc.arc-scan.io -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"trace_block","params":["0x1"]}'

Вернулось

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "arc-scan.io does not serve trace_block on this endpoint. This is our own policy decision, not a limitation of the Arc network. Trace responses are very large - one measured block returned 28,530 bytes - and this endpoint is metered.",
    "data": {
      "reason": "refused_by_policy",
      "method": "trace_block",
      "policy": "cost",
      "documentation": "https://arc-scan.io/developers"
    }
  }
}

Константы сети, возможности узла и точный диапазон проиндексированных блоков. Один вызов — и всё остальное на этой странице не приходится принимать на веру.

curl -s -H 'User-Agent: my-app/1.0' https://api.arc-scan.io/v1/chain

Вернулось

{
  "chain_id": 5042,
  "name": "Arc",
  "is_testnet": false,
  "mainnet_soon": false,
  "native": {
    "symbol": "USDC",
    "decimals": 18
  },
  "erc20_native": {
    "address": "0x3600000000000000000000000000000000000000",
    "decimals": 6
  },
  "block_time_ms": 506,
  "finality": "instant",
  "capabilities": {
    "ots": false,
    "ots_search": false,
    "trace": true,
    "debug": false,
    "archive": true,
    "tx_index": true,
    "holder_index": true,
    "verified_source": false,
    "verified_source_note": "<-- elided -->",
    "internal_transactions": true
  },
  "index": {
    "available": true,
    "streams": [
      {
        "stream": "balances",
        "genesis_block": 0,
        "last_contiguous_block": 13849844,
        "from_block": 0,
        "to_block": 13849844,
        "ranges": 1,
        "blocks_indexed": 13849845,
        "contiguous_from_genesis": true
      },
      {
        "stream": "chain",
        "genesis_block": 0,
        "last_contiguous_block": 13849856,
        "from_block": 0,
        "to_block": 13849856,
        "ranges": 1,
        "blocks_indexed": 13849857,
        "contiguous_from_genesis": true
      },
      {
        "stream": "traces",
        "genesis_block": 0,
        "last_contiguous_block": -1,
        "from_block": null,
        "to_block": null,
        "ranges": 0,
        "blocks_indexed": 0,
        "contiguous_from_genesis": false
      }
    ],
    "head_block": 13849856,
    "chain_blocks_indexed": 13849857,
    "chain_genesis_block": 0,
    "chain_first_indexed_block": 0,
    "covers_chain_from_block": 0,
    "complete_above_start_block": true,
    "unindexed_blocks_below_start": 0,
    "complete": true,
    "message": null
  },
  "capabilities_note": null,
  "capabilities_note_phrases": []
}

Ключ передаётся в строке запроса как <mono>apikey</mono> — именно туда его уже кладут клиенты Etherscan.

curl -s -H 'User-Agent: my-app/1.0' "https://api.arc-scan.io/api?module=account\
&action=txlist&address=0x03a13352ef67977d1601ec1276e9bc27c0ee7b75\
&startblock=13800000&endblock=13830000&page=1&offset=1&sort=desc\
&apikey=YourApiKeyToken"

Вернулось

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "13830000",
      "timeStamp": "1785842041",
      "hash": "0x3ae69af3843877c10d1aedde0fb299f0de358a76c4b704f338fc738b5d952ef5",
      "nonce": "88966",
      "blockHash": "",
      "transactionIndex": "0",
      "from": "0x92Df01DB3C69a49f4c4E694849E44C75D62B6752",
      "to": "0x03a13352eF67977d1601ec1276e9BC27C0Ee7b75",
      "value": "0",
      "gas": "598264",
      "gasPrice": "40000000000",
      "isError": "0",
      "txreceipt_status": "1",
      "input": "",
      "contractAddress": "",
      "cumulativeGasUsed": "348673",
      "gasUsed": "348673",
      "confirmations": "2933",
      "methodId": "0x38aaba3d",
      "functionName": "open"
    }
  ]
}

Любая выгрузка — про один адрес, поэтому <mono>address</mono> обязателен, а диапазон блоков или дат её сужает. Четыре набора данных — <mono>transactions</mono>, <mono>internal</mono>, <mono>logs</mono>, <mono>token-transfers</mono>, — а <mono>/v1/export/limits</mono> называет ограничения до того, как вы в них упрётесь.

curl -s -H 'User-Agent: my-app/1.0' "https://api.arc-scan.io/v1/export/transactions/csv\
?address=0x03a13352ef67977d1601ec1276e9bc27c0ee7b75\
&from_block=13800000&to_block=13800010"

Вернулось

block_number,block_time_utc,block_timestamp,tx_hash,tx_index,from,to,created_contract,direction,value_raw,value_18dec,fee_raw,fee_18dec,gas_limit,gas_used,effective_gas_price_raw,nonce,tx_type,method_id,input_size,status
13800001,2026-08-04T07:00:48Z,1785826848,0xb244d2791aa392fcc49e2c6bca9df0b6c402da2c1cd322f6356724fb77cc3131,0,0x8031885f93e31676132128557e987a011ff99d27,0x03a13352ef67977d1601ec1276e9bc27c0ee7b75,,in,0,0,13951720000000000,0.01395172,570664,348793,40000000000,141603,2,0x38aaba3d,516,success

Эта команда не завершается. Ниже — два подряд идущих события из живого соединения, с разницей в три секунды.

curl -N -H 'User-Agent: my-app/1.0' https://api.arc-scan.io/v1/stream/head

Вернулось

event: head
data: {"height": 13830746, "hash": "0xc580470583007f827ebfb3098b66d0682528c4ebaca4eb1213ab992c5952e65e", "timestamp": 1785842418, "tx_count": 1, "server_now": 1785842422, "available": true}

event: head
data: {"height": 13830751, "hash": "0x63d064be03dc0f5d530e10350b8dddd3de2cc8e6dbbffbe59306bb9fdc96c162", "timestamp": 1785842421, "tx_count": 1, "server_now": 1785842422, "available": true}