导航
English

欢迎使用OKLink API

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

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

浏览器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

API 鉴权

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

API请求地址URL如下:

APIkey使用方法:

API接口访问请求示例:

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

访问限制

联系我们

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

接口列表

每次接口调用的时候都会消耗可调用量,大部分接口的消耗是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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:okceth,请求/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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,可通过 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 公链缩写符号,例如:btceth,可通过 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 公链缩写符号,例如:btceth,可通过 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 公链缩写符号,例如:btceth,可通过 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 公链缩写符号,例如:btceth,可通过 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 公链缩写符号,例如:btceth,请求/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 筛选日期
1D3D1W1M3M1YAll
默认为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 公链缩写符号,例如:BTCETH
period period 筛选日期:
1D1W3M1YAll
默认为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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,可通过 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 公链缩写符号,例如:btceth,可通过 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