项目信息、币价与链上数据一站式查询接口

只需一次 HTTP 请求，即可获取币种合约地址、官网、社媒、市值、流通量、24h 交易额等十余维度数据！

为什么你需要「项目信息接口」？

在 Web3 钱包开发、DeFi 投研 或 行情展示类 DApp 里，实时、准确且结构化的项目数据是留住用户的第一步。传统做法往往要爬多个聚合站、解析不同格式、处理字段缺失，既费时又易错。
此接口把复杂度封装成一条 GET /api/v5/wallet/token/token-detail，返回完整的 token 核心画像，可直接落地任何前端或后端逻辑。

适用场景纵览

钱包即服务 (WaaS)：显示用户持有资产的官方图标、社媒与官网，提升信任度。
行情面板：一次性拉取市值、24h 交易额、最大供应，减少二次请求。
铭文资产查询：支持 Bitcoin BRC-20、Runes、ARC-20、SRC-20 以及 Fractal Bitcoin 上的 BRC-20，助你无缝兼容热点协议。

👉 想快速体验“币种详情”接口？点这里立即上手！

请求方式

GET https://web3.okx.com/api/v5/wallet/token/token-detail

必传参数

chainIndex String
链唯一标识，比如 Ethereum 主网对应 1，Bitcoin 对应 btc。

tokenAddress String
该字段灵活度高，决定查询“主链币”还是“代币”还是“铭文”：

类型	传值范例	说明
主链币	`""`	空字符串即可
ERC-20 代币	`0xA0b86...`	合约地址
BRC-20	`btc-brc20-ordi`	`btc-brc20-代币名称`
Runes	`btc-runesMain-840000:2`	`btc-runesMain-tickId`
SRC-20	`btc-src20-utxo`	`btc-src20-代币名称`
Fractal BRC-20	`fbtc_fbrc20_babymusk`	`fbtc_fbrc20_代币名称`

返回字段一览（核心关键词已自然融入）

logoUrl – 币种高清图标
officialWebsite – 代币官网，用户一键跳转
socialUrls – 结构化社媒；包含 twitter、telegram、discord、reddit、github、whitepaper、announcement 等子层，哪个字段有数据就返回哪个，避免空字段冗余。
decimals – 合约精度，前端格式化余额必用
chainName & symbol & name – 链名、简称、全名，用于多链聚合 UI
maxSupply & totalSupply – 最大供应与总供应，查通胀模型与潜在抛压
volume24h – 24h 交易额（USD），高波动币一目了然
marketCap – 实时市值计算，投研核心维度

FAQ：开发者最常遇到的 5 个问题

问：为什么 totalSupply 字段偶尔会返回空？
答：当合约未公开 totalSupply 或铭文协议官方未汇报总上限时，接口保留字段但返回空字符串，避免向下传递无效数据。

问：能否支持 Solana 的 SPL 资产？
答：目前已覆盖 EVM、Bitcoin 协议族与 Fractal Bitcoin，后续新增链会在更新日志中第一时间公告，请订阅官方开发者频道。

问：如果想一次性拉多币数据，需要循环调用接口吗？
答：安全起见，建议单币单请求；对于多币聚合场景，可在后端定时抓取后写入缓存，避免前端并发量过高。

问：加白名单 or API-Key 如何获取？
答：当前接口面向公开调用，暂无白名单限制；若调用频次过高，系统将通过 IP & 速率限制自动保护。

问：返回的 USD 计价价格是哪里采集的？
答：价格由 OKX DEX 聚合的上百家 AMM、CEX 深度加权计算，随时更新，确保与主流行情价差小于千分之一。

实操示例

场景 A：查询「主链币 ETH」

GET https://web3.okx.com/api/v5/wallet/token/token-detail?chainIndex=1&tokenAddress=

精简响应片段：

{
  "logoUrl": "https://static.okx.com/cdn/wallet/logo/eth.png",
  "officialWebsite": "https://ethereum.org",
  "socialUrls": {
    "twitter": ["https://twitter.com/ethereum"],
    "github": ["https://github.com/ethereum"]
  },
  "symbol": "ETH",
  "name": "Ethereum",
  "marketCap": "435879456123.987",
  "volume24h": "12567894321.456"
}

场景 B：查询「铭文 ORDI」

GET https://web3.okx.com/api/v5/wallet/token/token-detail?chainIndex=btc&tokenAddress=btc-brc20-ordi

返回同样完整字段，便于在钱包内展示 BRC-20 版块。

👉 立即体验：10 秒搞定「铭文资产」查询！

进阶用法 Tips

零延迟缓存：将 chainIndex + tokenAddress 作为 KV 存储的主键，缓存 30 秒即可兼顾实时性与性能。
图形化显示：利用返回的 decimals + totalSupply 在前端绘制定长进度条，供用户直观感受代币分配。
风险 URL 提示：如果 officialWebsite 或 socialUrls 域名包含社区举报的风险关键词，可做二次弹窗提示，降低钓鱼风险。

结语

一条 RESTful 接口，即可让 币种详情、链上数据、项目信息 一步到位。不论是 钱包即服务 还是 行情聚合 场景，都能直接节省 70% 以上的开发工作量。现在就动手，接入“项目信息接口”，为你的用户提供更透明、更可信、更专业的 Web3 体验。