Asset API

Asset API 是 Robinhood Chain（链 ID 4663）上每一只代币化股票和 ETF 的注册表，包含链上合约地址和公司行动乘数。

列出所有资产

curl https://api.stockkit.dev/v1/assets

返回约 194 个资产：

{
  "assets": [
    {
      "symbol": "NVDA",
      "name": "NVIDIA • Robinhood Token",
      "address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
      "chainId": 4663,
      "decimals": 18,
      "multiplier": "1.000000000000000000",
      "status": "ASSET_STATUS_ACTIVE",
      "logoUrl": "https://cdn.robinhood.com/ncw_assets/logos/....png",
      "isin": "US67066G1040"
    }
  ],
  "count": 194
}

获取单个资产

curl https://api.stockkit.dev/v1/assets/NVDA

字段

symbol：代币化资产的规范代码
address：Robinhood Chain 上的 ERC-20 合约地址
decimals：代币精度（股票代币为 18）
multiplier：公司行动乘数；用标的股票价格乘以它，即得到一个代币的价值
status：ASSET_STATUS_ACTIVE 或非活跃
isin：标的证券的 ISIN

公司行动

导致乘数变化的拆股、分红和并购：

curl https://api.stockkit.dev/v1/corporate-actions

股东投票

Robinhood 已宣布 Stock Tokens 即将支持投票。StockKit 提前上线了对应的 API，代理现在就可以接入；上游功能一旦开启，投票事件会自动流入，无需重新部署。

列出投票事件（投票、代理投票和股东大会类公司行动，上游 votes 接口上线后还会附带其原始数据）：

curl https://api.stockkit.dev/v1/votes

在上游尚未上线期间，events 为空且 voting.live 为 false：

{
  "events": [],
  "upstreamVotes": null,
  "voting": {
    "live": false,
    "status": "Announced by Robinhood, not yet shipped upstream. This endpoint will surface vote events automatically once it is."
  }
}

查询一个钱包当前的投票权重。投票权等于标的股份当量：代币余额乘以公司行动乘数。

curl https://api.stockkit.dev/v1/votes/power/0xYourWallet?symbol=NVDA

{
  "address": "0xYourWallet",
  "chainId": 4663,
  "positions": [
    {
      "symbol": "NVDA",
      "tokenBalance": "12.5",
      "multiplier": "1.000000000000000000",
      "shareEquivalent": "12.500000"
    }
  ],
  "totalShareEquivalent": "12.500000"
}

省略 symbol 可扫描钱包持有的全部股票代币。

使用 SDK：

import { StockKit } from "@stockkit/sdk"

const stockkit = new StockKit()

const { events, voting } = await stockkit.votes.list()

const power = await stockkit.votes.power("0xYourWallet", "NVDA")
console.log(power.totalShareEquivalent)