API 文档

类型化 API 位于 /v1。本站自身就是从这套接口渲染的，因此页面上看得到的任何内容，都能以相同结构读成 JSON。

兼容 API 位于 /api?module=…&action=…。它复刻了钱包、索引器、部署脚本和机器人早已通用的事实标准浏览器 REST 约定，因此现有工具只需换一个 base URL 就能指向 Arc。result 中的每个标量都是字符串，完全符合该约定的要求。

GET /v1/blocks/latest
GET /api?module=proxy&action=eth_blockNumber
GET /api?module=account&action=balance&address=0x…

上面的示例是方法与路径，前面没有主机名。目前还没有已公布的 API 基础 URL 可写 — 参见本页顶部的提示。

大小写:

JSON 键为 snake_case。传输中的地址与哈希均为小写；checksum 字段携带显示形式。输入端接受任意大小写。

大整数:

任何可能超过 2⁵³ 的值——金额、gas、供应量——都是十进制字符串。区块高度是 JSON 数字。把金额当作 JavaScript number 解析会静默损坏它。

金额:

金额以 Money 对象传输：raw（整数字符串）、decimals、formatted（精确、全精度）、usd 和 symbol。小数位始终从合约读取；绝不要根据符号推断精度。

时间:

Unix 秒，绝不预先格式化。区块时间戳的分辨率为一秒，而区块大约每秒到达两个，因此时间戳不构成全序——不要按它排序或分页。

分页:

不透明游标，而非页码。由于 Arc 没有重组，游标永远有效。带窗口的端点还会返回实际扫描过的区块范围。

错误:

{"error":{"code":"NOT_FOUND","message":"…","detail":null}}

错误码：INVALID_INPUT（400）、NOT_FOUND（404）、RATE_LIMITED（429）、CAPABILITY_UNAVAILABLE（501）、UPSTREAM_ERROR（502）、UPSTREAM_TIMEOUT（504）。

缓存:

任何以已提交区块高度或已上链交易哈希为键的内容都是不可变的，并以 Cache-Control: public, max-age=31536000, immutable 提供。这是概率性链无法给出的更强保证，值得据此构建。

/v1/stream/head 是一个 server-sent event 流，每提交一个区块就发出一个 head 事件。负载中带有 server_now，客户端可据此校正时钟偏差，而不必相信浏览器时钟。

event: head
data: {"height":54190133,"hash":"0x…","timestamp":1785345456,"tx_count":11,"server_now":1785345456}

没有待处理交易流。本链禁用了 mempool 命名空间，而在半秒出块的情况下，待处理视图显示一笔交易的时间，比读完它所需的时间还短。

gas 以美元支付:

gas 代币是 USDC。手续费、余额和交易金额都以美元计价，Arcscan 给出的是精确的美元数字，不涉及任何预言机。

兼容 API 中的数值保持 18 位小数:

value、gasPrice、gasUsed 与 cumulativeGasUsed 仍是 18 位小数的整数字符串。除以 10¹⁸ 即得正确的美元数字。我们绝不「贴心地」为你换算——那会让每一个接入的机器人相差一万亿倍。

同一美元，两种表示:

原生余额带 18 位小数；同一资产的 ERC-20 接口带 6 位。一个预编译合约让二者保持等值，因此 erc20 = native / 10^12 精确成立。account.balance 返回原生数字，account.tokenbalance 返回 ERC-20 数字。二者都正确。把它们相加就是把同一笔美元算了两次。

代币小数位从不假定:

tokenDecimal 始终从合约读取。本链上两个合约可以共用一个符号却使用不同精度，所以「符号到小数位」的映射表在这里从构造上就是错的。

最终性是确定的:

confirmations 是为兼容而输出的，旁边还会额外输出 isFinalized。这里没有概率性的安全窗口：已提交的区块即为最终。Arcscan 在自己的界面中从不显示确认数。

字段名保持原拼写:

兼容接口中的方法名与字段名是协议标识符，原样复刻，以便现有客户端继续可用。属于 Arc 的只有取值。

它们会以 HTTP 200 返回标准错误信封——绝不返回 404，以免客户端库直接崩溃。每一个都带着自己的原因，而不是同一句套话：我们没有构建的索引、Arc 本身的结构性特征，或者换了个名字的可用端点。

• account.getminedblocks
• account.tokennfttx
• account.token1155tx
• account.addresstokennftbalance
• token.tokeninfo
• contract.verifysourcecode

两个 NFT 历史操作是最常被调用的，但都无法按地址作答。ERC-20 对应的 account.tokentx 可以作答，但需要显式给出 startblock 和 endblock。

速率限制:

按 IP 的令牌桶，在边缘而非应用内执行。对外部调用方将采用的额度尚未确定，因此这里不印任何数字；API 开放时本页会写明。

日志范围:

日志查询被限制在最大区块跨度内。超范围的请求会被拒绝，并在消息中指明最大值，而不是静默截断。

重型端点:

trace 与 state-diff 端点运行在一个小型专用池上，带有墙钟时间预算和响应大小上限，并会报告 truncated: true，而不是一直挂起。