如何用 Data API 查询 Robinhood Chain 上股票代币的转账、持有者与余额

查询 Robinhood Chain（链 ID 4663）上股票代币的转账、持有者与余额，一个 API key 即可。

GET /v1/data/robinhood_mainnet/tokens/{token}/transfers?standard=erc20 — 列出某代币的转账
/tokens/{token}/holders — 列出持有者
/addresses/{address}/balances — 列出某钱包的余额

/stocks 按每日转账笔数排行并给出 holder_count。链名与链 ID 来自 GET /v1/chains。核对于 2026-11-12

export BLOCKVECTRA_API_KEY='replace-with-your-key'

curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?limit=5" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

股票代币是 ERC-20 合约，所以使用 standard=erc20。数量是代币原始数量的十进制字符串；换算成股数见乘数指南。

Robinhood Chain 上的合约部署与事件监听见 RPC 与 WebSocket 接入指南。

• 第一步：免 key 读最新区块，运行下方的 curl 命令。
• 完成标准：带 key 的股票查询返回 data 与 meta；可用记录包含 day、token、transfers 与 holder_count，data: [] 则表示没有可用的活动记录。

主网参数与数据集。

三步任务：查询 Robinhood Chain 上的股票活动

找出最新有记录的 UTC 日期内最活跃的代币化股票，再查看它们的转账笔数与持币地址数。

用一个 API key 查询主网股票代币活动与持币地址数据，构建活动看板。这些是链上活动指标，不是股票报价。

1. 免 key 读最新区块

curl -sS "https://api.blockvectra.com/v1/robinhood_mainnet/public" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

JSON-RPC 返回的 result 是十六进制最新区块号。这个公开 RPC 请求无需 key；第 3 步的 Data API 查询需要 key。

2. 为同一条链创建 key

登录控制台并打开 API Key 页面，创建 key 并保存弹层中显示的 secret。同一把 key 可用于 robinhood_mainnet 的 JSON-RPC 与 Data API。

AI Agent 若要通过 HTTP 免浏览器操作，可按程序化开户指南用以太坊钱包签名开户并创建 key；不要让用户把 key 贴进对话。

3. 用 key 查询股票活动

将下面的 replace-with-your-key 换成已保存的 key，在服务端或本地终端运行。省略 day 时查询最新有记录的日期；limit=5 返回最多五个股票代币，按转账活跃度降序排列。

export BLOCKVECTRA_API_KEY='replace-with-your-key'

curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?limit=5" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

可从返回结果读取这些字段：

data 数组为空表示没有可用的活动记录。若要查看结果中的某个股票代币，用它的 token 值调用下文介绍的 GET /robinhood_mainnet/stocks/{token}。

按代币与钱包查转账、持有者和余额

把 TOKEN 设为 /stocks 返回的某个 token 值，WALLET 设为你要跟踪的地址，然后运行：

TOKEN='0x1111111111111111111111111111111111111111'
WALLET='0x2222222222222222222222222222222222222222'

# 某代币的转账，最新在前
curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/tokens/$TOKEN/transfers?standard=erc20&limit=20" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

# 某代币的持有者，余额从大到小
curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/tokens/$TOKEN/holders?limit=20" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

# 某钱包非零的 ERC-20 余额
curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/addresses/$WALLET/balances" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

• limit 默认 50，超过 500 按 500 处理；把 next_cursor 原样作为 cursor 传回即可读下一页。
• 代币转账可选 from_block 与 to_block；钱包转账两者都必填，窗口超过 100,000 个区块会返回 409 window_too_large，加 clamp=true 则截断。
• 持有者与余额来自每 6 小时刷新一次的快照，行数据最多约滞后 6.5 小时。快照时间看 meta.refreshed_at，为 null 时按过期处理。
• 没有余额的地址返回 200 与 data: []。

什么是代币化股票数据集

BlockVectra Data API 提供代币化股票（Tokenized Stocks）每日链上指标与元数据查询。该数据集汇总每日转账、铸造、销毁、净供应量变化、持币分布以及去中心化交易所（DEX）交易等指标，帮助开发者跟踪代币化股票在链上的公开动态。

提供该数据集的链以支持的链页面为准。

• 基础 URL：https://api.blockvectra.com/v1/data——除 GET /chains 外，所有 Data API 路由均以链标识为前缀（如 https://api.blockvectra.com/v1/data/{chain}/…）
• 链标识示例：robinhood_mainnet（本文仅以此作为路径参数示例；提供该数据集的具体链请参阅支持的链页面）
• 身份验证：在 HTTP 请求头中传入 x-api-key: $BLOCKVECTRA_API_KEY
• 计费与数据覆盖：按 CU（计算单元）计量，仅对 2xx 成功响应计费。若请求的链不支持股票数据集，接口返回 HTTP 422 no_coverage（不计费）

查每日榜单（GET /{chain}/stocks）

GET /{chain}/stocks 端点提供指定 UTC 日期的代币化股票每日活跃榜单，包含展示元数据（代号、名称等），按链上转账活跃度降序（最活跃的代币排在最前）。

请求参数

• {chain}（路径参数，必填）：目标链的标识（例如 robinhood_mainnet）。
• day（查询参数，可选）：UTC 日期，格式为 YYYY-MM-DD。若省略，默认返回最新有记录的日期（若该日无活动记录，返回 200 且 data: []）。若传入但不是合法的 YYYY-MM-DD 日历日期，返回 HTTP 400（error.code = "bad_request"）。
• limit（查询参数，可选）：当前响应最多返回条数。默认值为 50；超过 500 的值会被截断为 500；传入 0 或非整数会返回 HTTP 400（error.code = "bad_request"）。

分页特性

该端点不支持分页。limit 参数用于限制当前响应返回的最大条数。响应外层的 StockDailyListEnvelope 包含 data 与 meta，其中股票端点不返回 next_cursor（该键在响应中完全不出现，而非 null）。

代码示例

Robinhood Chain 上的完整模板仓库：blockvectra/robinhood-stock-tokens

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

响应结构说明

响应外层为 StockDailyListEnvelope，包含 data 与 meta 两大字段：

• data（数组）：日榜单记录列表，每项为 StockDaily 对象，按转账活跃度降序（最活跃的代币排在最前）。包含代币标识（token、symbol、name）、转账活跃度（transfers、unique_senders、unique_receivers）、供应量指标（mint_raw_amount、burn_raw_amount、net_supply_change）、持币分布（holder_count、top10_holder_share_bps）、DEX 交易指标（dex_swap_count、dex_raw_volume）与刷新时间戳（refreshed_at）。
• meta（对象）：链元数据对象（chain、chain_slug、chain_external_id、as_of_block、safe_block、finalized_block、coverage、refreshed_at）。meta.refreshed_at 可能为 null：null 表示这份数据的更新时间未知，应按过期处理（区块类接口始终有值）。

查单个代币（GET /{chain}/stocks/{token}）

GET /{chain}/stocks/{token} 端点根据代币合约地址，查询该代币化股票的基础元数据以及最近最多 30 天的历史每日指标。

请求参数

• {chain}（路径参数，必填）：目标链的标识（例如 robinhood_mainnet）。
• {token}（路径参数，必填）：20 字节代币合约地址，0x 可省略，大小写均可（返回地址规范化为 0x 开头的 40 位小写十六进制字符）。若地址格式不合法，返回 HTTP 400（error.code = "bad_request"）。
• 若 {chain} 未知或未公开，先于 token 校验返回 HTTP 404（error.code = "not_found"，error.data.reason = "unknown_chain"）。在已提供服务的链上，未知的代币化股票仍返回 HTTP 404（error.code = "not_found"）。

代码示例

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/0x1111111111111111111111111111111111111111" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

响应结构说明

响应外层为 StockTokenEnvelope，包含 data 与 meta 两大字段：

• data（对象）：StockToken 对象，包含代币基础元数据（address、symbol、name、decimals、created_block、created_tx_hash、factory、creator、mint_address、burn_address、refreshed_at）以及历史每日指标数组 daily。
  • daily（数组）：包含最近最多 30 天的历史日指标列表（StockDailyMetric），按日期降序（最新在前）排列。每日指标字段结构与上述日榜单中的单日指标相同（不含外层重复的 token、symbol、name）。
• meta（对象）：链元数据对象，与日榜单响应一致。

关键返回字段解释

每日指标字段（StockDaily 与 StockDailyMetric）

每日榜单与单个代币历史指标均包含以下核心日指标字段：

代币元数据字段（StockToken）

查询单个代币时，外层 data 包含该代币的元数据以及最近指标数组：

编码约定说明

API 遵循严格的编码规范以确保跨语言使用时的数据精度与一致性：

• 金额安全性（Money-safety）：所有可能超过 2^53 的 256 位整数值（如 mint_raw_amount、burn_raw_amount、net_supply_change、dex_raw_volume 等）一律序列化为十进制字符串（decimal string），绝不使用 JSON 数字或科学计数/十六进制记法，避免解析浮点数时产生精度截断。在 JavaScript/TypeScript 中建议使用 BigInt(str)（例如 const net = BigInt(body.data.daily[0].net_supply_change)），在 Python 中使用 int(str)。不会超过 2^53 的计数器（如 transfers、unique_senders、unique_receivers、holder_count、top10_holder_share_bps、dex_swap_count、created_block）为普通 JSON 数字。
• 二进制与十六进制值：地址固定为 0x 加 40 位小写十六进制字符；哈希固定为 0x 加 64 位小写十六进制字符。所有返回的十六进制字段一律为全小写。
• 时间与日期：时间戳字段（如 refreshed_at）采用 YYYY-MM-DDTHH:MM:SSZ（ISO-8601 UTC，秒级精度）；日聚合指标（day）采用纯 YYYY-MM-DD 日历日期。

用量估算（每天刷新 50 个代币）

Data API 请求按 CU（计算单元）计量，各操作的 CU 权重由平台统一维护。下方用量测算以「50 个代币各调用一次 GET /{chain}/stocks/{token}」为场景，根据生效的权重数据计算：

开启使用与升级

免费额度适合开发探索与轻量运行。当你的业务规模增长、需要更高的并发调用或更多的计算单元时，可在控制台账单页进行链上充值，到账后即解除账户级每秒调用上限；每个 key 仍有 CU 速率与突发上限，见 JSON-RPC 文档。尚未用完的免费额度保留在服务额度中，可以继续使用。关于计费单位与当前价格，请参阅定价页。

常见问题

接口会返回股票价格或报价吗？ 不会。股票端点返回的是链上活动：转账、铸造、销毁、持币地址数以及 DEX 成交笔数与成交量，不是股票报价。

需要 API key 吗？ 需要。Data API 要求 key；免 key 的公共端点只提供 JSON-RPC 读取。

持有者与余额是实时的吗？ 不是。它们来自每 6 小时刷新一次的快照，/stocks 榜单来自每天刷新一次的日表，最新一天可能缺失或不完整。请查看 meta.refreshed_at。

/stocks 榜单支持分页吗？ 不支持。limit 限制单页最多 500 条，也不会返回 next_cursor。转账、持有者与余额使用游标分页。

余额就是股数吗？ 不是。balance 与 amount 是代币原始数量，需要按乘数指南中的乘数换算成对应股数。

链不支持股票数据集时会怎样？ 股票端点返回 HTTP 422 no_coverage，不计费。

下一步

• 浏览数据集目录，查看 BlockVectra 索引的全部数据集。
• 查看免费额度与定价，确认账户可用的方案。
• 登录控制台创建 API key。