欢迎使用OKLink API

OKLink是多链浏览器数据查询和分析平台，同时提供加密货币交易监控和链上反洗钱(Onchain AML)合规解决方案，专注于为区块链行业的建设者提供高质量的链上数据和合规工具。

多链浏览器的API：
提供标准的OpenAPI服务，使开发者能够通过RestFul API获取OKlink的多链浏览器数据和服务。已支持以下功能模块：

公链信息模块:获取浏览器所支持的公链列表、公链详情、公链最佳Gas费、公链地址数、交易数等链的多维度的数据。
区块数据模块:获取指定公链的区块详情、区块列表、区块交易列表、某地址历史区块高度余额等区块的多维度数据。
矿工数据模块:获取指定公链的矿池详情、挖矿算力排名、超级节点/验证人列表相关数据。
交易数据模块:获取指定公链的大额交易列表、交易明细、交易列表、未确认交易列表多维度数据和广播交易上链功能。
代币数据模块:获取指定公链的代币列表信息包含20代币、721代币、1155代币、代币持仓列表、代币转账列表等代币等多维度数据。
稳定币数据模块:获取USDT在ETH、TRON、BTC链的发行和销毁记录数据，其他稳定币将陆续支持。
交易所POR数据模块:获取OKX、Binance、Bitfinex等9家主流交易所的储备金详情、历史的储备金记录、资产详情。
ETH通缩数据模块:提供ETH每日对供应与销毁的详情数据，以及ETH质押详情。
BRC20数据模块:获取BTC链的BRC20代币列表、Inscriptions列表、代币详情、代币持仓详情、代币转账详情、代币余额查询等多维度数据

浏览器API目前已支持的公链为：Bitcoin，Bitcoin Cash，Ethereum，OKT Chain，OKB Chain Test，BNB Chain，Ethereum Classic，Litecoin，DASH，TRON，Polygon，Avalanche-C，Aptos，EthereumPoW，EthereumFair，Fantom，OP Mainnet，Arbitrum One，Dogecoin，Sui，Klaytn，zkSync Era，Gnosis，Ronin，将逐步支持更多的链，您可以通过接口查询OKLink浏览器API已支持的公链。

快速入门

当你注册并登录成功后，即可创建APIkey。

API 鉴权

APIkey是访问API接口的唯一身份标识，所有OpenAPI接口都需要APIkey鉴权才可以访问。

API请求地址URL如下：

https://www.oklink.com/

APIkey使用方法：

对于每个API请求，需要在Http Request Headers 中添加(“Ok-Access-Key”,填写你的APIkey)

API接口访问请求示例：

curl -X GET 'https://www.oklink.com/api/v5/explorer/blockchain/summary' \
  --header 'Ok-Access-Key:你的APIkey' \
  --header 'Content-type: application/json'

访问限制

免费用户，限制为每个账户每秒 5 次
付费用户，限制为每个账户每秒 80 次

联系我们

如果以上限速无法满足你的业务需求或者接API时有任何问题，请通过以下方式联系我们。

微信号：jztbeijing，oklinkAPI，与专业量化人员交流。
官方邮箱：[email protected]
Tele：https://t.me/OKLinkAPI

接口列表

每次接口调用的时候都会消耗可调用量，大部分接口的消耗是1或者2，具体消耗信息详见下面列表

接口名称	调用路径	消耗
查看公链列表	GET /api/v5/explorer/blockchain/summary	1
查询公链详情	GET /api/v5/explorer/blockchain/info	1
查询持币地址基础信息	GET /api/v5/explorer/blockchain/address	1
查询区块基础信息	GET /api/v5/explorer/blockchain/block	1
查询最佳手续费或Gas费	GET /api/v5/explorer/blockchain/fee	1
查询算力基础信息	GET /api/v5/explorer/blockchain/hashes	1
查询挖矿基础信息	GET /api/v5/explorer/blockchain/mine	1
查询链上交易信息	GET /api/v5/explorer/blockchain/transaction	1
查询区块头明细	GET /api/v5/explorer/block/block-fills	1
查询区块列表	GET /api/v5/explorer/block/block-list	1
查询区块交易列表	GET /api/v5/explorer/block/transaction-list	1
查询地址余额明细	GET /api/v5/explorer/address/address-balance-fills	1
获取地址基本信息	GET /api/v5/explorer/address/address-summary	1
富豪地址排行榜TOP100	GET /api/v5/explorer/address/rich-list	1
查询地址交易列表信息	GET /api/v5/explorer/address/transaction-list	1
查询地址UTXO交易	GET /api/v5/explorer/address/unspent	1
查询地址剩余UTXO	GET /api/v5/explorer/address/utxo	1
查询矿池份额	GET /api/v5/explorer/pool/estimated-pool-share	1
查询查询矿池算力排名	GET /api/v5/explorer/pool/pool-hashrate-rank	1
查询超级节点/验证人列表	GET /api/v5/explorer/pool/validator-list	1
查询大额交易列表	GET /api/v5/explorer/transaction/large-transaction-list	1
查询交易明细	GET /api/v5/explorer/transaction/transaction-fills	1
查询交易列表信息	GET /api/v5/explorer/transaction/transaction-list	1
查询未确认交易列表	GET /api/v5/explorer/transaction/unconfirmed-transaction-list	1
广播交易上链	POST /api/v5/explorer/transaction/publish-tx	5
解析交易	POST /api/v5/explorer/transaction/decode	5
查询代币列表信息	GET /api/v5/explorer/token/token-list	1
查询代币持仓列表详情	GET /api/v5/explorer/token/position-list	1
查询代币转帐详情	GET /api/v5/explorer/token/transaction-list	1
查询USDT印钞/销毁记录	GET /api/v5/explorer/stablecoin/printing-record	1
获取交易所储备金	GET /api/v5/explorer/por/proof-of-reserves	5
获取交易所历史储备金	GET /api/v5/explorer/por/institution-history-asset	5
获取资产详情	GET /api/v5/explorer/por/address-balance-details	5
ETH通缩概览	GET /api/v5/explorer/deflation/supply	5
每日供应/销毁	GET /api/v5/explorer/deflation/supply-burn	5
ETH质押详情	GET /api/v5/explorer/deflation/pos-staking?chainShortName=eth	5
ETH的gas历史	GET /api/v5/explorer/deflation/gas	5
查询地址代币授权	GET /api/v5/tracker/contractscanner/token-authorized-list	1
获取某Dex逐笔交易数据	GET /api/v5/explorer/tokenprice/tracker	1
获取代币唯一id	GET /api/v5/explorer/tokenprice/token-list	1
实时币价	GET /api/v5/explorer/tokenprice/market-data	2
支持查询代币的历史价格	GET /api/v5/explorer/tokenprice/historical	1
查询NFT所支持的链	GET /api/v5/explorer/nft/chain-list	1
获取NFT市场概览	GET /api/v5/explorer/nft/nft-stats-overview	1
获取NFT的持有者地址	GET /api/v5/explorer/nft/nft-owner-address	1
查询地址持有的NFT列表	GET /api/v5/explorer/nft/address-balance-fills	1
查询某项目所有持有者列表	GET /api/v5/explorer/token/position-list	1
获取某NFT详细数据	GET /api/v5/explorer/nft/nft-details	1
获取某项目的概览数据	GET /api/v5/explorer/nft/collection-info	1
获取项目基础数据	GET /api/v5/explorer/nft/collection-details	1
获取项目的NFTID列表	GET /api/v5/explorer/nft/collection-nft-list	1
查询inscriptions列表	GET /api/v5/explorer/btc/inscriptions-list	1
查询BRC20代币列表	GET /api/v5/explorer/btc/token-list	1
获取BRC20详细信息	GET /api/v5/explorer/btc/token-details	1
BRC20持仓地址列表	GET /api/v5/explorer/btc/position-list	1
查询BRC20转账列表	GET /api/v5/explorer/btc/transaction-list	1
查询地址BRC20余额列表	GET /api/v5/explorer/btc/address-balance-list	1
查询地址BRC20余额明细	GET /api/v5/explorer/btc/address-balance-details	1
获取NFT的历史交易	GET /api/v5/explorer/nft/nft-trade-history	1
获取NFT的出价订单	GET /api/v5/explorer/nft/nft-offers-list	1
获取NFT的出售订单	GET /api/v5/explorer/nft/nft-listing-list	1
查询信标链的质押记录	GET /api/v5/explorer/beacon/beacon-deposit-list	1
查询信标链的出块列表	GET /api/v5/explorer/beacon/beacon-slot-list	1
查询信标链基础信息	GET /api/v5/explorer/beacon/beacon-summary	1
查询信标链验证者详情	GET /api/v5/explorer/beacon/beacon-validator-details	1
查询信标链验证者列表	GET /api/v5/explorer/beacon/beacon-validator-list	1
查询信标链的质押记录列表	GET /api/v5/explorer/beacon/beacon-withdrawal-list	1

公链基础数据模块

公链基础数据模块功能模块的接口，可获取所有支持的公链列表，公链的基础信息数据。

查询公链列表

获取OKLink目前所支持的所有公链列表，和每个链的基本信息。

每次调用消耗 0 点

HTTP请求

GET /api/v5/explorer/blockchain/summary

请求示例

GET /api/v5/explorer/blockchain/summary

请求参数

参数名	类型	是否必须	描述
chainShortName	String	否	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "lastHeight": "15495964",
            "lastBlockTime": "1662631619000",
            "circulatingSupply": "119663643.32797343",
            "circulatingSupplyProportion": "1",
            "transactions": "1703527016"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
lastHeight	String	最新区块高度
lastBlockTime	String	最新区块时间；Unix时间戳的毫秒数格式，如 `1597026383085`
circulatingSupply	String	当前公链本币流通数量
circulatingSupplyProportion	String	当前公链本币流通数量所占总供应量的比例，以小数展示. 举例：`0.85`等于所占比例为85%
transactions	String	交笔总数

查询公链详情

获取OKLink目前所支持的公链详情信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/info

请求示例

GET /api/v5/explorer/blockchain/info?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "rank": "2",
            "mineable": true,
            "algorithm": "Ethash ",
            "consensus": "PoW+PoS",
            "diffEstimation": "",
            "currentDiff": "12.34P",
            "diffAdjustTime": "",
            "circulatingSupply": "119663990.60586369",
            "totalSupply": "119663990.60586369",
            "tps": "12.41",
            "lastHeight": "15496152",
            "lastBlockTime": "1662634452000",
            "issueDate": "1406131200000"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
rank	String	公链市值排名
mineable	Bol	是否支持挖矿，例如：`true` / `false`
algorithm	String	核心算法，例如：`SHA-256`
consensus	String	共识算法，例如：`PoW`
diffEstimation	String	下次挖矿难度预测，BTC的单位：`T`，如果该某个链没有该参数，返回""
currentDiff	String	当前全网挖矿难度
diffAdjustTime	String	下次挖矿难度调整时间
circulatingSupply	String	流通量
totalSupply	String	最大供应量
tps	String	链上每秒交易处理数量。近一周平均值
lastHeight	String	最新区块高度
lastBlockTime	String	上一个区块时间；Unix时间戳的毫秒数格式，如 `1597026383085`
issueDate	String	发行日期；Unix时间戳的毫秒数格式，如 `1597026383085`

查询持币地址基础信息

获取OKLink目前所支持的公链的持币地址的基本信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/address

请求示例

GET /api/v5/explorer/blockchain/address?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "validAddressCount": "86297889",
            "newAddressCount24h": "35792",
            "totalAddresses": "254039543",
            "newTotalAddresses24h": "69827",
            "contractAddresses": "50892123",
            "newContractAddresses24h": "6342",
            "externalAddresses": "203147420",
            "newExternalAddresses24h": "63485",
            "activeAddresses": "494966",
            "newActiveAddresses": "8926"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
validAddressCount	String	持公链本币地址数量
newAddressCount24h	String	持币地址数近24小时新增/减少量
totalAddresses	String	该链所有的地址数
newTotalAddresses24h	String	总地址数近24小时新增/减少量
contractAddresses	String	该链所有的合约地址数
newContractAddresses24h	String	合约地址数近24小时新增/减少量
externalAddresses	String	普通地址数
newExternalAddresses24h	String	普通地址数24小时新增/减少量
activeAddresses	String	活跃地址数
newActiveAddresses	String	活跃地址数24小时新增/减少量

查询区块基础信息

获取OKLink目前所支持的公链详区块的基础信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/block

请求示例

GET /api/v5/explorer/blockchain/block?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "lastHeight": "15496201",
            "firstExchangeHistoricalTime": "1406131200000",
            "firstBlockTime": "1406131200000",
            "firstBlockHeight": "0",
            "avgBlockInterval": "14.392",
            "avgBlockSize24h": "",
            "avgBlockSize24hPercent": "0",
            "mediaBlockSize": "65692.99815616556",
            "halveTime": ""
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
lastHeight	String	最新区块高度
firstExchangeHistoricalTime	String	第一次交易时间；Unix时间戳的毫秒数格式，如 `1597026383085`
firstBlockTime	String	第一次出块时间；Unix时间戳的毫秒数格式，如 `1597026383085`
firstBlockHeight	String	第一个区块高度
avgBlockInterval	String	平均出块时间（近一周），`ETH单位`是S
avgBlockSize24h	String	平均区块大小（24小时）
avgBlockSize24hPercent	String	平均区块大小涨跌幅
mediaBlockSize	String	区块大小中位数（近一周）
halveTime	String	减半时间；Unix时间戳的毫秒数格式，如 `1597026383085`

查询最佳手续费或Gas费

获取OKLink目前所支持的公链Gas费的基础信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/fee

请求示例

GET /api/v5/explorer/blockchain/fee?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`okc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "bestTransactionFee": "",
            "recommendedGasPrice": "90.111827841",
            "rapidGasPrice": "91.411827841",
            "standardGasPrice": "90.111827841",
            "slowGasPrice": "90.011827841"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
bestTransactionFee	String	最佳交易手续费
rapidGasPrice	String	极速Gas费，预估15s内完成交易确认
standardGasPrice	String	一般Gas费，预估3分钟内完成交易确认
slowGasPrice	String	缓慢Gas费，预估大于15分钟完成交易确认
recommendedGasPrice	String	建议Gas费，单位。ETH单位：`Gwei`

查询算力基础信息

获取OKLink目前所支持的公链算力的基础信息。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/hashes

请求示例

GET /api/v5/explorer/blockchain/hashes?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "hashRate": "891.47TH",
            "hashRateChange24h": "-0.0561"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
hashrate	String	近一周全网算力
hashrateChange24h	String	全网算力 24 小时涨跌幅，小数展示. 例如：正数为上涨；`0.02`，表示上涨`2%` 例如：负数为下跌：`-0.02`，表示下跌`2%`

查询挖矿基础信息

获取OKLink目前所支持的公链的挖矿基础信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/mine

请求示例

GET /api/v5/explorer/blockchain/mine?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "avgMineReward24h": "",
            "minerIncomePerUnit": "0.024509833699208023",
            "minerIncomePerUnitCoin": "0.000015118887757508927"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
avgMineReward24h	String	24 小时平均区块奖励
minerIncomePerUnit	String	每单位算力收益
minerIncomePerUnitCoin	String	每单位算力收益币数

查询链上交易信息

获取OKLink目前所支持的公链链上交易础信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/blockchain/transaction

请求示例

GET /api/v5/explorer/blockchain/transaction?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "pendingTransactionCount": "147373",
            "transactionValue24h": "2309415",
            "totalTransactionCount": "1703578474",
            "tranRate": "12.34",
            "avgTransactionCount24h": "",
            "avgTransactionCount24hPercent": "",
            "pendingTransactionSize": ""
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	公链原生代币，例如：`btc`
pendingTransactionCount	String	未确认交易数
transactionValue24h	String	`24` 小时的链上交易量
totalTransactionCount	String	链上交易总数
tranRate	String	50个块的平均TPS
avgTransactionCount24h	String	24 小时平均交易数量
avgTransactionCount24hPercent	String	24 小时平均交易数量涨幅
pendingTransactionSize	String	未确认交易的大小

区块数据模块

区块数据模块功能模块的接口，可获取各个公链区块列表，区块交易明细，区块详情等信息

查询区块头明细

获取OKLink目前所支持的公链的区块明细。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/block/block-fills

请求示例

GET /api/v5/explorer/block/block-fills?chainShortName=btc&height=735732

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
height	String	是	区块高度
netWork	String	否	USDT该字段必填写，需要指定所属网络

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "hash": "0xb837772ccffca8ffc56a5744c61eb49a13359068b971e4c47c602a708341dff0",
            "height": "14636119",
            "validator": "unknown",
            "blockTime": "1650650059000",
            "txnCount": "388",
            "amount": "581.754319526449",
            "blockSize": "154506",
            "mineReward": "2.1135572588660683",
            "totalFee": "1.665664869236147",
            "feeSymbol": "ETH",
            "ommerBlock": "0",
            "merkleRootHash": "0x545d4b8b000af4cdd1311c4b671c973447c9e456b986873c9b07a3686e1cad9e",
            "gasUsed": "27606791",
            "gasLimit": "29941410",
            "gasAvgPrice": "0.00000006033533087",
            "state": "",
            "burnt": "1.5521076103700786",
            "netWork": "",
            "txnInternal": "151",
            "miner": "0x2a20380dca5bc24d052acfbf79ba23e988ad0050",
            "difficuity": "13408168967664674",
            "nonce": "9dcedb3be62945a2",
            "tips": "0.08107281539769584",
            "confirm": "860638",
            "baseFeePerGas": "0.000000056221949533"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
hash	String	块hash
height	String	区块高度
validator	String	出块者/超级节点/验证人
blockTime	String	出块时间；Unix时间戳的毫秒数格式，如 1597026383085
amount	String	交易金额
txnCount	String	该区块包含的交易个数
txnInternal	String	该区块包含的内部交易个数
blockSize	String	区块大小，单位是：bytes
mineReward	String	区块奖励，块收益等于mineReward+totalFee，以手续费币种为单位
totalFee	String	该区块所有手续费总和，以手续费币种为单位
feeSymbol	String	手续费币种
ommerBlock	String	叔块
merkleRootHash	String	梅克尔跟哈希
gasUsed	String	gas消耗
gasLimit	String	gas限额
gasAvgPrice	String	gas均价，ETH，单位Gwei
state	String	块状态确认中:pending、确认完成:done
burnt	String	销毁手续费数量
netWork	String	所在网络，展示对应公链的chainFullName 例如：TRON
miner	String	打包该区块的矿工地址Hash
difficulty	String	打包该区块时的难度
nonce	String	在PoW区块链中，nonce用于描述挖矿难度
confirm	String	确认数
tips	String	小费交易发起方为了优先打包自己的交易，愿意付给出块者的最大Gas单价，单位为ETH或Gwei
baseFeePerGas	String	每Gas基础费，ETH，单位Gwei

查询区块列表

获取OKLink目前所支持的公链的区块列表信息，仅返回近1万条区块列表数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/block/block-list

请求示例

GET /api/v5/explorer/block/block-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
height	String	否	区块高度
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "blockList": [
                {
                    "hash": "0xb837772ccffca8ffc56a5744c61eb49a13359068b971e4c47c602a708341dff0",
                    "height": "14636119",
                    "validator": "unknown",
                    "blockTime": "1650650059000",
                    "txnCount": "388",
                    "blockSize": "154506",
                    "mineReward": "2.1135572588660683",
                    "totalFee": "1.665664869236147",
                    "feeSymbol": "ETH",
                    "avgFee": "0",
                    "ommerBlock": "0",
                    "gasUsed": "27606791",
                    "gasLimit": "29941410",
                    "gasAvgPrice": "0.00000006033533087",
                    "state": "",
                    "burnt": "1.5521076103700786",
                    "netWork": ""
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
blockList	Array	交易列表
> hash	String	块hash
> height	String	区块高度
> validator	String	出块者/超级节点/验证人
> blockTime	String	出块时间；Unix时间戳的毫秒数格式，如 1597026383085
> txnCount	String	该区块包含的交易条数
> blockSize	String	区块大小，单位是：bytes
> mineReward	String	区块奖励，块收益等于mineReward+totalFee
> totalFee	String	该区块所有手续费总和
> feeSymbol	String	手续费币种
> avgFee	String	每笔交易平均手续费
> ommerBlock	String	叔块
> gasUsed	String	gas消耗
> gasLimit	String	gas限额
> gasAvgPrice	String	gas均价
> state	String	块状态确认中:pending 确认完成:done
> burnt	String	销毁手续费数量
> netWork	String	所在网络，展示对应公链的chainFullName 例如：TRON

查询区块交易列表

获取区块链下的某一区块里的交易列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/block/transaction-list

请求示例

GET /api/v5/explorer/block/transaction-list?chainShortName=eth&height=18126560

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
height	String	是	区块高度
protocolType	String	否	不同类型的交易交易：transaction 内部交易：internal 20代币：token_20 721代币：token_721 1155代币：token_1155 10代币：token_10 默认是transaction
limit	String	否	返回条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "635",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "blockList": [
                {
                    "txid": "0x5a597e627d67a4e9daa9b710bf217c6690a2ac09521b45ffbb0b82b0f6d84245",
                    "methodId": "0x771d503f",
                    "blockHash": "0xadaed44b8d75332a8627a490cdd49e8aab227c901859f7918aea2b7f6d54e297",
                    "height": "18126560",
                    "transactionTime": "1694598095000",
                    "from": "0x104da4efb22a7e560e6df9c813e5eb54ca038737",
                    "isFromContract": false,
                    "isToContract": true,
                    "to": "0x51c72848c68a965f66fa7a88855f9f7784502a7f",
                    "amount": "0",
                    "transactionSymbol": "ETH",
                    "txfee": "0.004454715411444375",
                    "state": "success",
                    "tokenId": "",
                    "tokenContractAddress": ""
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin
chainShortName	String	公链缩写符号，例如：`BTC
blockList	Array	交易列表
> txid	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 `1597026383085`
> from	String	发送方地址
> isFromContract	Bol	From地址是否是合约地址
> isToContract	Bol	To地址是否是合约地址
> to	String	接收方地址
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> state	String	交易状态 success:成功 fail:失败 pending:等待确认
> tokenContractAddress	String	代币合约地址
> tokenId	String	NFT的ID
> methodId	String	方法

地址数据模块

地址数据模块功能模块的接口，可以获取富豪地址排行榜、地址余额、地址基本信息、地址交易列表等相关数据

查询地址详细信息

获取某个地址详细信息，可获取地址余额、代币余额、合约调用次数、合约对应代币等信息。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/information-evm

请求示例

GET /api/v5/explorer/address/information-evm?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "balance": "0.000000000000000001",
            "balanceSymbol": "ETH",
            "transactionCount": "177695079",
            "assetUsdValue": "470992.09106647",
            "firstTransactionTime": "1511831234000",
            "lastTransactionTime": "1694673299000",
            "contractAddress": true,
            "createContractAddress": "0x36928500bc1dcd7af6a2b4008875cc336b927d57",
            "createContractTransactionHash": "0x2f1c5c2b44f771e942a8506148e256f94f1a464babc938ae0690c6e34cd79190",
            "contractCorrespondingToken": "USDT",
            "contractCalls": "4740091",
            "contractCallingAddresses": "776788"
        }
    ]
}

返回参数

参数名	类型	描述
address	String	普通地址
isValidator	BOl	是否为验证人地址
balance	String	本链币余额
balanceSymbol	String	本链币余额币种
transactionCount	String	该地址交易次数
firstTransactionTime	String	该地址发生第一笔交易时间
lastTransactionTime	String	该地址最近一次发生交易时间
contractAddress	Bol	是否为智能合约地址
createContractAddress	String	创建该智能合约的地址
createContractTransactionHash	String	创建该智能合约的交易hash
contractCorrespondingToken	String	该地址对应的代币
contractCalls	String	创建该智能合约的地址
contractCallingAddresses	String	合约调用次数

查询地址代币余额明细

获取某个地址代币余额明细，可以获取该地址上的所有代币余额信息。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/token-balance

请求示例

GET /api/v5/explorer/address/token-balance?chainShortName=eth&address=0xe519e5EB81F92bF19EcFc7e5d9c6418CD8c2E0B9&protocolType=token_20

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址
protocolType	String	是	合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
tokenContractAddress	String	否	代币合约地址
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": {
        "limit": "20",
        "page": "1",
        "totalPage": "1",
        "tokenList": [
            {
                "symbol": "SolFi.Vision",
                "tokenContractAddress": "0xd88e87cd53d5b3c88c07bdb4715a39b75d6e7870",
                "holdingAmount": "350",
                "tokenId": ""
            }
        ]
    }
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenList	Array	代币列表
> symbol	String	该地址对应的代币
> tokenContractAddress	String	该地址对应的代币合约地址
> holdingAmount	String	代币持仓数量
> tokenId	String	NFT 的ID

查询地址普通交易列表信息

获取地址相关的普通交易列表，仅返近一年或最后一笔交易发生时间倒推一年的数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/normal-transaction-list

请求示例

GET /api/v5/explorer/address/transaction-list?chainShortName=btc&address=90817bf1d289eb347b6b9b8818db02cb833cbe73efec940fa99852035a665e39

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址
startBlockHeight	String	否	开始区块高度
endBlockHeight	String	否	最终区块高度
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": {
        "limit": "20",
        "page": "1",
        "totalPage": "1",
        "transactionList": [
            {
                    "txId": "0x864d4dbd8fdcfd48a31d0ae30ffc7c882b69a0263c817d9f561ae84eecaa69c4",
                    "methodId": "0x7ff36ab5",
                    "nonce": "39",
                    "gasPrice": "22560736026",
                    "gasLimit": "147775",
                    "gasUsed": "109022",
                    "blockHash": "0x5ec3d59a04f89e239a74f750a8daa002a04eee22d6c6cb96dfe5fc8147622201",
                    "height": "18011883",
                    "transactionTime": "1693210475000",
                    "from": "0xc82b11fd2668a1f3a69a63c4e856a9907ae18edd",
                    "to": "0x03f7724180aa6b939894b5ca4314783b0b36b329",
                    "isFromContract": false,
                    "isToContract": true,
                    "amount": "0.006144186174090496",
                    "symbol": "ETH",
                    "txFee": "0.002459616563026572",
                    "state": "success"
            }
        ]
    }
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
transactionList	Array	交易列表
> txId	String	交易哈希
> method	String	方法
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from	String	发送方地址
> to	String	接收方地址
> isFromContract	Bol	From地址是否是合约地址
> isToContract	Bol	To地址是否是合约地址
> amount	String	交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动。
> symbol	String	交易数量对应的币种
> nonce	String	发起者地址发起的第几笔交易
> gasLimit	String	gas限额
> gasUsed	String	gas消耗
> gasPrice	String	gas价格
> txFee	String	手续费
> state	String	交易状态 `success` 成功 `fail` 失败 `pending` 等待确认

查询地址内部交易列表信息

获取地址相关的内部交易列表，仅返近一年或最后一笔交易发生时间倒推一年的数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/internal-transaction-list

请求示例

GET /api/v5/explorer/address/internal-list?chainShortName=btc&address=90817bf1d289eb347b6b9b8818db02cb833cbe73efec940fa99852035a665e39

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址
startBlockHeight	String	否	开始区块高度
endBlockHeight	String	否	最终区块高度
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": {
        "limit": "20",
        "page": "1",
        "totalPage": "1",
        "transactionList": [
           {
                    "txId": "0x864d4dbd8fdcfd48a31d0ae30ffc7c882b69a0263c817d9f561ae84eecaa69c4",
                    "operation": "staticcall",
                    "blockHash": "0x5ec3d59a04f89e239a74f750a8daa002a04eee22d6c6cb96dfe5fc8147622201",
                    "height": "18011883",
                    "transactionTime": "1693210475000",
                    "from": "0x03f7724180aa6b939894b5ca4314783b0b36b329",
                    "to": "0xefb47fcfcad4f96c83d4ca676842fb03ef20a477",
                    "isFromContract": true,
                    "isToContract": true,
                    "amount": "0",
                    "symbol": "ETH"
            }
        ]
    }
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
transactionList	Array	交易列表
> txId	String	交易哈希
> operation	String	操作类型
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from	String	发送方地址
> to	String	接收方地址
> isFromContract	Bol	From地址是否是合约地址
> isToContract	Bol	To地址是否是合约地址
> amount	String	交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动。
> symbol	String	交易数量对应的币种

查询地址代币交易列表信息

获取地址相关的代币交易交易列表，仅返近一年或最后一笔交易发生时间倒推一年的数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/token-transaction-list

请求示例

GET /api/v5/explorer/address/token-transaction-list?chainShortName=btc&address=90817bf1d289eb347b6b9b8818db02cb833cbe73efec940fa99852035a665e39

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址
protocolType	String	是	合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
tokenContractAddress	String	否	代币合约地址
startBlockHeight	String	否	开始区块高度
endBlockHeight	String	否	最终区块高度
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": {
        "limit": "20",
        "page": "1",
        "totalPage": "1",
        "transactionList": [
            {
                    "txId": "0x8a6d1ad9caf280948b59ee4886e779c56299d7cda511819c171adeb8cbd93fdf",
                    "blockHash": "0xb587efc9027625fba5430e6c62b73ce0dae4195bbd2a73936a34a750367040ab",
                    "height": "18011932",
                    "transactionTime": "1693211063000",
                    "from": "0x03f7724180aa6b939894b5ca4314783b0b36b329",
                    "to": "0xefb47fcfcad4f96c83d4ca676842fb03ef20a477",
                    "tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "tokenId": "",
                    "amount": "0.023803304822087826",
                    "symbol": "WETH",
                    "isFromContract": true,
                    "isToContract": true
            }
        ]
    }
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
transactionList	Array	交易列表
> txId	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from	String	发送方地址
> to	String	接收方地址
> isFromContract	Bol	From地址是否是合约地址
> isToContract	Bol	To地址是否是合约地址
> amount	String	交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动。
> symbol	String	交易数量对应的币种
> tokenId	String	NFT 的ID

批量查询余额

可以批量查询最多50个地址的原生代币的余额

每次请求消耗 `5` 次调用量

HTTP请求

GET /api/v5/explorer/address/balance-multi

请求示例

GET /api/v5/explorer/address/balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询
address	String	是	地址，最多可以输入50个地址，以`,`分割

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "symbol": "ETH",
            "balanceList": [
                {
                    "address": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
                    "balance": "0"
                },
                {
                    "address": "0xb13a8883d5116b418066c379bc3b3f40d087b8d8",
                    "balance": "0.00019330554147975"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	页码
limit	String	每页返回的数据条数，默认最小20条，最多100条
totalPage	String	余额列表
balanceList	Array	交易列表
> address	String	地址
> balance	String	原生代币的余额

批量查询代币余额

可以批量查询最多50个地址的代币的余额，一个地址如果持有多个代币，则会有多条数据，每页最多返回2000条数据。

每次请求消耗 `5` 次调用量

HTTP请求

GET /api/v5/explorer/address/token-balance-multi

请求示例

GET /api/v5/explorer/address/balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询
address	String	是	地址，最多可以输入50个地址，以`,`分割
protocolType	String	否	不同的代币类型，20代币：`token_20`，721代币：`token_721`，1155代币：`token_1155`，默认为`token_20`

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "2",
            "totalPage": "686",
            "balanceList": [
                {
                    "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
                    "holdingAmount": "400",
                    "tokenContractAddress": "0x7379cbce70bba5a9871f97d33b391afba377e885"
                },
                {
                    "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
                    "holdingAmount": "123101078.45198849",
                    "tokenContractAddress": "0x5c885be435a9b5b55bcfc992d8c085e4e549661e"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	页码
limit	String	每页返回的数据条数，默认最小20条，最多2000条
totalPage	String	总共的页数
balanceList	Array	余额列表
> address	String	地址
> holdingAmount	String	代币的余额
> tokenContractAddress	String	代币的合约地址

批量查询普通交易

可以批量查询最多20个地址的普通交易，需要限制查询的开始区块高度以及结束的区块高度，两者差距不能超过10000个区块。

每次请求消耗 `5` 次调用量

HTTP请求

GET /api/v5/explorer/address/normal-transaction-list-multi

请求示例

GET /api/v5/explorer/address/balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询
address	String	是	地址，最多可以输入20个地址，以`,`分割
startBlockHeight	String	是	开始搜索的区块号
endBlockHeight	String	是	结束搜索的区块号
page	String	否	页码
limit	String	否	每页返回的数据条数，默认最小20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "transactionList": [
                {
                    "txId": "0x571f4a7e8baed990179224d5f49fc22911cfc5dad0e44ad36bc17dbb42ee8ede",
                    "methodId": "0xa9059cbb",
                    "nonce": "0",
                    "blockHash": "0x4eb25eaeb5ac295e6d4469073fdcaa3c66c1731c123a1fb0068fe84694893a6f",
                    "height": "17888998",
                    "transactionTime": "1691724971000",
                    "from": "0xa4533bfb4bab546fc38fc2ad4e0af88c8ad9b1e2",
                    "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                    "isFromContract": false,
                    "isToContract": true,
                    "amount": "0",
                    "symbol": "ETH",
                    "txFee": "0.000594999238402251",
                    "gasLimit": "100000",
                    "gasUsed": "43713",
                    "gasPrice": "13611494027",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	页码
limit	String	每页返回的数据条数，默认最小20条，最多100条
totalPage	String	总共的页数
transactionList	Array	交易列表
> txId	String	交易哈希
> methodId	String	标识智能合约函数的短哈希
> nonce	String	随机数
> blockHash	String	区块哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易发生的时间；Unix时间戳的毫秒数格式，如`1597026383085`
> from	String	交易发送方的地址，多个地址，以`,`分隔
> to	String	交易接受方的地址，多个地址，以`,`分隔
> isFromContract	Bol	from地址是否是合约地址
> isToContract	Bol	to地址是否是合约地址
> amount	String	代币数量
> symbol	String	交易代币的符号
> txFee	String	交易的手续费（单位ETH）
> gasLimit	String	gas最大使用量
> gasUsed	String	实际的gas使用量（单位Wei）
> gasPrice	String	gas价格（单位Wei）
> state	String	交易状态，成功:`success`，失败:`fail`，等待确认:`pending`

批量查询内部交易

可以批量查询最多20个地址的内部交易，需要限制查询的开始区块高度以及结束的区块高度，两者差距不能超过10000个区块。

每次请求消耗 `5` 次调用量

HTTP请求

GET /api/v5/explorer/address/internal-transaction-list-multi

请求示例

GET /api/v5/explorer/address/token-transaction-list-multi?chainShortName=eth&address=0xA9D1e08C7793af67e9d92fe308d5697FB81d3E43&endBlockHeight=17940838&startBlockHeight=17940138&limit=1

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询
address	String	是	地址，最多可以输入20个地址，以`,`分割
startBlockHeight	String	是	开始搜索的区块号
endBlockHeight	String	是	结束搜索的区块号
page	String	否	页码
limit	String	否	每页返回的数据条数，默认最小20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "3",
            "limit": "1",
            "totalPage": "675",
            "transactionList": [
                {
                    "txId": "0x83dadd1d0dd8a50e4d86daa91fae41fd000ce8ae12a7afe1d7c4eb0e48c596ee",
                    "blockHash": "0xff0cfe9ba47bff0b609dd130d71730dbcbe89d379f6baa3db7bd72f258f7fd99",
                    "height": "17940834",
                    "operation": "staticcall",
                    "from": "0x74de5d4fcbf63e00296fd95d33236b9794016631",
                    "to": "0x4d224452801aced8b2f0aebe155379bb5d594381",
                    "isFromContract": true,
                    "isToContract": true,
                    "amount": "0",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	页码
limit	String	每页返回的数据条数，默认最小20条，最多100条
totalPage	String	总共的页数
transactionList	Array	交易列表
> txId	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易发生的时间；Unix时间戳的毫秒数格式，如`1597026383085`
> operation	String	操作类型
> from	String	交易发送方的地址，多个地址，以`,`分隔
> to	String	交易接受方的地址，多个地址，以`,`分隔
> isFromContract	Bol	from地址是否是合约地址
> isToContract	Bol	to地址是否是合约地址
> amount	String	代币数量

批量查询代币交易

可以批量查询最多20个地址的代币交易，需要限制查询的开始区块高度以及结束的区块高度，两者差距不能超过10000个区块。

每次请求消耗 `5` 次调用量

HTTP请求

GET /api/v5/explorer/address/token-transaction-list-multi

请求示例

GET /api/v5/explorer/address/token-transaction-list-multi?chainShortName=eth&address=0xA9D1e08C7793af67e9d92fe308d5697FB81d3E43&endBlockHeight=17940838&startBlockHeight=17940138&limit=1&tokenContractAddress=0xaa7a9ca87d3694b5755f213b5d04094b8d0f0a6f

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询
address	String	是	地址，最多可以输入20个地址，以`,`分割
startBlockHeight	String	是	开始搜索的区块号
endBlockHeight	String	是	结束搜索的区块号
page	String	否	页码
limit	String	否	每页返回的数据条数，默认最小20条，最多100条
protocolType	String	否	不同的代币类型，20代币：`token_20`，721代币：`token_721`，1155代币：`token_1155`，默认为`token_20`
tokenContractAddress	String	否	代币的合约地址，最多可以输入20个地址，以`,`分割

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "2",
            "transactionList": [
                {
                    "txId": "0xa9c4d0c84d3ee008d7c8276c0356e32996c050aea169d92205a0656c8afa82a3",
                    "blockHash": "0xff0cfe9ba47bff0b609dd130d71730dbcbe89d379f6baa3db7bd72f258f7fd99",
                    "height": "17940834",
                    "transactionTime": "1692351551000",
                    "from": "0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43",
                    "to": "0x69467340b04997e8b9a88418f6047f54e70b52e2",
                    "isFromContract": true,
                    "isToContract": false,
                    "amount": "4351.53070979",
                    "tokenId": "",
                    "symbol": "TRAC",
                    "tokenContractAddress": "0xaa7a9ca87d3694b5755f213b5d04094b8d0f0a6f",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	页码
limit	String	每页返回的数据条数，默认最小20条，最多100条
totalPage	String	总共的页数
transactionList	Array	交易列表
> txId	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易发生的时间；Unix时间戳的毫秒数格式，如`1597026383085`
> from	String	交易发送方的地址，多个地址，以`,`分隔
> to	String	交易接受方的地址，多个地址，以`,`分隔
> isFromContract	Bol	from地址是否是合约地址
> isToContract	Bol	to地址是否是合约地址
> amount	String	代币数量
> tokenId	String	代币ID，适用于721和1155代币
> symbol	String	交易代币的符号
> tokenContractAddress	String	交易代币的合约地址

查询代币余额明细

获取某个地址余额明细，可以获取该地址上的其他大笔余额信息。

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/address-balance-fills

请求示例

GET /api/v5/explorer/address/address-balance-fills?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：BTC、ETH
address	String	是	地址
protocolType	String	否	不同的代币类型，20代币：`token_20`，721代币：`token_721`，1155代币：`token_1155`，默认为`token_20`
tokenContractAddress	String	否	代币合约地址
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "chainFullName": "OKT Chain",
            "chainShortName": "OKTC",
            "tokenList": [
                {
                    "token": "USDT",
                    "tokenId": "",
                    "holdingAmount": "1960718.5605412568",
                    "totalTokenValue": "106462.468970329788524224",
                    "change24h": "0.00030174",
                    "priceUsd": "1.000706314633",
                    "valueUsd": "1962103.4447517617860780507544",
                    "tokenContractAddress": "0x382bb369d343125bfb2117af9c149795c6c65c50"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
tokenList	Array	代币列表
> token	String	该地址对应的代币
> tokenContractAddress	String	该地址对应的代币合约地址
> holdingAmount	String	代币持仓数量
> totalTokenValue	String	代币总价值折算成公链原生币的数量
> change24h	String	代币价格24小时涨跌幅
> priceUsd	String	代币美元价格
> valueUsd	String	代币总的美元价值
> tokenId	String	NFT 的ID

获取地址基本信息

获取某个地址余额信息，可以获取公链地址余额及所支持公链智能合约代币的余额等信息。

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/address-summary

请求示例

GET /api/v5/explorer/address/address-summary?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "TRON",
            "chainShortName": "TRON",
            "address": "TJBtdYunmQkeK5KninwgcjuK1RPDhyUWBZ",
            "contractAddress": "",
            "balance": "6091.521832",
            "balanceSymbol": "TRX",
            "transactionCount": "536122",
            "verifying": "0",
            "sendAmount": "9999",
            "receiveAmount": "16090.521832",
            "tokenAmount": "70",
            "totalTokenValue": "",
            "createContractAddress": "",
            "createContractTransactionHash": "",
            "firstTransactionTime": "1647822777000",
            "lastTransactionTime": "1666168629000",
            "token": "",
            "bandwidth": "6512,6512",
            "energy": "6802,6802",
            "votingRights": "0,0",
            "unclaimedVotingRewards": "0"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
address	String	普通地址
contractAddress	String	智能合约地址
isProducerAddress	BOl	是否为验证人地址 `true`：是验证人/节点地址 `false`：不是验证人/节点地址
balance	String	余额
balanceSymbol	String	余额币种
transactionCount	String	该地址交易次数
verifying	String	确认中金额
sendAmount	String	发送金额
receiveAmount	String	接收金额
tokenAmount	String	代币种类数量
totalTokenValue	String	代币总价值折算成公链原生币的数量
createContractAddress	String	创建该智能合约的地址
createContractTransactionHash	String	创建该智能合约的交易hash
firstTransactionTime	String	该地址发生第一笔交易时间
lastTransactionTime	String	该地址最近一次发生交易时间
token	String	该地址对应的代币
bandwidth	String	带宽和消耗的带宽（仅适用于TRON）
energy	String	能量和消耗的能量（仅适用于TRON），其他链返回“”
votingRights	String	投票全和已用投票权（仅适用于TRON）
unclaimedVotingRewards	String	待领取投票收益（仅适用于TRON）

富豪地址排行榜TOP100

获取某个公链或合约的地址余额排行前100名地址详情。

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/rich-list

请求示例

GET /api/v5/explorer/address/rich-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	否	代币合约地址

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Bitcoin",
            "chainShortName": "BTC",
            "symbol": "BTC",
            "rank": "1",
            "address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
            "amount": "248597.39163733",
            "transactionCount": "842",
            "holdRatio": "0.0118",
            "netWork": ""
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
symbol	String	持仓币种
rank	String	地址余额排名
address	String	持仓地址
amount	String	持仓数量
transactionCount	String	该地址交易次数
holdRatio	String	该地址余额与总流通量的占比
netWork	String	所在网络，仅适用于`USDT`

查询地址交易列表信息

获取OKLink目前所支持的公链的交易列表，仅返回近1万条交易数据

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/transaction-list

请求示例

GET /api/v5/explorer/address/transaction-list?chainShortName=eth&address=0xdAC17F958D2ee523a2206206994597C13D831ec7

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址
protocolType	String	否	不同类型的交易交易：transaction 内部交易：internal 20代币：token_20 721代币：token_721 1155代币：token_1155 10代币：token_10 默认是transaction
tokenContractAddress	String	否	代币合约地址
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10000",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "transactionLists": [
                {
                    "txId": "0x650b848a1cfc337f028752427e556913a7005fc24d3ad105189458d918651e5e",
                    "methodId": "0xa9059cbb",
                    "blockHash": "0x462e4151adb1b0b345d16d5ad72623c4bcd5381eb02ab6ef83dd753654ebe881",
                    "height": "18126655",
                    "transactionTime": "1694599235000",
                    "from": "0xe10aa136b1ca78e4d649cd1934c324f260433e57",
                    "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                    "isFromContract": false,
                    "isToContract": true,
                    "amount": "0",
                    "transactionSymbol": "ETH",
                    "txFee": "0.001458305786787834",
                    "state": "success",
                    "tokenId": "",
                    "tokenContractAddress": "",
                    "challengeStatus": "",
                    "l1OriginHash": ""
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
transactionList	Array	交易列表
> txid	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from	String	发送方地址
> to	String	接收方地址
> isFromContract	Bol	From地址是否是合约地址
> isToContract	Bol	To地址是否是合约地址
> amount	String	交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动。
> transactionSymbol	String	交易数量对应的币种
> tokenContractAddress	String	交易数量对应的币种的合约地址
> txfee	String	手续费
> state	String	交易状态 `success` 成功 `fail` 失败 `pending` 等待确认

查询地址UTXO交易

获取某个地址每笔交易的UTXO，仅适用于BTC，BCH等UTXO模型的链

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/unspent

请求示例

GET /api/v5/explorer/address/unspent?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链
address	String	是	地址

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Bitcoin",
            "chainShortName": "BTC",
            "txId": "9ab07e76093349faae5a4c815d968fcb7e1753f0f441ce439dab27f1242f02f0",
            "height": "788297",
            "amount": "1952.56094525",
            "address": "bc1qmhq4sgtchfgh6ul75x3rsuegt55mef0zx3ehm2",
            "confirm": "",
            "index": "219",
            "transactionIndex": "",
            "balance": "1950.06103047",
            "symbol": "BTC",
            "unspent": ""
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
txid	String	交易哈希
height	String	交易发生的区块
amount	String	UTXO里面的交易金额
address	String	地址
unspent	String	该笔交易未花费的交易输出（找零）
confirm	String	确认数
index	String	该笔交易交易在区块里的位置索引
transactionIndex	String	该笔UTXO在交易里的位置索引
balance	String	该地址余额
symbol	String	币种

查询地址剩余UTXO

获取地址剩余的每笔UTXO明细

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/utxo

请求示例

GET /api/v5/explorer/address/utxo?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链
address	String	是	地址
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的50条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "utxoList": [
                {
                    "txid": "9ab07e76093349faae5a4c815d968fcb7e1753f0f441ce439dab27f1242f02f0",
                    "height": "788297",
                    "blockTime": "1683240021",
                    "address": "bc1qmhq4sgtchfgh6ul75x3rsuegt55mef0zx3ehm2",
                    "unspentAmount": "1950.06103047",
                    "index": "1"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
utxoList	Array	剩余的UTXO列表
> txid	String	交易哈希
> height	String	交易发生的区块
> blockTime	String	UTXO里面的交易金额
> address	String	地址
> unspentAmount	String	该笔交易未花费的交易输出（找零）
> index	String	该笔交易交易在区块里的位置索引

查询cosmos链地址余额

可以查询cosmos链相关地址余额

每次请求消耗 `1` 次调用量

HTTP请求

GET /api/v5/explorer/address/balance-cosmos

请求示例

GET /api/v5/explorer/address/balance-cosmos?chainShortName=cosmos&address=cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号
address	String	是	地址

返回结果

{
    "code": 0,
    "msg": "",
    "detailMsg": "",
    "data": {
         "address": "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8",
        "availableBalance": "0.571788",
        "delegated": "0",
        "delegatedReward": "0",
        "rewardRecipientAddress": "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8",
        "unbonding": "0",
        "symbol": "COSMOS"
    }
}

返回参数

参数名	类型	描述
address	String	地址
availableBalance	String	可用余额
delegated	String	委托中(质押中)数量
delegatedReward	String	质押奖励
rewardRecipientAddress	String	奖励提取地址
unbonding	String	解压中数量
symbol	String	本链币余额币种

查询Cosmos链地址代币余额明细

获取Cosmos链某个地址代币余额明细，可以获取该地址上的所有代币余额信息。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/token-balance-detail-cosmos

请求示例

GET /api/v5/explorer/address/token-balance-detail-cosmos?chainShortName=cosmos&address=cosmos1yh089p0cre4nhpdqw35uzde5amg3qzexnduapq&limit=1

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
address	String	是	地址
tokenType	String	否	代币的类型，默认为all可以选择原生代币、LP token和ibc 代币
ibcDenom	String	否	跨链代币标识
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": 0,
    "msg": "",
    "detailMsg": "",
    "data": {
        "page": "1",
        "limit": "1",
        "totalPage": "11",
        "tokenList": [
            {
                "token": "",
                "ibcDenom": "ibc/B38AAA0F7A3EC4D7C8E12DFA33FF93205FE7A42738A4B0590E2FF15BC60A612B",
                "tokenType": "ibc",
                "holdingAmount": "304820518897426"
            }
        ]
    }
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenList	Array	代币列表
> token	String	该地址对应的代币
> ibcDenom	String	跨链代币标识
> holdingAmount	String	代币持仓数量

查询Cosmos链地址普通交易列表信息

获取Cosmos链地址相关的普通交易列表，仅返近一年或最后一笔交易发生时间倒推一年的数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/address/normal-transaction-cosmos

请求示例

GET /api/v5/explorer/address/transaction-list?chainShortName=btc&address=90817bf1d289eb347b6b9b8818db02cb833cbe73efec940fa99852035a665e39

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
address	String	是	地址
startBlockHeight	String	否	开始区块高度
endBlockHeight	String	否	最终区块高度
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": 0,
    "msg": "",
    "detailMsg": "",
    "data": {
         "page": "1",
        "limit": "1",
        "totalPage": "8",
        "transactionList": [
            {
                "symbol": "COSMOS",
                "txId": "60F1DD062BCA7A9E84A57B2DAE61F3F1832CFE9763ECC06DE3E023926344D64E",
                "blockHash": "5EB30717D4EB445DAC960AAC0F22A5970A567D12E728E3791ECD0582C9F7C006",
                "height": "16618150",
                "transactionTime": "1692337365",
                "from": [
                    "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8"
                ],
                "to": [
                    "cosmos12xchmahded3q5l667u9quevem9qrtp5tafs87j"
                ],
                "txFee": "0.002388",
                "gasLimit": "95488",
                "gasUsed": "85465",
                "type": [
                    "cosmos.bank.v1beta1.MsgSend"
                ],
                "value": "14414",
                "state": "0"
            }
        ]
    }
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
transactionList	Array	交易列表
> txId	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间
> from	Array	发送方地址
> to	Array	接收方地址
> symbol	String	交易数量对应的币种
> gasLimit	String	gas限额
> gasUsed	String	gas消耗
> txFee	String	手续费
> state	String	交易状态
> value	String	数量

矿工数据模块

矿工数据模块功能模块的接口，可获取公链矿池的算力排名、超级节点、验证人列表、矿池份额

获取各个矿池所占的预估份额。

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/pool/estimated-pool-share

请求示例

GET /api/v5/explorer/pool/estimated-pool-share?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
period	String	是	筛选日期 `1D`；`3D`；`1W`；`1M`；`3M`；`1Y`；`All` 默认为`1D`

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "rank": "1",
            "poolName": "ethermine",
            "hashrate": "255.13",
            "ratio": "0.2833",
            "blockCount": "1780",
            "emptyBlockCount": "142",
            "ommerBlockCount": "66",
            "avgBlockSize": "",
            "avgFee": "0.0000000009380955983377118",
            "minerFeeRatio": "0.0469"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
rank	String	爆块数量排名
poolName	String	矿池名称
poolWebsite	String	矿池网站地址
hashrate	String	算力
ratio	String	爆块份额占比，以小数展示，精确到小数点后4位
blockCount	String	区块数量
emptyBlockCount	String	空块数量
ommerBlockCount	String	叔块数量
avgBlockSize	String	平均区块大小，单位为：Bytes
avgFee	String	平均交易手续费
minerFeeRatio	String	矿工费占比，以小数展示，精确到小数点后4位

查询查询矿池算力排名

获取某个公链矿池算力排名

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/pool/pool-hashrate-rank

请求示例

GET /api/v5/explorer/pool/pool-hashrate-rank?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
category	String	否	数据类别 `real`：实时数据 `estimated`：预估数据默认为 `real`

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "rank": "1",
            "poolName": "ethermine",
            "hashrate": "257201499275264",
            "change24h": "-0.0013",
            "luckyRatio": "0.9713"
        },
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "rank": "2",
            "poolName": "F2Pool",
            "hashrate": "137947520549519.375",
            "change24h": "0.0183",
            "luckyRatio": "0.9784"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Ethereum`
chainShortName	String	公链缩写符号，例如：`ETH`
rank	String	算力排名
poolName	String	矿池名称
hashrate	String	算力
change24h	String	算力24小时涨跌幅，以小数展示，精确到小数点后4位
luckyRatio	String	幸运比值，以小数展示，精确到小数点后4位

查询超级节点/验证人列表

获取OKLink目前所支持的公链的超级节点或者验证人列表，适用于OKC、BSC等质押挖矿的链。

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/pool/validator-list

请求示例

GET /api/v5/explorer/pool/validator-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`BTC`、`ETH`
period	period	否	筛选日期： `1D`；`1W`；`3M`；`1Y`；`All` 默认为`1D`
validatorName	String	否	验证者名称
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
        {
            "page":"1",
            "limit":"20",
            "totalPage":"670",
            "validatorList":[
                    {
                        "rank":"1",
                        "validatorName":"victor1",
                        "validatorAddress":"dsfsdfsd",
                        "weightRatio":"0.02",
                        "weight":"115",
                        "blocks":"116",
                        "staked":"1141",
                        "stakedSymbol":"OKT",
                        "reward":"113",
                        "rewardSymbol":"OKT",
                        "state":"1",
                        "firstHeight":""
                        "latestHeight":""
                    }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
validatorList	Array	验证者列表
rank	String	排名
validatorName	String	验证者名称
validatorAddress	String	验证者地址
weightRatio	String	权重占比
weight	String	权重
blocks	String	出块的个数
staked	String	质押数量（预估值）
stakedSymbol	String	质押的代币名称
reward	String	奖励
rewardSymbol	String	奖励的代币名称
state	String	验证者状态
firstHeight	String	第一个块高
latestHeight	String	最后一个块高

交易数据模块

交易数据模块功能模块的接口，可获取某个链的交易信息，交易列表。

查询大额交易列表

获取OKLink目前所支持的公链上的大额交易列表。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/transaction/large-transaction-list

请求示例

GET /api/v5/explorer/transaction/large-transaction-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
type	String	否	大额交易的枚举： BTC：500；1000；2000 ETH：1000；2000；5000 USDT：100000；500000；1000000 ETC：1000；10000；50000 BCH：1000；2000；5000 LTC：1000；2000；5000 DASH：1000；2000；5000 BSC：1000；2000；5000 AVAX：1000；2000；5000
blockHash	String	否	区块哈希
height	String	否	区块高度
limit	String	否	每一页返回的条数，默认返回最近的20条，，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "302633",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "transactionList": [
                {
                    "txid": "0xb0571e34a3a3ff1b605fdbb8f966574a6e4d597fa4f52deda998198fb1cbac36",
                    "blockHash": "0x9ce83b3ed962bc9ad2f9d7be361fbc1c9426389aa226ea1f46e26db7b8b5d257",
                    "height": "17193279",
                    "transactionTime": "1683275735000",
                    "input": "0xd2b954a0635096ddaadd7ff1d5a182198f02fcae",
                    "output": "0x4dbd4fc535ac27206064b68ffcf827b0a60bab3f",
                    "isInputContract": false,
                    "isOutputContract": true,
                    "amount": "1000",
                    "transactionSymbol": "ETH",
                    "txfee": "0.007340732607387121",
                    "methodId": "0x439370b1",
                    "transactionType": "2",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
transactionList	Array	交易列表
> txid	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 `1597026383085`
> input	String	输入，例如，如果存在多个地址，以英文逗号分隔
> output	String	输出，例如，如果存在多个地址，以英文逗号分隔
> isInputContract	Bol	input地址是否是合约地址
> isOutputContract	Bol	output地址是否是合约地址
> amount	String	数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> methodId	String	方法
> transactionType	String	交易类型 `0`：原始交易类型 `1`:EIP2930 `2`:EIP1559
> state	String	交易状态 `success` 成功 `fail` 失败 `pending` 等待确认

查询交易明细

获取OKLink目前所支持的公链链上交易础信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/transaction/transaction-fills

请求示例

GET /api/v5/explorer/transaction/transaction-fills?chainShortName=eth&txid=0x3ae59abf714df29a15bb8ecadfbe3068aff20693bb91c7e7c9d34ce245d56def

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，请求`/api/v5/explorer/blockchain/summary`接口查询OKLink已支持的公链
txid	String	是	交易hash ，最多可批量查询20笔交易，以英文逗号分隔。

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "txid": "0x3ae59abf714df29a15bb8ecadfbe3068aff20693bb91c7e7c9d34ce245d56def",
            "height": "18126676",
            "transactionTime": "1694599499000",
            "amount": "0.1",
            "transactionSymbol": "ETH",
            "txfee": "0.000491371954353",
            "index": "576",
            "confirm": "1",
            "inputDetails": [
                {
                    "inputHash": "0xe61771cd810d82e6ef302f69c76fbaf0538818c7",
                    "isContract": false,
                    "amount": ""
                }
            ],
            "outputDetails": [
                {
                    "outputHash": "0x095624a01088cca5aae036c128cc9ac8032b9a3c",
                    "isContract": false,
                    "amount": ""
                }
            ],
            "state": "success",
            "gasLimit": "21000",
            "gasUsed": "21000",
            "gasPrice": "0.000000023398664493",
            "totalTransactionSize": "",
            "virtualSize": "0",
            "weight": "",
            "nonce": "1365",
            "transactionType": "2",
            "methodId": "",
            "errorLog": "",
            "inputData": "0x",
            "isAaTransaction": false,
            "tokenTransferDetails": [],
            "contractDetails": []
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
txid	String	交易哈希
height	String	交易发生的区块
transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 1597026383085
transactionType	String	交易类型 `0`：原始交易类型 `1`:EIP2930 `2`:EIP1559
amount	String	交易数量
transactionSymbol	String	交易数量对应的币种
methodId	String	方法
errorLog	String	交易失败日志
inputData	String	输入数据
txfee	String	手续费
index	String	交易在区块里的位置索引
confirm	String	确认数
inputDetails	Array	输入地址列表
> inputHash	String	发起交易的hash地址
> isContract	Bol	发起交易的地址是否是合约地址 true:是；false：否
> amount	String	该地址的交易数量
outputDetails	Array	输出地址列表
> outputHash	String	接收交易的hash地址
> isContract	Bol	接收交易的地址是否是合约地址 true:是；false：否
> amount	String	该地址的交易数量
state	String	交易状态 `success`:成功 `fail`:失败 `pending`:等待确认
gasLimit	String	gas限额
gasUsed	String	gas消耗
gasPrice	String	gas价格
totalTransactionSize	String	总交易大小
virtualSize	String	虚拟交易大小
weight	String	交易重量
nonce	String	发起者地址发起的第几笔交易
tokenTransferDetails	Array	代币转账明细
> index	String	该交易在区块里的位置索引
> token	String	代币名称
> tokenContractAddress	String	代币合约地址
> symbol	String	代币符号
> from	String	转出代币地址
> to	String	接收代币地址
> isFromContract	Bol	转出代币地址是否是合约地址
> isToContract	Bol	接收代币地址是否是合约地址
> tokenId	String	NFT的ID
> amount	String	转账数量
contractDetails	Array	合约调用转账明细
> index	String	该交易在区块里的位置索引
> from	String	转出代币地址
> to	String	接收代币地址
> isFromContract	Bol	转出代币地址是否是合约地址
> isToContract	Bol	接收代币地址是否是合约地址
> amount	String	转账数量
> gasLimit	String	gas限额

查询交易列表信息

获取OKLink目前所支持的公链的交易列表，仅返回近1万条交易数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/transaction/transaction-list

请求示例

GET /api/v5/explorer/transaction/transaction-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
blockHash	String	否	区块哈希
height	String	否	区块高度
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "2",
            "totalPage": "851810053",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "transactionList": [
                {
                    "txid": "0x6dbabdd5715160bc2b3d36c7368162212ce744c5ae5dac6d81c96759fea37ab8",
                    "blockHash": "0xfdc697f5742b6c31587e18ccd63fe5b9f88ff6aeaa07be8982621c8cbd3aecf0",
                    "height": "15496493",
                    "transactionTime": "1662639200000",
                    "input": "0x69073bfe324df3195cfb332b845b985a56db5491",
                    "output": "0x9cccb6a6d1f65ded19c283e2282110bc4f628869",
                    "amount": "0.04",
                    "transactionSymbol": "ETH",
                    "txfee": "0.002343825046064032",
                    "methodId": "0xf6fd63d4",
                    "transactionType": "2",
                    "state": "success"
                },
                {
                    "txid": "0xf986db8c5eef071ead272a128920c60a71e1029ed2b71c0e58e78e733dbab0ea",
                    "blockHash": "0xfdc697f5742b6c31587e18ccd63fe5b9f88ff6aeaa07be8982621c8cbd3aecf0",
                    "height": "15496493",
                    "transactionTime": "1662639200000",
                    "input": "0xb8de37b107e87c7584114773f0e79a2b6d74eb8c",
                    "output": "0x9cccb6a6d1f65ded19c283e2282110bc4f628869",
                    "amount": "0.02",
                    "transactionSymbol": "ETH",
                    "txfee": "0.001705818112657196",
                    "methodId": "0xa0712d68",
                    "transactionType": "2",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
transactionList	Array	交易列表
> txid	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 `1597026383085`
> input	String	输入地址，如果存在多个地址，以英文逗号分隔
> output	String	输出地址，如果存在多个地址，以英文逗号分隔
> isFromContract	Bol	input地址是否是合约地址
> isToContract	Bol	output地址是否是合约地址
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> methodId	String	方法
> transactionType	String	交易类型 `0`：原始交易类型 `1`:EIP2930 `2`:EIP1559
> state	String	交易状态 `success` 成功 `fail` 失败 `pending`` 等待确认
> tokenContractAddress	String	代币合约地址

查询未确认交易列表

获取OKLink目前所支持的公链上的未确认交易列表信息，仅返回近1万条交易数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/transaction/unconfirmed-transaction-list

请求示例

GET /api/v5/explorer/transaction/unconfirmed-transaction-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "0",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "transactionList": [
                {
                    "txid": "f624a8a720607c2d745f854345c87654f93a69e36cba33f9c26c0afb89479166",
                    "height": "",
                    "transactionTime": "",
                    "input": "1297zniMJbZE8pN9nhjaMaAVVDMzZV5Gec",
                    "output": "1EkLo9rqzGPAWxxrxzwhhkHvHCcZBBXBX2,3HEZCGyjEFPXZ5RYJsoPzAEv4KcFJLLtqv",
                    "isInputContract": false,
                    "isOutputContract": false,
                    "amount": "0.30555427",
                    "transactionSymbol": "BTC",
                    "txfee": "24728",
                    "methodId": "",
                    "transactionType": "",
                    "randomNumber": "",
                    "status": "pending"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
transactionList	Array	交易列表
> txid	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 `1597026383085`
> isInputContract	Bol	input地址是否是合约地址
> isOutputContract	Bol	output地址是否是合约地址
> input	String	输入，例如，如果存在多个地址，以英文逗号分隔
> output	String	输出，例如，如果存在多个地址，以英文逗号分隔
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> methodId	String	方法
> transactionType	String	交易类型 `0`：原始交易类型 `1`:EIP2930 `2`:EIP1559
> randomNumber	String	随机数
> state	String	交易状态 `success` 成功 `fail` 失败 `pending` 等待确认

解析交易

给定打包好的交易签名，反向解析出交易明细，仅支持BCH、BTC、DASH、LTC。

每次调用消耗 5 点

HTTP请求

POST /api/v5/explorer/transaction/decode

请求示例

POST /api/v5/explorer/transaction/decode
body
{
    "chainShortName":"eth",
    "signedTx":"12232323"
}

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
signedTx	String	是	打包好的交易签名

返回结果

{
    "code":0,
    "msg":"",
    "data":[
        {
            "txid":"81c8447bf780dacedf67c45908aafcde43c78ae108b3a06a278362ad306f7239",
            "version":"1",
            "size":"224",
            "vsize":"224",
            "weight":"896",
            "locktime":"0",
            "input":[
                {
                    "txid":"2555fe195e9de0a4725c9b76008e93bfb47d7a844309853a27a66a092ecf457c",
                    "index":"1",
                    "sign":{
                        "asm":"12313[ALL]",
                        "hex":"12313"
                    },
                    "sequence":"4294967295"
                }
            ],
            "output":[
                {
                    "amount":"0.00271",
                    "index":"0",
                    "publicKey":{
                        "asm":"OP_HASH160 7cfcfaae9ec7c505538c7bbfe23d6b3c9d7e0e0e OP_EQUAL",
                        "hex":"a9147cfcfaae9ec7c505538c7bbfe23d6b3c9d7e0e0e87",
                        "reqSigs":"1",
                        "type":"scripthash",
                        "address":[
                            "3D5tmdpJe2tdNmosuLGNwMT9bcym34K3LT",
                            "3D5tmdpJe2tdNmosuLGNwMT9bcym34K3LT"
                        ]
                    }
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
txid	String	交易哈希
version	String	版本
transactionSize	String	交易大小
virtualSize	String	虚拟交易大小
weight	String	交易重量
transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 1597026383085
inputDetails	Array	输入明细
> txid	String	utxo生成交易hash
> index	String	交易位置索引
> sequence	String	序列号
>sign	Obj	签名信息
>> asm	String	输入脚本
>> hex	String	输入脚本原始数据
outputDetails	Array	输出明细
> amount	String	交易数量
> index	String	交易位置索引
>publicKey	Obj	公钥信息
>> asm	String	输入脚本
>> hex	String	输入脚本原始数据
>> reqSigs	String	所需签名次数
>> asmType	String	签名类型
>> address	Array	该笔交易到账地址（to）

查询内部交易

通过交易哈希获取内部交易

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/transaction/internal-transaction-detail

请求示例

GET /api/v5/explorer/transaction/internal-transaction-detail?chainShortName=eth&txId=0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc&limit=1

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
txId	String	是	交易Hash
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10",
            "internalTransactionDetails": [
                {
                    "txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
                    "from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
                    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "height": "18076803",
                    "transactionTime": "1693995971000",
                    "isFromContract": true,
                    "isToContract": true,
                    "operation": "call",
                    "amount": "0.002",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
internalTransactionDetails	Array	内部交易详情
> txId	String	交易哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式
> from	String	交易发送方的地址
> to	String	交易接受方的地址
> isFromContract	Bol	from地址是否是合约地址
> isToContract	Bol	to地址是否是合约地址
> amount	String	交易数量
> state	String	交易状态

查询代币交易

通过交易哈希获取代币交易

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/transaction/token-transaction-detail

请求示例

GET /api/v5/explorer/transaction/token-transaction-detail?chainShortName=eth&txId=0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc&limit=1

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
txId	String	是	交易Hash
protocolType	String	否	不同类型的交易
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "2",
            "tokenTransferDetails": [
                {
                    "txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
                    "from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
                    "to": "0xf66369997ae562bc9eec2ab9541581252f9ca383",
                    "height": "18076803",
                    "transactionTime": "1693995971000",
                    "isFromContract": true,
                    "isToContract": true,
                    "tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "symbol": "WETH",
                    "amount": "0.002"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenTransferDetails	Array	代币交易详情
> txId	String	交易哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式
> from	String	交易发送方的地址
> to	String	交易接受方的地址
> isFromContract	Bol	from地址是否是合约地址
> isToContract	Bol	to地址是否是合约地址
> tokenContractAddress	String	代币合约地址
> amount	String	交易数量
> tokenId	String	NFT 的ID

代币数据模块

代币数据模块功能模块接口，可以获取一条链上所有的token列表和token详情

批量查询代币价格

可以批量查询最多100个代币的价格，价格经过多个CEX和DEX的价格的综合计算

每次请求消耗 `20` 次调用量

HTTP请求

GET /api/v5/explorer/tokenprice/price-multi

请求示例

GET /api/v5/explorer/token/token-list?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2,0x8d983cb9388eac77af0474fa441c4815500cb7bb

请求参数

参数名	类型	必须	描述
chainId	String	否	公链的唯一标识 chainId和chainShortName必须两者选其一
chainShortName	String	否	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询 chainId和chainShortName必须两者选其一
tokenContractAddress	String	是	代币的合约地址，最多可以输入100个地址，以`,`分割

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "lastPrice": "7.787",
            "tokenContractAddress": "0x8d983cb9388eac77af0474fa441c4815500cb7bb"
        },
        {
            "lastPrice": "1109.360929491998430075",
            "tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"
        }
    ]
}

返回参数

参数名	类型	描述
lastPrice	String	代币的最新价格，价格每1分钟更新1次
tokenContractAddress	String	代币的合约地址

查询代币列表信息

获取某个代币的基本信息

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/token/token-list

请求示例

GET /api/v5/explorer/token/token-list?chainShortName=btc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
protocolType	String	否	合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155 10代币：token_10 默认是token_20
tokenContractAddress	String	否	代币合约地址
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "3373",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "tokenList": [
                {
                    "tokenFullName": "Tether USD",
                    "token": "USDT",
                    "precision": "6",
                    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                    "protocolType": "ERC20",
                    "addressCount": "4426285",
                    "totalSupply": "69156782826.546173095703125",
                    "circulatingSupply": "67545704102.99471282958984375",
                    "price": "0.9884886816000000298032546197646297514438629150390625",
                    "website": "https://tether.to/",
                    "totalMarketCap": "66792795650.9627685546875"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
tokenList	Array	代币列表
> tokenFullName	String	代币名字全称：`USDCoin`
> token	String	代币名字简称：`USDC`
> precision	String	精度
> tokenContractAddress	String	代币合约地址
> protocolType	String	代币合约协议类型
> addressCount	String	持币地址数
> totalSupply	String	最大供应量
> circulatingSupply	String	流通量
> price	String	价格，`USD`为单位
> website	String	官方网站
> totalMarketCap	String	总市值
> issueDate	String	代币发行日期

查询代币持仓列表详情

获取某个公链下某个代币的持仓列表，仅返回余额为top10000的地址

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/token/position-list

请求示例

GET /api/v5/explorer/token/position-list?chainShortName=eth&tokenContractAddress=0x495f947276749ce646f68ac8c248420045cb7b5e

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
tokenContractAddress	String	是	代币合约地址
holderAddress	String	否	持仓地址
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "circulatingSupply": "",
            "positionList": [
                {
                    "holderAddress": "0x000000000000000000000000000000000000dead",
                    "amount": "1109086030527",
                    "valueUsd": "",
                    "positionChange24h": "",
                    "rank": "1"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
circulatingSupply	String	总流通量
positionList	Array	交易列表
> holderAddress	String	持仓地址
> amount	String	持仓数量
> valueUsd	String	持仓价值，以美金为单位
> positionChange24h	String	24小时持仓量变化
> rank	String	持仓量排名

查询代币转帐详情

获取指定链的指定代币转账详情

HTTP请求

GET /api/v5/explorer/token/transaction-list

请求示例

GET /api/v5/explorer/token/transaction-list?chainShortName=eth&tokenContractAddress=0x495f947276749ce646f68ac8c248420045cb7b5e

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
tokenContractAddress	String	是	代币合约地址
maxAmount	String	否	筛选交易数量区间，最大数量
minAmount	String	否	筛选交易数量区间，最小数量
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "2",
            "totalPage": "5000",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "totalTransfer": "176187963",
            "transactionList": [
                {
                    "txid": "0xad3076e840f66a1ec557f9be5f37ca3d3f78ffc807c5978b4cd4531b017cabff",
                    "blockHash": "0x0992b24760a1c5a913bd5d29f3ab2b0b059bf15df6487e9d61987a05c85fe7d0",
                    "height": "17193345",
                    "transactionTime": "1683276539000",
                    "from": "0x024dff8673dd26dd20e5f60b19244ba74925cd68",
                    "to": "0x74de5d4fcbf63e00296fd95d33236b9794016631",
                    "isToContract": true,
                    "isFromContract": false,
                    "amount": "100",
                    "transactionSymbol": "USDT",
                    "methodId": "0x5f575529",
                    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                    "protocolType": "ERC20",
                    "state": "success",
                    "tokenId": ""
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Bitcoin`
chainShortName	String	公链缩写符号，例如：`BTC`
totalTransfer	String	代币总转账次数
transactionList	Array	交易列表
> txid	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易时间；Unix时间戳的毫秒数格式，如 `1597026383085`
> to	String	接收方，多个地址，逗号分隔
> from	String	发送方，多个地址，逗号分隔
> isFromContract	Bol	input地址是否是合约地址
> isToContract	Bol	output地址是否是合约地址
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> methodId	String	方法
> tokenContractAddress	String	代币合约地址
> protocolType	String	代币协议类型
> state	String	交易状态成功:`success` 失败:`fail` 等待确认:`pending`
> tokenId	String	代币ID，适用于721和1155代币

批量查询代币交易

批量查询最多20合约的代币交易，最多查询10000个区块

每次请求消耗 `5` 次调用量

HTTP请求

GET /api/v5/explorer/token/token-transaction-list-multi

请求示例

GET /api/v5/explorer/token/token-transaction-list-multi?chainShortName=eth&endBlockHeight=17925814&startBlockHeight=17916100&limit=1&tokenContractAddress=0x524cab2ec69124574082676e6f654a18df49a048,0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d,0xed5af388653567af2f388e6224dc7c4b3241c544

请求参数

参数名	类型	必须	描述
chainShortName	String	是	公链缩写符号，例如：`btc`、`eth`，可通过 `GET /api/v5/explorer/blockchain/summary`查询
tokenContractAddress	String	是	代币的合约地址，最多可以输入20个地址，以`,`分割
startBlockHeight	String	是	开始搜索的区块号
endBlockHeight	String	是	结束搜索的区块号
page	String	否	页码
limit	String	否	每页返回的数据条数，默认最小20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "575",
            "transactionList": [
                {
                    "txId": "0xe4734cac4c64f1ecf81c34e9cd85b62a2a4a98c1725551747f648f0d0eb9b6cb",
                    "blockHash": "0x679d0c17496a26daf0db04a815f262d6b76e71875592ac267f7dec40392fd49f",
                    "height": "17925771",
                    "transactionTime": "1692169307000",
                    "from": "0x84874a7b71c302707fad5dd386743c5836445794",
                    "to": "0x495fe5bb98d9571b2cd5d8db172636c6cec6ba79",
                    "isFromContract": false,
                    "isToContract": false,
                    "amount": "1",
                    "tokenId": "5082",
                    "symbol": "BAYC",
                    "tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	页码
limit	String	每页返回的数据条数，默认最小20条，最多100条
totalPage	String	总共的页数
transactionList	Array	交易列表
> txId	String	交易哈希
> blockHash	String	区块哈希
> height	String	交易发生的区块高度
> transactionTime	String	交易发生的时间；Unix时间戳的毫秒数格式，如`1597026383085`
> from	String	交易发送方的地址，多个地址，以`,`分隔
> to	String	交易接受方的地址，多个地址，以`,`分隔
> isFromContract	Bol	from地址是否是合约地址
> isToContract	Bol	to地址是否是合约地址
> amount	String	代币数量
> tokenId	String	代币ID，适用于721和1155代币
> symbol	String	交易代币的符号
> tokenContractAddress	String	交易代币的合约地址

稳定币数据模块

稳定币数据模块功能模块的接口，可获取USDT发行和销毁记录

查询USDT印钞/销毁记录

获取USDT在TRX、BTC、ETH公链网络上的印钞记录

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/stablecoin/printing-record

请求示例

GET /api/v5/explorer/stablecoin/printing-record?stablecoinName=USDT&network=TRX&type=printing

请求参数

参数名	类型	是否必须	描述
stablecoinName	String	是	稳定币名称
network	String	是	区块链网络 all：全部 TRX：TRX网络 ETH：ETH网络 BTC：BTC网络 USDT：Omni网络
type	String	是	类型 `printing`：发行 `destruction`：销毁
limit	String	否	每一页返回的条数，默认返回最近的20条，，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "454",
            "recordList": [
                {
                    "stablecoinName": "USDT",
                    "txid": "25a55b38cf113011f285cc9a28466323e10266a5ca0a2635579af2975079a523",
                    "network": "TRX",
                    "height": "42984567",
                    "amount": "1000000000",
                    "sendAddress": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
                    "receiveAddress": "TBPxhVAsuzoFnKyXtc1o2UySEydPHgATto",
                    "transactionTime": "1659529347000"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
recordList	String	销毁/发行列表
> stablecoinName	String	稳定币名称
> txid	String	交易哈希
> network	String	所在网络
> height	String	交易发生的区块
> amount	String	数量
> sendAddress	String	发送地址
> receiveAddress	String	接收地址
> transactionTime	String	交易时间

POR数据模块

POR数据模块功能模块接口，提供公开、透明的中心化交易所链上资产概览信息，为用户披露各交易所的链上储备金。

获取交易所储备金

通过该接口获取中心化交易所最新的储备金数据

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/por/proof-of-reserves

请求示例

GET /api/v5/explorer/por/proof-of-reserves

请求参数

参数名	类型	是否必须	描述
institutionName	String	否	中心化机构名称

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "institutionName": "OKX",
            "totalBalance": "6502554504.391312",
            "balanceDetails": [
                {
                    "symbol": "ETH",
                    "balance": "1077119.4731584482",
                    "balanceUsd": "1354434652.7178226",
                    "change": "1"
                },
                {
                    "symbol": "USDT",
                    "balance": "3006224032.2949777",
                    "balanceUsd": "3006930041.122987",
                    "change": "1"
                },
                {
                    "symbol": "BTC",
                    "balance": "102951",
                    "balanceUsd": "1745781287.4",
                    "change": "1"
                },
                {
                    "symbol": "USDC",
                    "balance": "395343687.173071",
                    "balanceUsd": "395391628.917477",
                    "change": "1"
                },
                {
                    "symbol": "BUSD",
                    "balance": "16889.72009695",
                    "balanceUsd": "16894.233026629954",
                    "change": "1"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
institutionName	String	实体名称
totalBalance	String	交易所资产总额，以USDT为单位
balanceDetails	Array	资产明细列表
> symbol	String	代币
> balance	String	代币余额
> change	String	最近7天资金变动涨跌幅，0.1表示10%
> balanceUsd	String	折算成USDT后的金额

获取交易所历史储备金

获取交易所历史储备金记录

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/por/institution-history-asset

请求示例

GET /api/v5/explorer/por/institution-history-asset

请求参数

参数名	类型	是否必须	描述
institutionName	String	是	中心化机构名称
time	String	否	时间，必须填写utc格式0点0分时间。例如：1670601600000

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "institutionName": "Huobi",
            "balanceList": [
                {
                    "chainShortName": "ETH",
                    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                    "symbol": "USDT",
                    "balance": "583066271.058834",
                    "balanceUsd": "583066271.058834",
                    "time": "1670601600000"
                },
                {
                    "chainShortName": "ETH",
                    "tokenContractAddress": "0xb8c77482e45f1f44de1745f52c74426c631bdd52",
                    "symbol": "BNB",
                    "balance": "0.3",
                    "balanceUsd": "86.51097014666489",
                    "time": "1670601600000"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
institutionName	String	实体名称
balanceList	Array	资产列表
> chainShortName	String	公链缩写符号
> tokenContractAddress	String	代币合约地址
> symbol	String	代币名称
> balance	String	代币余额
> balanceUsd	String	代币余额（usd）单位
> time	String	数据更新时间

获取资产详情

查询特定交易所的资金量排名前50的地址的资产详情

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/por/address-balance-details

请求示例

GET /api/v5/explorer/por/address-balance-details

请求参数

参数名	类型	是否必须	描述
institutionName	String	是	中心化机构名称
page	String	否	页码
limit	String	否	返回的数据个数，默认10条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "2",
            "totalPage": "25",
            "addressDetails": [
                {
                    "balance": "11996000000",
                    "balanceUsd": "11993351024.770172",
                    "chainShortName": "ETH",
                    "symbol": "BUSD",
                    "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
                    "updateTime": "1670918400000"
                },
                {
                    "balance": "7000000108.553991",
                    "balanceUsd": "7002773135.076995",
                    "chainShortName": "TRON",
                    "symbol": "USDT",
                    "address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
                    "updateTime": "1670918400000"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
addressDetails	Array	地址
> chainShortName	String	公链缩写符号
> symbol	String	代币
> balance	String	代币余额
> balanceUsd	String	代币余额（usd）单位
> address	String	地址
> updateTime	String	数据更新时间

ETH通缩数据模块

ETH通缩数据模块功能模块接口，提供ETH每日对供应与销毁的详情数据，以及ETH质押详情。

获取ETH通缩概览

查询ETH最新的通缩数据概览

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/deflation/supply

请求示例

GET /api/v5/explorer/deflation/supply

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "circulatingSupply": "120499366.7689",
            "totalBurnt": "2911344.1373",
            "inflationRate": "-0.0141",
            "stakingAmount": "16653847.1254",
            "stakingApy": "0.0394"
        }
    ]
}

返回参数

参数名	类型	描述
circulatingSupply	String	ETH总流通量
totalBurnt	String	ETH总毁量量
stakingApy	String	ETH质押年华收益率
stakingAmount	String	ETH总质押数量
inflationRate	String	ETH当前年化通胀率，以小数展示，示例：0.1=10%

获取ETH质押详情

获取ETH质押历史详情

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/deflation/pos-staking

请求示例

GET /api/v5/explorer/deflation/pos-staking

请求参数

参数名	类型	是否必须	描述
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "28",
            "stakingHistoryList": [
                {
                    "time": "1676390400000",
                    "totalValidator": "519845",
                    "totalStaked": "16653847.1254",
                    "stakingRatio": "0.1394",
                    "validatorDailyIncome": "1801.91",
                    "apy": "0.0394",
                    "nonEip1559Fee": "138.7061",
                    "baseRewards": "6481.8607",
                    "priorityFee": "588.993"
                }
                    ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
stakingHistoryList	Array	质押列表
> apy	String	年化收益率
> baseRewards	String	基础奖励
> priorityFee	String	交易小费
> totalStaked	String	质押率
> nonEip1559Fee	String	非eip1559交易手续费
> totalValidator	String	总验证者数量
> validatorDailyIncome	String	验证者每日收入（基础奖励）
> time	String	数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085

获取ETH通缩详情

通过该接口ETH每日的供应量和销毁量的历史数据。

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/deflation/supply-burn

请求示例

GET /api/v5/explorer/deflation/supply-burn

请求参数

参数名	类型	是否必须	描述
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
               {
            "page": "2",
            "limit": "20",
            "totalPage": "28",
            "inflationHistoryList": [
                {
                    "supply": "1790.6",
                    "burnt": "2158.7776",
                    "netInflation": "-368.1776",
                    "circulatingSupply": "120517711.781",
                    "inflationRate": "-0.0011",
                    "time": "1674662400000"
                }
    ]
}
 ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
inflationHistoryList	Array	通缩数据列表
> circulatingSupply	String	Eth总流通量
> burnt	String	每日销毁量
> netInflation	String	每日净新增ETH数量，正数表示表示新增数量，负数表示减少数量。
> supply	String	每日供应量
> inflationRate	String	通胀率
> time	String	数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085

获取ETH的gas历史

通过该接口获取ETH的历史gas数据

每次调用消耗 5 点

HTTP请求

GET /api/v5/explorer/deflation/gas

请求示例

GET /api/v5/explorer/deflation/gas

请求参数

参数名	类型	是否必须	描述
limit	String	否	每一页返回的条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "28",
            "gasHistoryList": [
                {
                    "nonEip1559Fee": "138.7061",
                    "eip1559BaseFee": "6481.8607",
                    "eip1559Tip": "588.993",
                    "totalTransactionCount": "1191785",
                    "maxGasPrice": "814.2265",
                    "minGasPrice": "19.03",
                    "avgGasPrice": "62.0559",
                    "time": "1676390400000"
                }
    ]
}
 ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
gasHistoryList	Array	gas 历史数据
> avgGasPrice	String	当天平均gas费
> maxGasPrice	String	当天最大值gas费
> minGasPrice	String	当天最小值gas费
> eip1559BaseFee	String	eip1559基础手续费
> eip1559Tip	String	eip1559小费
> totalTransactionCount	String	当天总交易次数
> nonEip1559Fee	String	非eip1559交易手续费
> time	String	数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085

BRC20数据模块

BRC20数据模块支持BRC20代币余额查询，转账列表查询、代币详情信息、持币地址列表等查询服务，数据实时更新，为用户提供最全面，最实时的BRC20链上数据查询服务。

查询inscriptions列表

获取BTC链的 inscriptions 列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/inscriptions-list

请求示例

GET /api/v5/explorer/btc/inscriptions-list

请求参数

参数名	类型	是否必须	描述
token	String	否	代币名称,等于 tick
inscriptionId	String	否	inscription ID
inscriptionNumber	String	否	铭文编号
state	String	否	铭文状态:success、fail，默认返回success
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10000",
            "totalInscription": "5146426",
            "inscriptionsList": [
                {
                    "inscriptionId": "9e54767636589dd70af60b2074d23c1689b68f6a5d8036f9dddaa2bc31a0b5ffi0",
                    "inscriptionNumber": "999922",
                    "location": "9e54767636589dd70af60b2074d23c1689b68f6a5d8036f9dddaa2bc31a0b5ff:0:0",
                    "token": "",
                    "state": "fail",
                    "msg": "amount exceed limit: 1000000000000000000000",
                    "tokenType": "BRC20",
                    "actionType": "mint",
                    "logoUrl": "",
                    "ownerAddress": "bc1pupvkqkxe2wnxg2ytf7twr07pychh8htx0cy5w439yyzzgdu2pzqsukzqwd",
                    "txId": "9e54767636589dd70af60b2074d23c1689b68f6a5d8036f9dddaa2bc31a0b5ff",
                    "blockHeight": "784528",
                    "contentSize": "",
                    "time": "1680975864000"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
totalInscription	String	Inscription 总量
inscriptionsList	Array	inscriptions列表
> inscriptionId	String	铭文的ID
> inscriptionNumber	String	铭文编号
> location	String	Location，格式为：txid:vout:offset
> token	String	代币名称，tick
> state	String	铭文状态:success、fail
> tokenType	String	铭文的类型 BRC20
> actionType	String	交易类型：deploy、mint、inscribeTransfer、transfer
> logoUrl	String	铭文的logo URL
> ownerAddress	String	铭文的所有者地址
> txId	String	与铭文相关的最新交易hash
> blockHeight	String	与铭文相关的最新交易区块高度
> contentSize	String	储存信息所占的大小,单位：Bytes
> time	String	铭文创建时间需要改为交易时间

查询BRC20代币列表

获取BTC链的BRC20代币列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/token-list

请求示例

GET /api/v5/explorer/btc/token-list

请求参数

参数名	类型	是否必须	描述
token	String	否	代币名称,等于 tick
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10000",
            "tokenList": [
                {
                    "token": "ordi",
                    "deployTime": "1678248991000",
                    "inscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
                    "inscriptionNumber": "348020",
                    "totalSupply": "21000000",
                    "mintAmount": "21000000",
                    "transactionCount": "119202",
                    "holder": "10498",
                    "mintRate": "1"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenList	Array	Token List
> token	String	代币名称，等于tick
> deployTime	String	deploy时间
> inscriptionId	String	铭文的ID
> inscriptionNumber	String	铭文编号
> totalSupply	String	总量
> mintAmount	String	已经铸造数量
> transactionCount	String	总交易次数
> holder	String	持有代币地址数
> mintRate	String	mint 比例，以小数展示，例如：0.9543 ；保留小数点后四位。

获取代币详细信息

获取代币详细信息，包括持有人地址数、已mint数量等。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/token-details

请求示例

GET /api/v5/explorer/btc/token-details?token=sats

请求参数

参数名	类型	是否必须	描述
token	String	是	代币名称，等于tick

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "token": "sats",
            "precision": "18",
            "totalSupply": "2100000000000000",
            "mintAmount": "30658561856757.1",
            "limitPerMint": "100000000",
            "holder": "8354",
            "deployAddress": "bc1prtawdt82wfgrujx6d0heu0smxt4yykq440t447wan88csf3mc7csm3ulcn",
            "logoUrl": "",
            "txId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333",
            "inscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
            "deployHeight": "779971",
            "deployTime": "1678339934000",
            "inscriptionNumber": "357097",
            "state": "success",
            "tokenType": "BRC20",
            "msg": ""
        }
    ]
}

返回参数

参数名	类型	描述
token	String	代币名称，等于tick
precision	String	数量的精度位
totalSupply	String	总铸造数量
mintAmount	String	已经铸造数量
limitPerMint	String	每次最大铸造数量
holder	String	持有代币地址数
deployAddress	String	铸造者地址
logoUrl	String	代币的logo
txId	String	铸造的交易hash
inscriptionId	String	铭文的ID
deployHeight	String	deploy区块高度
deployTime	String	deploy时间
inscriptionNumber	String	铭文编号
state	String	铭文状态:success、fail
tokenType	String	铭文的类型 BRC20
msg	String	原因

代币持仓地址列表

获取代币持仓地址列表，查看代币分布详情。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/position-list

请求示例

GET /api/v5/explorer/btc/position-list?token=sats

请求参数

参数名	类型	是否必须	描述
token	String	是	代币名称 tick
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "2",
            "totalPage": "4180",
            "positionList": [
                {
                    "holderAddress": "bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2",
                    "amount": "1350000000000",
                    "rank": "1"
                },
                {
                    "holderAddress": "bc1pkucershsndc8suumwqfq6g9u38rma8uxwzqherq2k23e5p2jda9s6jdpr2",
                    "amount": "666000000000",
                    "rank": "2"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
positionList	Array	代币持仓的地址列表
> holderAddress	String	持仓地址
> amount	String	持仓数量
> rank	String	持仓量排名

查询代币转账列表

根据地址、交易hash、区块高度查询转账列表。不提供pending交易的数据。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/transaction-list

请求示例

GET /api/v5/explorer/btc/transaction-list

请求参数

参数名	类型	是否必须	描述
address	String	否	BTC 的地址
token	String	否	代币名称，等于tick
inscriptionNumber	String	否	铭文编号
actionType	String	否	交易类型：deploy、mint、inscribeTransfer、transfer
toAddress	String	否	接收方地址
fromAddress	String	否	发送方地址
txId	String	否	交易Hash
blockHeight	String	否	区块高度
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "2",
            "totalTransaction": "2",
            "inscriptionsList": [
                {
                    "txId": "15f3bad7d7eeac1fad3cffa22812ab43aeaf8f4f6fad83732fc30b2273a0ffd6",
                    "blockHeight": "791466",
                    "state": "success",
                    "tokenType": "BRC20",
                    "actionType": "inscribeTransfer",
                    "fromAddress": "",
                    "toAddress": "bc1p40d22fknr7gu29vswn2r40v3dd39uwavtsnltmdj6sp5lju5davqgwdajy",
                    "amount": "5000",
                    "token": "OXBT",
                    "inscriptionId": "15f3bad7d7eeac1fad3cffa22812ab43aeaf8f4f6fad83732fc30b2273a0ffd6i0",
                    "inscriptionNumber": "9244252",
                    "index": "0",
                    "location": "15f3bad7d7eeac1fad3cffa22812ab43aeaf8f4f6fad83732fc30b2273a0ffd6:0:0",
                    "msg": "",
                    "time": "1685092041000"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
totalTransaction	String	总转账次数
transactionList	Array	交易列表
> txid	String	交易哈希
> blockHeight	String	区块高度
> state	String	铭文状态:success、fail
> tokenType	String	铭文的类型，BRC20
> actionType	String	交易类型：deploy、mint、inscribeTransfer、transfer
> fromAddress	String	发送方地址
> toAddress	String	接收方地址
> amount	String	转账数量
> index	String	vout的index ；类型为coinbase时，该字段没有数值
> location	String	location，格式为txid:vout:offset ；类型为coinbase时，该字段没有数值
> token	String	代币名称，等于tick
> inscriptionId	String	铭文的ID
> inscriptionNumber	String	铭文编号
> msg	String	原因
> time	String	交易时间

查询地址代币余额列表

查询指定地址持有的BRC20代币余额，可转余额、可用余额。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/address-balance-list

请求示例

GET /api/v5/explorer/btc/address-balance-list?address=bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2

请求参数

参数名	类型	是否必须	描述
address	String	是	BTC链地址
token	String	否	代币名称,等于 tick
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "12",
            "balanceList": [
                {
                    "token": "sats",
                    "tokenType": "BRC20",
                    "balance": "1350000000000",
                    "availableBalance": "1350000000000",
                    "transferBalance": "0"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
balanceList	Array	地址持有的代币余额列表
> token	String	代币名称，等于tick
> tokenType	String	铭文的类型。BRC20
> balance	String	余额
> availableBalance	String	可用余额；可用余额 = 钱包中的总额 - 可转让余额
> transferBalance	String	可转让余额

查询地址代币余额明细

查询某地址的某个代币可转余额明细列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/btc/address-balance-details

请求示例

GET /api/v5/explorer/btc/address-balance-details?address=bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2&token=meme

请求参数

参数名	类型	是否必须	描述
address	String	是	BTC链地址
token	String	是	代币名称,等于 tick
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多50条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "6",
            "token": "meme",
            "tokenType": "BRC20",
            "balance": "18",
            "availableBalance": "0",
            "transferBalance": "18",
            "transferBalanceList": [
                {
                    "inscriptionId": "a1002519472f9a1d45db5a3df30ea521ecd5425e546a63a79f3a4a9ff4e6e582i0",
                    "inscriptionNumber": "4615101",
                    "amount": "3"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
token	String	代币名称，等于tick
tokenType	String	铭文的类型。BRC20
balance	String	余额
availableBalance	String	可用余额；可用余额 = 钱包中的总额 - 可转让余额
transferBalance	String	可转让余额
transferBalanceList	Array	可转让余额列表
> inscriptionId	String	inscription Id
> inscriptionNumber	String	inscription 编号
> amount	String	数量

域名风险检测模块

域名风险检测功能模块接口，基于全面的黑名单域名和白名单域名数据库和完善的域名风险检测模型，提供域名风险检测服务，提供一套识别钓鱼网站的解决方案。

每次调用消耗 1 点

风险等级

风险等级	规则	描述
极高	命中黑域名库	我们认为您检测的域名有极大的风险，建议您做相关措施。
高	命中关键词精准匹配策略	我们认为您检测的域名与官方域名关键词相同，需要警惕钓鱼网站的可能性。
中	命中模糊匹配策略	我们认为被检测的域名有风险，可能需要关注。
低	命中白名单或未有规则命中	不代表该域名没有风险，在我们的风险策略识别或者域名库中没有记录。

域名风险检测

通过该接口筛查域名风险，并通过完善的黑域名库和风险特征识别钓鱼网站，降低用户的被钓鱼的风险。

每次调用消耗 1 点

HTTP请求

GET /api/v5/tracker/domainscanner/domain-risk-scanning

请求示例

GET /api/v5/tracker/domainscanner/domain-risk-scanning?domain=www.oklink.com

请求参数

参数名	类型	是否必须	描述
domain	String	是	域名，例如：www.oklink.com 批量查询最多支持5个,以英文逗号分隔。

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "domain": "www.oklink.com",
            "level": "LOW"
        }
    ]
}

返回参数

参数名	类型	描述
domain	String	检测域名
level	String	风险等级；风险极大：SEVERE；高：HIGH；中：MEDIUM；低：LOW；

广播交易模块

发送交易上链功能模块接口，基于OKlink强大的节点服务能力，可将用户打包好的交易广播到区块链中

广播交易上链

将您已经完成签名的交易通过该接口广播到指定区块链上，发送给节点验证此交易。

每次调用消耗 5 点

HTTP请求

POST /api/v5/explorer/transaction/publish-tx

请求示例

POST /api/v5/explorer/transaction/publish-tx
body
{
    "chainShortName":"eth",
    "signedTx":"12232323"
}

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
signedTx	String	是	要广播的已签名的原始交易

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
     {
        "chainFullName":"Bitcoin",
        "chainShortName":"BTC",
        "txid":"5e95ebfe52c50758e69bbac1d2cc4224dc520498e38505bc958fae8bcd5e8366"
     }
  ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
txid	String	交易哈希

地址历史余额模块

历史余额功能模块接口，使用该接口查询指定地址在指定区块链下的指定区块高度的本链币或者代币的余额

查询地址历史余额

接口每小时更新可查询的区块高度。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/block/address-balance-history

请求示例

GET https://www.oklink.com/api/v5/explorer/block/address-balance-history?chainShortName=Optimism&height=15994188&address=0x99C9fc46f92E8a1c0deC1b1747d010903E884bE1&tokenContractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，所支持的链为：ETH、TRON、Polygon、AVAXC、OPTIMISM、Arbitrum
height	String	是	区块高度
address	String	是	查询余额的地址
tokenContractAddress	String	否	代币合约地址，如果不填写，查本链代币的余额，如果填写，查询指定代币的历史余额

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "address": "0x99c9fc46f92e8a1c0dec1b1747d010903e884be1",
            "height": "15994188",
            "balance": "119950111.212534",
            "balanceSymbol": "USDT",
            "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "blockTime": "1668741827000"
        }
    ]
}

返回参数

参数名	类型	描述
address	String	查询余额的地址
height	String	区块高度
balance	String	余额
blockTime	String	出块时间；Unix时间戳的毫秒数格式，如 1597026383085
tokenContractAddress	String	代币合约地址，如果是本链币的查询，该字段返回""
balanceSymbol	String	余额币种，如果是本链币的，为本链代币名称，如果是指定代币的，为代币的缩写名称

Beacon数据模块

Beacon数据模块支持查询信标链的提现和质押相关的数据

查询信标链的质押记录列表

获取信标链的质押记录数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/beacon/beacon-deposit-list

请求示例

GET /api/v5/explorer/beacon/beacon-deposit-list?pubkey=0x942e9c652f1e7105f87ec443ef45d3eea3425cd04268794c9f5b712a47ddbfb6c0d15be5c33784501253891fea6fb7a8&limit=1

请求参数

参数名	类型	是否必须	描述
index	String	否	对应的验证者编号
pubkey	String	否	对应的验证者公钥
limit	String	否	返回条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "1",
            "depositList": [
                {
                    "epoch": "210273",
                    "slot": "6728739",
                    "state": "active",
                    "index": "795613",
                    "pubkey": "0x942e9c652f1e7105f87ec443ef45d3eea3425cd04268794c9f5b712a47ddbfb6c0d15be5c33784501253891fea6fb7a8",
                    "time": "1687568891000",
                    "beaconDepositsReceived": "32",
                    "withdrawalCredential": "0x010000000000000000000000882e747c5c2e0366d4fd6f9f95780467c6549732"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
depositList	Array	质押记录列表
> epoch	String	slot所属的epoch
> slot	String	Slot 插槽
> state	String	验证者状态 deposited：质押中，用户在ETH1.0的staking合约中质押32以上ETH pending：待确认，Beacon收到deposit后，根据总deposit数量用户需在队列中等待通过审核，每个epoch通过6个验证人 active：该用户已激活，并可作为validator在Beacon网络中验证Slot exited：已退出该用户由于曾违规或主动退出(exit)，无法在Beacon网络中继续验证Slot
> index	String	对应的验证者编号
> pubkey	String	对应的验证者公钥
> time	String	质押时间
> beaconDepositsReceived	String	质押ETH数量
> withdrawalCredential	String	提款凭证

查询信标链的赎回记录列表

获取信标链的赎回记录数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/beacon/beacon-withdrawal-list

请求示例

GET /api/v5/explorer/beacon/beacon-withdrawal-list?pubkey=0x942e9c652f1e7105f87ec443ef45d3eea3425cd04268794c9f5b712a47ddbfb6c0d15be5c33784501253891fea6fb7a8&limit=1

请求参数

参数名	类型	是否必须	描述
index	String	否	对应的验证者编号
pubkey	String	否	对应的验证者公钥
limit	String	否	返回条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "7",
            "withdrawalList": [
                {
                    "epoch": "229213",
                    "slot": "7334839",
                    "state": "active",
                    "index": "795613",
                    "pubkey": "0x942e9c652f1e7105f87ec443ef45d3eea3425cd04268794c9f5b712a47ddbfb6c0d15be5c33784501253891fea6fb7a8",
                    "time": "1694842091000",
                    "beaconWithdrawalReceived": "0.01590899",
                    "address": "0x882e747c5c2e0366d4fd6f9f95780467c6549732",
                    "withdrawalCredential": "0x010000000000000000000000882e747c5c2e0366d4fd6f9f95780467c6549732"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
withdrawalList	Array	解压记录列表
> epoch	String	slot所属的epoch
> slot	String	Slot 插槽
> state	String	验证者状态 deposited：质押中，用户在ETH1.0的staking合约中质押32以上ETH pending：待确认，Beacon收到deposit后，根据总deposit数量用户需在队列中等待通过审核，每个epoch通过6个验证人 active：该用户已激活，并可作为validator在Beacon网络中验证Slot exited：已退出该用户由于曾违规或主动退出(exit)，无法在Beacon网络中继续验证Slot
> index	String	对应的验证者编号
> pubkey	String	对应的验证者公钥
> time	String	质押时间
> beaconDepositsReceived	String	质押ETH数量
> withdrawalCredential	String	提款凭证

查询信标链的出块列表

获取信标链的验证者详情

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/beacon/beacon-slot-list

请求示例

GET /api/v5/explorer/beacon/beacon-slot-list

请求参数

参数名	类型	是否必须	描述
slot	String	否	slot，如果都不填写，默认slot排序，最新在最上面
epoch	String	否	epoch
index	String	否	验证者编号
limit	String	否	返回条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
        {
            "chainFullName":"Beacon Chain",
            "chainShortName":"BEACON",
            "issueDate":"1662631619000",
            "consensus":"Pos",
            "finalizedEpoch":"166263",
            "finalizedSlot":"643"
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
slotList	Array	验证者列表
> epoch	String	slot所属的epoch
> slot	String	Slot 插槽
> state	String	状态；proposed 、skipped 、forked
> index	String	对应的验证者编号
> pubkey	String	对应的验证者公钥
> time	String	该Slot的开始时间
> slotIndex	String	当前Slot在Epoch中的位置；slotIndex/32
> attestations	String	由指定的验证者委员会对 Slot 提供验证证明
> parentRoot	String	前一个slot的root
> root	String	root hash
> signature	String	签名
> randaoReveal	String	随机数
> graffiti	String	签名
> voluntaryExitsCount	String	退出验证者数量
> attestationCount	String	验证数量
> attesterSlashingCount	String	验证者被罚没的数量
> l1BlockHash	String	该笔提案 ETH链区块高度hash
> l1DepositCount	String	质押ETH数量
> l1DepositRoot	String	ETH 质押的root

查询信标链基础信息

获取信标链的基础信息，包括验证者概览和质押概览数据

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/beacon/beacon-summary

请求示例

GET /api/v5/explorer/beacon/beacon-summary

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
        {
            "chainFullName":"Beacon Chain",
            "chainShortName":"BEACON",
            "issueDate":"1662631619000",
            "consensus":"Pos",
            "finalizedEpoch":"166263",
            "finalizedSlot":"643",
            "lastCheckpoint":"1703527016",
            "validators":[
                {
                    "totalValidators":"626316",
                    "newTotalValidators":"1619000",
                    .....
                }
            ],
            "staking":[
                {
                    "totalDeposits":"626316",
                    "newTotalDeposits":"-1600",
                    ....
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Beacon Chain
chainShortName	String	公链缩写符号，例如：BEACON
issueDate	String	发行日期
consensus	String	共识算法，例如：Pos
finalizedEpoch	String	最终 Epoch
finalizedSlot	String	最终Slot
lastCheckpoint	String	最新检查点Slot
validators	Array	验证者概览
> totalValidators	String	验证者总数量
> newTotalValidators	String	新增验证者数量，正数为新增，负数为减少
> activeValidators	String	活跃验证者数量
> newActiveValidators	String	新增活跃验证者数量，正数为新增，负数为减少
> pendingValidators	String	待审核验证者数量
> newPendingValidators	String	新增待审核验证者数量，正数为新增，负数为减少
> exitedValidators	String	已退出验证者数量
> newPendingValidators	String	新增已退出验证者数量，正数为新增，负数为减少
> totalValidatorIncome	String	验证者累计收入
staking	Array	质押概览
> totalDeposits	String	ETH1.0链质押ETH的数量
> newTotalDeposits	String	新增ETH1.0链质押ETH的数量，正数为新增，负数为减少
> beaconDepositsReceived	String	信标链接收总质押数量
> newBeaconDepositsReceived	String	新增信标链接收总质押数量，正数为新增，负数为减少
> depositAddresses	String	ETH1.0链质押ETH的地址梳理
> newDepositAddresses	String	新增ETH1.0链质押ETH的地址梳理，正数为新增，负数为减少
> beaconDepositsPubKeys	String	信标链质押公钥的个数量
> newBeaconDepositsPubKeys	String	新增信标链质押公钥的数量，正数为新增，负数为减少
> votedStakes	String	活跃质押量，信标链上参与投票或出块的有效 ETH 质押量每小时更新
> effectiveStakes	String	有效质押量，信标链节点可见的并被接受的 ETH 存款，每小时更新

查询信标链验证者详情

获取信标链的验证者详情。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/beacon/beacon-validator-details

请求示例

GET /api/v5/explorer/beacon/beacon-validator-details

请求参数

参数名	类型	是否必须	描述
index	String	二选一	验证者编号
pubkey	String	二选一	验证者公钥

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
        {
            "chainFullName":"Beacon Chain",
            "chainShortName":"BEACON",
            "issueDate":"1662631619000",
            "consensus":"Pos",
            "finalizedEpoch":"166263",
            "finalizedSlot":"643"
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
validatorList	Array	验证者列表
> index	String	验证着编号
> pubkey	String	验证者公钥
> state	String	"验证者状态 online：近2个Epoch是否有投票或者出块的行为offline：近2个Epoch没有y"
> holdingAmount	String	验证者余额，单位是ETH
> totalIncome	String	验证者总收入
> proposals	String	出块个数
> activationEpoch	String	"激活验证者身份的Epoch；创世块用“0”未激活返回"""""
> exitEpoch	String	退出验证者身份的Epoch
> withdrawalAmountEpoch	String	提取余额的Epoch
> isSlashed	Bol	是否被罚没收；是：true；否：false

查询信标链验证者列表

获取信标链的验证者列表，活跃的验证者和待审核的验证者和已经退出的验证者，每小时更新

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/beacon/beacon-validator-list

请求示例

GET /api/v5/explorer/beacon/beacon-validator-list

请求参数

参数名	类型	是否必须	描述
type	String	否	活跃的验证者：active 待审核的验证者：pending 已退出的验证者：exited 所有的验证者：all 如果不填写，默认为all "
limit	String	否	返回条数，默认返回最近的20条，最多100条
page	String	否	页码

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
        {
            "chainFullName":"Beacon Chain",
            "chainShortName":"BEACON",
            "issueDate":"1662631619000",
            "consensus":"Pos",
            "finalizedEpoch":"166263",
            "finalizedSlot":"643",
            "lastCheckpoint":"1703527016",
            "validators":[
                {
                    "totalValidators":"626316",
                    "newTotalValidators":"1619000",
                    .....
                }
            ],
            "staking":[
                {
                    "totalDeposits":"626316",
                    "newTotalDeposits":"-1600",
                    ....
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
validatorList	Array	验证者列表
> index	String	验证着编号
> pubkey	String	验证者公钥
> state	String	验证者状态 online：近2个Epoch是否有投票或者出块的行为 offline：近2个Epoch没有y
> holdingAmount	String	验证者余额，单位是ETH
> totalIncome	String	验证者总收入
> proposals	String	出块个数
> activationEpoch	String	激活验证者身份的Epoch；创世块用“0”未激活返回""
> exitEpoch	String	退出验证者身份的Epoch
> withdrawalAmountEpoch	String	提取余额的Epoch
> isSlashed	Bol	是否被罚没收；是：true；否：false

NFT API

NFT功能模块接口，提供NFT相关数据，包括项目合集数据、NFT的属性、NFT稀有度、地板价等相关数据。

所支持的链列表

获取NFT模块的API接口所支持的公链列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/chain-list

请求示例

GET /api/v5/explorer/nft/chain-list

请求参数

参数名	类型	是否必须	描述
chainShortName	String	否	公链缩写符号，例如：btc、eth

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH"
        }
    ]

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC

NFT市场概览

获取全链NFT市场数据总揽数据。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/nft-stats-overview

请求示例

GET /api/v5/explorer/nft/nft-stats-overview

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "totalMarketCap": "7369675480.531343",
            "totalHolder": "12769549",
            "dailyTradingVolume": "27488649.434369143",
            "dailyTransaction": "32618"
        }
    ]
}

返回参数

参数名	类型	描述
totalMarketCap	String	全网NFT总市值，单位USD
totalHolder	String	全网持有NFT总地址数
dailyTradingVolume	String	全网日总交易额，单位USD
dailyTransaction	String	全网NFT日交易地址数

获取地址持有的NFT列表

获取指定地址持有的NFT列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/address-balance-fills

请求示例

GET /api/v5/explorer/nft/address-balance-fills?chainShortName=oktc&address=0xda0d7f342b9c0f7f5f456e0c0a3ec6fe925eaef3&protocolType=token_721

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth
address	String	是	地址
protocolType	String	是	代币协议类型 token_721 token_1155
tokenContractAddress	String	否	项目合集的合约地址
limit	String	否	每一页返回的条数，默认返回最近的20条，，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "tokenList": [
                {
                    "tokenContractAddress": "0xbf6151766f379f929ca4860d64dc0f4315c8fac7",
                    "tokenId": "76945287619620490040827884781356597586807125026349729228193629222468205936641",
                    "protocolType": "token_721",
                    "amount": "1",
                    "token": "OKXAI",
                    "logoUrl": "https://static.oklink.com/cdn/nft/a12b0503-3ab9-493c-b1fb-cebe449b81a3.jpeg"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenList	Array	代币列表
> tokenContractAddress	String	合集的合约地址
> tokenId	String	该地址持仓的tokenid
> protocolType	String	该NFT的合约类型
> amount	String	该地址持有这个NFT的数量
> token	String	代币名称
> logoUrl	String	NFT的logo链接

获取NFT的持有者地址

获取NFT的持有者地址列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/nft-owner-address

请求示例

GET /api/v5/explorer/nft/nft-owner-address?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：btc、eth
tokenContractAddress	String	是	项目合集的合约地址
tokenId	String	是	NFT的ID
limit	String	否	每一页返回的条数，默认返回最近的20条，，最多100条
page	String	否	页码

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "positionList": [
                {
                    "ownerAddress": "0xdf9a2981ecd42aabf0b4e085e9c29016864432fc",
                    "logoUrl": "https://static.oklink.com/cdn/nft/files/d7169236-7cbb-4776-8a4c-3ef358f01fc9.webp",
                    "amount": "1"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
positionList	Array	持有NFT的地址列表
> ownerAddress	String	该NFT的持有者地址
> logoUrl	String	NFT的图片链接
> amount	String	持仓数量

查询合集的持仓列表

获取某个合集的持币地址列表，仅返回余额为top10000的地址

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/token/position-list

请求示例

GET /api/v5/explorer/token/position-list?chainShortName=eth&tokenContractAddress=0x495f947276749ce646f68ac8c248420045cb7b5e

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址
holderAddress	String	否	持仓地址
page	String	否	页码
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "circulatingSupply": "",
            "positionList": [
                {
                    "holderAddress": "0x000000000000000000000000000000000000dead",
                    "amount": "1109086030527",
                    "valueUsd": "",
                    "positionChange24h": "",
                    "rank": "1"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
chainFullName	String	公链全称，例如：`Ethereum`
chainShortName	String	公链缩写符号，例如：`ETH`
circulatingSupply	String	总流通量
positionList	Array	交易列表
> holderAddress	String	持仓地址
> amount	String	持仓数量
> valueUsd	String	持仓价值，以美金为单位
> positionChange24h	String	24小时持仓量变化
> rank	String	持仓量排名

查询nft详细数据

获取某个NFT的详细信息，包括地板价、属性和属性的稀有度。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/nft-details

请求示例

GET /api/v5/explorer/nft/nft-details?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址
tokenId	String	是	NFT ID

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "collectionName": "BoredApeYachtClub",
            "tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
            "tokenId": "3481",
            "protocolType": "token_721",
            "token": "BAYC",
            "ownerAddress": "0xdf9a2981ecd42aabf0b4e085e9c29016864432fc",
            "logoUrl": "https://static.oklink.com/cdn/nft/files/d7169236-7cbb-4776-8a4c-3ef358f01fc9.webp",
            "lastPrice": "0",
            "lastPriceUnit": "ETH",
            "lastTransactionTime": "1628951146000",
            "lastHeight": "13023815",
            "lastTxid": "0x7e91013ab5bc0b336f57696dc6cbc7b631127fc0996bab9e10c6657ff09eec9a",
            "transactionCount": "62",
            "minterAddress": "0xee402489d83e2b22d496910f8c810d35a3ad7b25",
            "mintTime": "1619853826000",
            "floorPrice": "45.948",
            "attributes": [
                {
                    "traitType": "Background",
                    "value": "Gray",
                    "prevalence": "0.117"
                },
                {
                    "traitType": "Mouth",
                    "value": "Bored Unshaven",
                    "prevalence": "0.1551"
                },
                {
                    "traitType": "Clothes",
                    "value": "Striped Tee",
                    "prevalence": "0.0412"
                },
                {
                    "traitType": "Eyes",
                    "value": "Bloodshot",
                    "prevalence": "0.0846"
                },
                {
                    "traitType": "Hat",
                    "value": "Halo",
                    "prevalence": "0.0324"
                },
                {
                    "traitType": "Fur",
                    "value": "Gray",
                    "prevalence": "0.0496"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
collectionName	String	项目名称（全称）
tokenContractAddress	String	项目合约地址
tokenId	String	NFT的tokenid
protocolType	String	该NFT的合约类型
token	String	代币名称
ownerAddress	String	该NFT的持有者地址
logoUrl	String	NFT的图片链接
lastPrice	String	该NFT的最新价格
floorPrice	String	该NFT的地板价
lastPriceUnit	String	价格对应的计单位
lastTransactionTime	String	最近交易时间，Unix时间戳的毫秒数格式，如 1597026383085
lastHeight	String	最近交易所在区块
lastTxid	String	最近交易的hash
transactionCount	String	该NFT被交易次数
minterAddress	String	该NFT的创建地址
storageMethod	String	该NFT的存储方式
mintTime	String	该NFT的铸造时间
attributes	Array	属性
> traitType	String	属性类别
> value	String	属性值
> prevalence	String	该属性的稀有度，以小数表示，0.1=10%
> title	String	该NFT的metadata中的name属性，可获取ENS或者DID

获取集合的概览

获取集合的概览信息。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/collection-info

请求示例

GET /api/v5/explorer/nft/collection-info?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
            "collectionName": "BoredApeYachtClub",
            "token": "BAYC",
            "protocolType": "token_721",
            "collectionLogo": "https://static.oklink.com/cdn/explorer/nft/boredapeyachtclub.png",
            "website": "",
            "createContractAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
            "collectionType": "top_collectibles",
            "totalSupply": "10000"
        }
    ]
}

返回参数

参数名	类型	描述
collectionName	String	项目名称（全称）
collectionLogoUrl	String	项目Logo
tokenContractAddress	String	项目合约地址
token	String	代币名称
protocolType	String	合约类型 token_721 token_1155
webSite	String	官网链接
creatContractAddress	String	创建合约的地址
collectionType	String	项目类别： art sports music domain_names virtual_places trading_cards top_collectibles utility_nfts
totalSupply	String	发行NFT的数量

获取集合详细数据

获取集合的详细信息，包括地板价等。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/collection-details

请求示例

GET /api/v5/explorer/nft/collection-details?chainShortName=ETH&tokenContractAddress=0xed5af388653567af2f388e6224dc7c4b3241c544

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "collectionName": "Azuki",
            "tokenContractAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
            "totalSupply": "10000",
            "holder": "4535",
            "avgPrice": "29115.05993895789",
            "transactionNumber": "",
            "activeUser": "",
            "transactionVolume": "1106372.2776803998",
            "transactionVolumeUsd": "1929269850.3735275",
            "floorPrice": "16.59",
            "lastPrice": "16.61"
        }
    ]
}

返回参数

参数名	类型	描述
collectionName	String	项目名称（全称）
tokenContractAddress	String	项目合约地址
totalSupply	String	发行NFT的数量
holder	String	NFT 持有人数
avgPrice	String	平均价格
transactionNumber	String	日交易次数量
activeUser	String	日活跃用户数量
transactionVolume	String	日交易金额，单位为本链币
transactionVolumeUsd	String	日交易金额，单位为USDT
floorPrice	String	地板价
lastPrice	String	最新成交价

获取集合NFT列表

获取集合的NFT列表

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/collection-nft-list

请求示例

GET /api/v5/explorer/nft/collection-nft-list?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址
filterType	String	否	筛选数据转账次数最多：maximum_number_of_transfer 价格由高到低: price_high 价格由低到高: price_low 最新交易时间: latest_transaction_time 默认为 maximum_number_of_transfer
tokenId	String	否	NFT的ID
page	String	否	页码
limit	String	否	返回的条数，最大每页100条，默认20条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10002",
            "tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
            "totalSupply": "10000",
            "nftList": [
                {
                    "tokenId": "6930",
                    "holdingAddressAmount": "1",
                    "logoUrl": "https://static.coinall.ltd/cdn/nft/files/c6ee2a7f-d372-4b10-a1d9-a124fe4cfe2d.webp",
                    "protocolType": "token_721",
                    "lastTransactionTime": "1686728555000",
                    "lastPrice": "45.34",
                    "lastPriceUnit": "ETH",
                    "transactionCount": "53",
                    "mintTime": "1631463191000"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenContractAddress	String	项目合约地址
totalSupply	String	nft的总发行数量
nftList	Array	NFT列表
> tokenId	String	NFT的tokenid
> holdingAddressAmount	String	持仓该NFT的地址个数
> logoUrl	String	NFT的图片链接
> protocolType	String	该NFT的合约类型
> lastTransactionTime	String	最近交易时间，Unix时间戳的毫秒数格式，如 1597026383085
> lastPrice	String	该NFT的最新价格
> lastPriceUnit	String	价格对应的计单位
> transactionCount	String	该NFT被交易次数
> mintTime	String	该NFT的铸造时间

获取集合地板价

获取集合在各个NFT交易市场中的地板价。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/collection-floor-price

请求示例

GET /api/v5/explorer/nft/collection-floor-price?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址
marketplace	String	否	项目NFT交易市场 OpenSea LooksRare X2Y2 Blur CryptoPunks okx

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "marketplace": "X2Y2",
            "floorPrice": "63",
            "priceSymbol": "ETH",
            "updateTime": "1686687612000"
        },
        {
            "marketplace": "LooksRare",
            "floorPrice": "46.98",
            "priceSymbol": "ETH",
            "updateTime": "1686692396000"
        },
        {
            "marketplace": "Blur",
            "floorPrice": "45.948",
            "priceSymbol": "ETH",
            "updateTime": "1686666755000"
        },
        {
            "marketplace": "OpenSea",
            "floorPrice": "45.55",
            "priceSymbol": "ETH",
            "updateTime": "1686730667000"
        }
    ]
}

返回参数

参数名	类型	描述
marketplace	String	项目NFT交易市场
floorPrice	String	该项目的地板价
priceSymbol	String	地板价的单位
updateTime	String	地板价数据更新时间

获取NFT的历史交易

获取NFT的历史交易数据

每次请求消耗1点调用量

HTTP请求

GET /api/v5/explorer/nft/nft-trade-history

请求示例

GET /api/v5/explorer/nft/nft-trade-history?chainShortName=OPTIMISM&tokenContractAddress=0x4454ee4f432f15e0d6479cfe5954e08bf0a08b02&tokenId=87605128674254524374094714059163049597322254422825169623436190981442272134141&activeType=sale

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合约地址
tokenId	String	是	NFT的ID
activeType	String	是	该笔交易的类型，铸造：mint；转账：transfer；成交：sale
page	String	否	页码
limit	String	否	返回的条数，最大每页100条，默认20条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "0",
            "collectionName": "Optimism Name Service",
            "tokenContractAddress": "0x4454ee4f432f15e0d6479cfe5954e08bf0a08b02",
            "tokenId": "87605128674254524374094714059163049597322254422825169623436190981442272134141",
            "token": "OPNS",
            "historyList": [
                {
                    "amount": "1",
                    "createTime": "1682003228000",
                    "fromAddress": "0xb66e1f1a08e23c4ae007b971c5a64cc3d8c87579",
                    "toAddress": "0x2e60df1caf287b15347d67f0b6cd728b241535ec",
                    "price": "0.000180000000000000011",
                    "priceSymbol": "ETH",
                    "usdPrice": "0.354209400000000008",
                    "marketplace": "OpenSea",
                    "activeType": "sale",
                    "txId": "0x4a028b967de2d748d54f9026cac972a800fecb1f814b73d4d2f883c705988d62",
                    "invalid": false
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
collectionName	String	项目名称（全称）
tokenContractAddress	String	项目合约地址
tokenId	String	NFT的tokenid
token	String	代币名称
logoUrl	String	NFT的图片链接
historyList	array	历史列表
> amount	String	成交数量
> createTime	String	时间，毫秒时间戳
> fromAddress	String	NFT转出地址
> toAddress	String	NFT转入地址
> price	String	成交价格
> priceSymbol	String	价格单位
> usdPrice	String	折算为美金的成交价值
> marketplace	String	交易市场，例如：OpenSea
> activeType	String	该笔交易的类型，铸造：mint；转账：transfer；成交：sale
> txId	String	交易hash
> invalid	Bol	是否已过期，部分type true or false

获取NFT的出价订单

获取某NFT的出价订单，展示指定NFT在各个交易市场中的订单数据。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/nft-offers-list

请求示例

GET /api/v5/explorer/nft/collection-floor-price?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址
tokenId	String	是	NFT的ID
marketplace	String	否	项目NFT交易市场 OpenSea LooksRare X2Y2 Blur CryptoPunks okx
page	String	否	页码
limit	String	否	返回的条数，最大每页100条，默认20条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10",
            "collectionName": "Azuki",
            "tokenContractAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
            "tokenId": "7034",
            "token": "AZUKI",
            "offerList": [
                {
                    "amount": "655",
                    "createTime": "1686719124000",
                    "validTime": "2147443200000",
                    "price": "16.41",
                    "priceSymbol": "Blur_ETH",
                    "priceSymbolContractAddress": "",
                    "orderHash": "0x98bbc25f543840490cb58485f9ff4f49684bd4c4d74600199e70dfc51ec0ef18",
                    "ownerAddress": "blur.io",
                    "marketplace": "Blur",
                    "usdPrice": "28586.8764"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
collectionName	String	项目名称（全称）
tokenContractAddress	String	项目合约地址
tokenId	String	NFT的tokenid
token	String	代币名称
offerList	Array	出价单列表
> amount	String	数量
> createTime	String	订单上架时间，毫秒时间戳
> validTime	String	该笔委托过期时间
> price	String	委托价格
> priceSymbol	String	委托价格单位
> priceSymbolContractAddress	String	委托价格单位的代币合约地址
> orderHash	String	订单hash
> ownerAddress	String	出价订单地址
> marketplace	String	交易市场 Looksrare
> usdPrice	String	折算为美金的委托价值

获取NFT的出售订单

获取某NFT的出售订单，展示指定NFT在各个交易市场中的订单数据。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/nft/nft-listing-list

请求示例

GET /api/v5/explorer/nft/nft-listing-list?chainShortName=eth&tokenContractAddress=0xed5af388653567af2f388e6224dc7c4b3241c544&tokenId=1137

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号
tokenContractAddress	String	是	合集的合约地址
tokenId	String	是	NFT的ID
marketplace	String	否	项目NFT交易市场 OpenSea LooksRare X2Y2 Blur CryptoPunks okx
page	String	否	页码
limit	String	否	返回的条数，最大每页100条，默认20条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "3",
            "collectionName": "Azuki",
            "tokenContractAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
            "tokenId": "5954",
            "token": "AZUKI",
            "listingList": [
                {
                    "amount": "1",
                    "createTime": "1691542042000",
                    "validTime": "1691563634000",
                    "price": "4.999",
                    "priceSymbol": "ETH",
                    "priceSymbolContractAddress": "",
                    "orderHash": "0xf90de159b6fe6aa3ee9b6455a0f58be8d16018628e92f3d4e00db5212566396b",
                    "ownerAddress": "0x9de416ab881b322ee0b4c189c2de624090280cf2",
                    "marketplace": "OpenSea",
                    "usdPrice": "9133.6729"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
collectionName	String	项目名称（全称）
tokenContractAddress	String	项目合约地址
tokenId	String	NFT的tokenid
token	String	代币名称
listingList	Array	出价单列表
> amount	String	数量
> createTime	String	订单上架时间，毫秒时间戳
> validTime	String	该笔委托过期时间
> price	String	委托价格
> priceSymbol	String	委托价格单位
> priceSymbolContractAddress	String	委托价格单位的代币合约地址
> orderHash	String	订单hash
> ownerAddress	String	出价订单地址
> marketplace	String	交易市场
> usdPrice	String	折算为美金的委托价值

DeFi API

Defi功能模块接口，提供某地址的授权列表查询服务，即将支持更多的DeFi数据功能，敬请期待。

查询授权代币列表

使用这个API接口查询某地址授权的代币合约列表，包括20代币和721代币的授权信息。

每次调用消耗 1 点

HTTP请求

GET /api/v5/tracker/contractscanner/token-authorized-list

请求示例

GET /api/v5/tracker/contractscanner/token-authorized-list?address=0xb011c3F34edbDE3703C25B7eDF2E22a3b4fed08b&chainShortName=oktc

请求参数

参数名	类型	是否必须	描述
chainShortName	String	是	公链缩写符号，例如：Ethereum、BSC、Polygon、Arbitrum、Fantom、Avalanche、OKC
address	String	是	您想要查询的地址
protocolType	String	否	代币类型， token_20 token_721 token_1155 默认查询20代币授权信息

返回结果

{
    "code":"0",
    "msg":"",
    "data":[
        {
            "chainShortName":"OKTC",
            "protocolType":"token_20",
            "tokenContractAddress":"0xef71ca2ee68f45b9ad6f72fbdb33d707b872315c",
            "authorizationAddress":"0xb011c3f34edbde3703c25b7edf2e22a3b4fed08b",
            "precision":"18",
            "tokenFullName":"ETHK",
            "token":"ETHK",
            "holdingAmount":"0.000350583522876767",
            "authorizedList":[
                {
                    "approvedContractAddress":"0xb45a2dda996c32e93b8c47098e90ed0e7ab18e39",
                    "approvedAmount":"unlimited",
                    "tokenId":"",
                    "approvedTime":"1681249168000",
                    "approvedTxId":"0x0c3add00acaa8aa641bbf05727d3c34300d1a44e858a49741c079b2d67655380",
                    "approvedProjectName":""
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
chainShortName	String	公链符号，支持：Ethereum、BSC、Polygon、Arbitrum、Fantom、Avalanche、OKC
protocolType	String	合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
tokenContractAddress	String	代币/NFT集合的合约地址
authorizationAddress	String	被检测的授权地址
precision	String	精度
tokenFullName	String	代币名字全称/或者NFT项目名称：USDCoin
token	String	代币名字简称/NFT项目简称
holdingAmount	String	被检测的地址的链上持仓该代币数量
authorizedList	Array	授权的合约列表
> approvedContractAddress	String	被授权合约地址
> tokenId	String	被授权的tokenID
> approvedAmount	String	授权数量无限：unlimited ，其他为具体数值
> approvedTime	String	授权时间，UTC 毫秒时间戳
> approvedTxId	String	授权的交易hash
> approvedProjectName	String	授权的项目名称例如：unswap V3

K线数据

K线数据功能模块接口，提供150条公链的全币种代币行情数据。基于底层强大的解析能力，实时的解析代币的池子里的价格，为用户提供最全面的代币行情数据。

代币列表

查询150+公链代币列表，获取代币唯一id。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/tokenprice/token-list

请求示例

GET /api/v5/explorer/tokenprice/token-list?token=ordi

请求参数

参数名	类型	是否必须	描述
tokenUniqueId	String	否	代币的唯一ID
page	String	否	页码，不填写，默认返回第一页
limit	String	否	每页返回数据个数，默认为20条数据，最多50条。
token	String	否	代币简称，大小写兼容

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "1",
            "tokenList": [
                {
                    "tokenUniqueId": "18684748417958401",
                    "tokenFullName": "ordi",
                    "token": "ordi",
                    "network": [
                        {
                            "chainId": "0",
                            "chainFullName": "Bitcoin",
                            "chainShortName": "BTC",
                            "tokenContractAddress": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0"
                        }
                    ]
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
tokenList	Array	代币列表
> tokenUniqueId	String	代币在OKLink系统里的唯一ID标识
> tokenFullName	String	代币全称
> token	String	代币简称
> network	Array	该代币所发行的网络
>> chainId	String	公链唯一标识
>> chainFullName	String	公链全称，例如：Bitcoin
>> chainShortName	String	公链缩写符号，例如：BTC
>> tokenContractAddress	String	代币合约地址

代币历史数据

支持查询150+公链代币的历史价格数据。

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/tokenprice/historical

请求示例

GET /api/v5/explorer/tokenprice/market-data?chainId=0&tokenContractAddress=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0

请求参数

参数名	类型	是否必须	描述
chainId	String	是	chain的唯一标识，
tokenContractAddress	String	否	代币合约地址，不填写此参数，默认查询本链币的历史数据。
limit	String	否	返回数据条数，默认为50条，单次请求最多返回200条
after	String	否	请求此时间戳之前（更旧的数据）的分页内容，传的值为对应接口的time
before	String	否	请求此时间戳之后（更新的数据）的分页内容，传的值为对应接口的time
period	String	否	筛选时间粒度，默认值1d [1m/5m/30m/1h/1D]

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "price": "5.63",
            "time": "1686844800000"
        }
    ]
}

返回参数

参数名	类型	描述
price	String	价格
time	String	数据更新时间

代币市场数据

支持查询150+公链代币的市场数据信息，提供市场上全币种详情。

每次调用消耗 2 点

HTTP请求

GET /api/v5/explorer/tokenprice/market-data

请求示例

GET /api/v5/explorer/tokenprice/market-data?chainId=0&tokenContractAddress=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0

请求参数

参数名	类型	是否必须	描述
chainId	String	是	chain的唯一标识，可通过该接口获取 /api/v5/explorer/token/token-list
tokenContractAddress	String	否	代币合约地址，不填写此参数，默认查询本链币的历史数据。

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "lastPrice": "5.908",
            "totalSupply": "123921000",
            "circulatingSupply": "21000000",
            "volume24h": "32832.857439353",
            "marketCap": "123921000",
            "high24h": "5.98",
            "low24h": "5.449"
        }
    ]
}

返回参数

参数名	类型	描述
lastPrice	String	最新价格
totalSupply	String	代币总供应量
maxSupply	String	代币最大供应量
circulatingSupply	String	代币流通量
volume24h	String	24小时交易量
marketCap	String	全网总市值
high24h	String	24小时最高价
low24h	String	24小时最低价

逐笔交易数据

获取某Dex中的逐笔交易数据，最多可以查10000条

每次调用消耗 1 点

HTTP请求

GET /api/v5/explorer/tokenprice/tracker

请求示例

GET /api/v5/explorer/tokenprice/tracker?chainId=1

请求参数

参数名	类型	是否必须	描述
chainId	String	是	chain的唯一标识，
poolAddress	String	否	代币池子合约地址
tokenContractAddress	String	否	代币合约地址
dexName	String	否	发生该笔交易的Dex
page	String	否	页码，不填写，默认返回第一页
height	String	否	区块高度
limit	String	否	每页返回数据个数，默认为20条数据，最多50条。

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "10000",
            "transactionList": [
                {
                    "txId": "0x579daacaaa8c1ff25a5d0e4547b07b2e39caf83e3a628a32c6e05ae27a441ec7",
                    "poolAddress": "0x4ff4c7c8754127cc097910cf9d80400adef5b65d",
                    "tokenInAmount": "501331140598753.6",
                    "tokenInContractAddress": "0xe0a458bf4acf353cb45e211281a334bb1d837885",
                    "tokenOutAmount": "0.029930133316652997",
                    "tokenOutContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "dexName": "Uniswap V2",
                    "factoryAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
                    "transactionAmountUsd": "49.833318037797305",
                    "transactionTime": "1686887603000",
                    "height": "17489850",
                    "traderAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
                    "index": "246"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
page	String	当前页码
limit	String	当前页共多少条数据
totalPage	String	总共多少页
transactionList	Array	交易列表
> txId	String	交易Hash
> poolAddress	String	发生该笔交易的pool合约地址
> tokenInAmount	String	转入代币数量
> tokenInContractAddress	String	转入代币合约地址
> tokenOutAmount	String	转出代币数量
> tokenOutContractAddress	String	转出代币的代币合约地址
> dexName	String	Dex名称
> factoryAddress	String	工厂合约地址
> transactionAmountUsd	String	交易金额，以USD为单位
> transactionTime	String	交易时间，UTC格式毫秒时间戳。
> height	String	发生该笔交易的区块高度
> index	String	该笔交易在区块里顺序
> traderAddress	String	交易者地址

所支持的链

chainId	chain name
1	ETH
10	OPTIMISM
13	ZKSPACE
56	BSC
66	OKTC
137	POLYGON
195	TRON
250	FTM
324	ERA
805	ZKSYNC
1030	CFX
10001	ETHW
42161	ARBITRUM
43114	AVAXC

错误码

公共

错误码从 50000 到 53999

通用类

错误提示	HTTP 状态码	错误码
操作成功	200	0
body不能为空	400	50000
服务暂时不可用，请稍后重试	503	50001
非法的json数据	400	50002
接口请求超时（不代表请求成功或者失败，请检查请求结果）	400	50004
接口已下线或无法使用	410	50005
无效的Content_Type，请使用"application/json"格式	400	50006
用户ID为空	200	50010
用户请求频率过快，超过该接口允许的限额	429	50011
当前系统繁忙，请稍后重试	429	50013
必填参数{0}不能为空	400	50014
参数{0}和{1}不能同时为空	400	50015
参数{0}和{1}不匹配	400	50016
参数{0}和{1}不能同时存在	200	50024
参数{0}传值个数超过最大限制{1}	200	50025
系统错误	500	50026
您没有该API接口的访问权限，需要升级您的账户付费等级	200	50030
参数{%}错误	400	50036
代币不存在	200	50037
该公链不支持	200	50038
该警报ID没有历史处理记录	200	50039
此区块高度无数据展示。	200	50040
当前不支持此代币的历史余额查询	200	50041
该代币不支持风险扫描	200	50042
您的账户行为触发了风险控制，API功能已冻结。可以通过[email protected]与我们联系。	200	50043
数据不存在	400	50044

鉴权类

错误提示	HTTP 状态码	错误码
Api 已被冻结，请联系客服处理	400	50100
请求时间戳过期	401	50102
请求头"OK_ACCESS_KEY"不能为空	401	50103
请求头"OK_ACCESS_PASSPHRASE"不能为空	401	50104
请求头"OK_ACCESS_PASSPHRASE"错误	401	50105
请求头"OK_ACCESS_SIGN"不能为空	401	50106
请求头"OK_ACCESS_TIMESTAMP"不能为空	401	50107
无效的ip	401	50110
无效的OK_ACCESS_KEY	401	50111
无效的OK_ACCESS_TIMESTAMP	401	50112
无效的签名	401	50113
无效的授权	401	50114
无效的请求类型	405	50115
超过了历史数据查询的范围	400	50117

业务类

错误提示	HTTP 状态码	错误码
{0}参数错误	400	51000
您填写的outputAddress地址在本次交易中没有找到。	400	51001
这个索引所指定的outputAddress在这个交易中不存在。	400	51002
该笔交易Hash在区块链上未解析到交易信息，无法确定该笔交易风险详情。	400	51003