Arc 메인넷 API

체인 상수, 노드 능력, 그리고 정확히 어떤 블록이 인덱싱되어 있는지. 이 한 번의 호출이면 이 페이지의 나머지를 믿음으로 받아들일 필요가 없습니다.

curl -s -H 'User-Agent: my-app/1.0' https://api-testnet.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-testnet.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-testnet.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

이 명령은 끝나지 않습니다. 아래는 실제 연결에서 3 초 간격으로 연달아 온 두 이벤트입니다.

curl -N -H 'User-Agent: my-app/1.0' https://api-testnet.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}