概览

OKLink是全球首家区块链大数据上市公司打造的区块链信息服务网站，旨在利用区块链+大数据技术为用户提供安全可靠的区块链信息服务。

OKLink作为业内领先的链上数据服务商，将自己强大的链上数据能力，以API的方式为区块链的开发者提供高质量的数据。
开发人员使用GET或POST请求，通过RestAPI直接访问OKLink的浏览器和链上大师的数据服务，用于构建相关应用程序。

入门指引

欢迎您使用开发者文档。
- OKLink为机构客户、开发者及研究者提供强大的API工具产品，API涵盖主流数字资产的多链实时数据、链上交易以及地址分析，可免除自建节点、同步区块以及运维的成本。
- OKLink提供了简单而强大的RestAPI接口服务，您可以从众多API端点当中选用您需要的接口功能，来构建您的应用程序。
- 非常适用于高校的学术课题研究、中心化交易所、公链开发、数字钱包、金融机构、业内媒体等群体。

API使用方式

API请求地址URL如下：
- https://www.oklink.com/

APIkey使用方法：
- 对于每个API请求，需要在Http Request Headers 中添加(“Ok-Access-Key”,填写您的专属APIkey)

举例说明：
- Request Headers
- Ok-Access-Key: 47e6bc5d-8e78-xxxxxxx4f3e86a3466

联系我们：洽谈合作、API问题反馈、API需求沟通
- 微信号：Alex_OK ，与专业量化人员交流。
- 官方邮箱：[email protected]

限速规则

为保证OKLink的API数据系统服务的稳定性，我们的所有RestAPI接口受到访问频率限制，如果您的请求速率达到限制，API请求将会被拒绝。

层级（userid维度）	有效日期	每个接口请求频率（限速）不累加	单个用户每日所有接口总访问频次	单个用户每秒访问总频次（UserID维度累加）
1 免费	限时免费	3次/1s	10万	10次/1s
2 基础版本	申请	5次/1s	30万	20次/1s
3 专业版本	申请	10次/1s	50万	30次/1s
4 机构版本	申请	15次/1s	100万	40次/1s

API 介绍

使用OKLink的API，可以获取以下功能模块的数据：
- 公链基本信息
- 区块信息
- 链上交易信息
- 地址余额
- DeFi数据
- 链上大师的统计图表数据

REST API

公链基础模块

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

查询公链列表

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

HTTP请求

GET /api/v5/explorer/blockchain/summary

请求示例

GET /api/v5/explorer/blockchain/summary

请求参数

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

返回结果

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

返回参数

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

查询公链详情

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

HTTP请求

GET /api/v5/explorer/blockchain/info

请求示例

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

请求参数

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

返回结果

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

返回参数

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

查询持币地址基础信息

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

HTTP请求

GET /api/v5/explorer/blockchain/address

请求示例

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

请求参数

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

返回结果

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

返回参数

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

查询区块基础信息

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

HTTP请求

GET /api/v5/explorer/blockchain/block

请求示例

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

请求参数

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

返回结果

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

返回参数

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

查询最佳手续费或Gas费

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

HTTP请求

GET /api/v5/explorer/blockchain/fee

请求示例

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

请求参数

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

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "symbol": "ETH",
            "bestTransactionFee": "",
            "recommendedGasPrice": "9.251118437"
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
symbol	String	公链原生代币，例如：btc
bestTransactionFee	String	最佳交易手续费
recommendedGasPrice	String	建议Gas费，单位。ETH单位：Gwei

查询算力基础信息

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

HTTP请求

GET /api/v5/explorer/blockchain/hashes

请求示例

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

请求参数

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

返回结果

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

返回参数

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

查询挖矿基础信息

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

HTTP请求

GET /api/v5/explorer/blockchain/mine

请求示例

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

请求参数

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

返回结果

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

返回参数

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

查询链上交易信息

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

HTTP请求

GET /api/v5/explorer/blockchain/transaction

请求示例

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

请求参数

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

返回结果

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

返回参数

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

区块模块

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

查询区块头明细

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

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万条区块列表数据

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

查询区块交易列表

将您已经完成前面打包好的交易通过该接口广播上链，发送给节点验证。

HTTP请求

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

请求示例

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

请求参数

参数名	类型	是否必须	描述
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": "388",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "blockList": [
                {
                    "txid": "0x8261260dd57dc5b72b00a6c3436daeb7677e36332152a20c13e0c01e022ff38d",
                    "blockHash": "0xb837772ccffca8ffc56a5744c61eb49a13359068b971e4c47c602a708341dff0",
                    "height": "14636119",
                    "transactionTime": "1650650059000",
                    "from": "0x7020b0c2cad93212366df8caa622634c78ecadea",
                    "fromTag": "",
                    "to": "0x30a9b9253ac147f8631a6a137d3ece4efd4254ef",
                    "toTag": "",
                    "amount": "0.2",
                    "transactionSymbol": "ETH",
                    "txfee": "0.001233160940193",
                    "state": "success"
                }
            ]
        }
    ]
}

返回参数

参数名	类型	描述
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	发送方地址
> fromTag	String	发送方地址标签
> to	String	接收方地址
> toTag	String	接收方地址标签
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> state	String	交易状态 success 成功 fail 失败 pending 等待确认

地址模块

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

查询地址余额明细

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

HTTP请求

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

请求示例

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

请求参数

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

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "20",
            "totalPage": "50",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "tokenList": [
                {
                    "token": "KISHU",
                    "holdingAmount": "6547769627347866",
                    "totalTokenValue": "1957.63551447",
                    "change24h": "0.15999533",
                    "priceUsd": "4.84E-10",
                    "valueUsd": "3169120.499636367144"
                }
  ]
}

返回参数

参数名	类型	描述
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	代币总的美元价值

获取地址基本信息

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

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": "Ethereum",
            "chainShortName": "ETH",
            "address": "0x0d0707963952f2fba59dd06f2b425ace40b492fe",
            "contractAddress": "",
            "isProducerAddress": false,
            "balance": "6109.476940285837",
            "balanceSymbol": "ETH",
            "transactionCount": "5689735",
            "verifying": "0",
            "sendAmount": "15906812.251354257",
            "receiveAmount": "15915995.612076225",
            "tokenAmount": "2476",
            "totalTokenValue": "19883.75956501",
            "createContractAddress": "",
            "createContractTransactionHash": "",
            "firstTransactionTime": "1524348360000",
            "lastTransactionTime": "1662645085000",
            "token": ""
        }
    ]
}

返回参数

参数名	类型	描述
chainFullName	String	公链全称，例如：Bitcoin
chainShortName	String	公链缩写符号，例如：BTC
address	String	普通地址
contractAddress	String	智能合约地址
isProducerAddress	BOl	true：是验证人/节点地址 false：不是验证人/节点地址
tag	String	地址标签（openAPI，pri API返回）
balance	String	余额
balanceSymbol	balance	余额币种
transactionCount	String	该地址交易次数
verifying	String	确认中金额
sendAmount	String	发送金额
receiveAmount	String	接收金额
tokenAmount	String	代币种类数量
totalTokenValue	String	代币总价值折算成公链原生币的数量
createContractAddress	String	创建该智能合约的地址
createContractTransactionHash	String	创建该智能合约的交易hash
firstTransactionTime	String	该地址发生第一笔交易时间
lastTransactionTime	String	该地址最近一次发生交易时间
token	String	该地址对应的代币

富豪地址排行榜TOP100

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

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": "Avalanche",
            "chainShortName": "AVAXC",
            "symbol": "AVAX",
            "rank": "1",
            "address": "0xb31f66aa3c1e785363f0875a1b74e27b85fd66c7",
            "amount": "8399035.785454646",
            "transactionCount": "38917772",
            "holdRatio": "0.0284",
            "netWork": ""
        },
        {
            "chainFullName": "Avalanche",
            "chainShortName": "AVAXC",
            "symbol": "AVAX",
            "rank": "2",
            "address": "0x4aefa39caeadd662ae31ab0ce7c8c2c9c0a013e8",
            "amount": "6716111.765061616",
            "transactionCount": "59",
            "holdRatio": "0.0227",
            "netWork": ""
        }
    ]
}

返回参数

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

查询地址交易列表信息

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

HTTP请求

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

请求示例

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

请求参数

参数名	类型	是否必须	描述
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
symbol	String	否	代币名称
page	String	否	页码,默认返回第一页
limit	String	否	返回条数，默认返回最近的20条，最多100条

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "5635574",
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "transactionLists": [
                {
                    "txId": "0xcf01a33008e926e2cf6db6f576277aad3a5abe26cfc83311f7c34bd7ef6bf49e",
                    "blockHash": "1662645321646",
                    "height": "0",
                    "transactionTime": "0",
                    "from": "0x0d0707963952f2fba59dd06f2b425ace40b492fe",
                    "to": "0x3845badade8e6dff049820680d1f14bd3903a5d0",
                    "amount": "0",
                    "transactionSymbol": "ETH",
                    "txFee": "0.042149023874",
                    "state": "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
> from	String	发送方地址
> to	String	接收方地址
fromTag	String	发送方地址标签
toTag	String	接收方地址标签
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> state	String	交易状态 `success` 成功 `fail` 失败 `pending` 等待确认

查询地址UTXO交易

获取某个地址上的UTXO交易信息,通常用于离线交易签名，仅适用于BTC，BCH等UTXO模型的链

HTTP请求

GET /api/v5/explorer/address/unspent

请求示例

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

请求参数

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

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Bitcoin",
            "chainShortName": "BTC",
            "txId": "ecf459842415e9f43684d153af29087a6aa017d9a40f092c4ebf84aa650d6e15",
            "height": "753170",
            "amount": "0",
            "address": "1J8PUoF1E1LcrPNMuR3ueJamkSU7A1p42Y",
            "confirm": "",
            "index": "2435",
            "transactionIndex": "762894288",
            "balance": "0.01144956",
            "symbol": "BTC"
        }
    ]
}

返回参数

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

挖矿模块

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

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

HTTP请求

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

请求示例

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

请求参数

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

返回结果

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

返回参数

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

查询查询矿池算力排名

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

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等质押挖矿的链。

HTTP请求

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

请求示例

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

请求参数

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

返回结果

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

返回参数

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

链上交易模块

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

查询大额交易列表

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

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": "0x908f9d379ce7c5d7d36cd4106b518744eef2b76e5d3993a8c127830e5910fb79",
                    "blockHash": "0x1fe2070a7e9b3c327d9e871ed9102f69b5fc487bf571195bec3f1120972f122a",
                    "height": "15496531",
                    "transactionTime": "1662639628000",
                    "input": "0xc098b2a3aa256d2140208c3de6543aaef5cd3a94",
                    "output": "0xa7888f85bd76deef3bd03d4dbcf57765a49883b3",
                    "amount": "1127.48831434",
                    "transactionSymbol": "ETH",
                    "txfee": "0.000334814355708",
                    "methodId": "",
                    "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	输出，例如，如果存在多个地址，以英文逗号分隔
> amount	String	交易数量
> transactionSymbol	String	交易数量对应的币种
> txfee	String	手续费
> methodId	String	方法
> transactionType	String	交易类型`0`：原始交易类型 `1`:EIP2930 `2`:EIP1559
> state	String	交易状态 `success` 成功 `fail` 失败 `pending` 等待确认

查询交易明细

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

HTTP请求

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

请求示例

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

请求参数

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

返回结果

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "chainFullName": "Ethereum",
            "chainShortName": "ETH",
            "txid": "0x72726ce96339c229eb81a8f11316cbfbe07f4e009396d924d8d36888babb2a9a",
            "height": "15496544",
            "transactionTime": "1662639774000",
            "amount": "0",
            "transactionSymbol": "ETH",
            "txfee": "0.002594702144612637",
            "index": "15",
            "confirm": "3",
            "inputDetails": [
                {
                    "inputHash": "0xf63286e6ce26798f75b74d9f2283f88afe6bfc7d",
                    "tag": "",
                    "amount": "",
                    "contract": false
                }
            ],
            "outputDetails": [
                {
                    "outputHash": "0x31e329b6c9eabe77ddb08c61a3c0a95e8c1137aa",
                    "tag": "",
                    "amount": "",
                    "contract": true
                }
            ],
            "state": "success",
            "gasLimit": "179203",
            "gasUsed": "176403",
            "gasPrice": "0.000000014708945679",
            "totalTransactionSize": "",
            "virtualSize": "37",
            "weight": "",
            "nonce": "1244",
            "transactionType": "0",
            "tokenTransferDetails": [
                {
                    "index": "15",
                    "token": "TUBE2",
                    "tokenContractAddress": "0xda86006036540822e0cd2861dbd2fd7ff9caa0e8",
                    "symbol": "TUBE2",
                    "from": "0xee254ab0eccd68227aa6fd05dd4c49d53c06208e",
                    "to": "0x5fe65b1172e148d1ac4f44ffc4777c2d4731ee8f",
                    "tokenId": "",
                    "amount": "0.1030728"
                },
                {
                    "index": "15",
                    "token": "TUBE2",
                    "tokenContractAddress": "0xda86006036540822e0cd2861dbd2fd7ff9caa0e8",
                    "symbol": "TUBE2",
                    "from": "0x5fe65b1172e148d1ac4f44ffc4777c2d4731ee8f",
                    "to": "0x31e329b6c9eabe77ddb08c61a3c0a95e8c1137aa",
                    "tokenId": "",
                    "amount": "0.1030728"
                }
            ],
            "contractDetails": []
        }
    ]
}

返回参数

参数名	类型	描述
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/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	输出地址，如果存在多个地址，以英文逗号分隔
> 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/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": "0xd6eebfab91fd97987724c13b41f22fbf1e6c6802025d1d85d8ff2c6f657174ee",
                    "blockHash": "",
                    "height": "",
                    "transactionTime": "0",
                    "input": "0x6459241662e28e8f06f27204207549261fc76620",
                    "output": "0x257e07b9ad34f2b88ef4c3ec31cf583f7729474f",
                    "amount": "0",
                    "transactionSymbol": "ETH",
                    "txfee": "0.00017768",
                    "methodId": "0xc311d049",
                    "transactionType": "0",
                    "randomNumber": "6",
                    "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
> 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` 等待确认

广播交易上链

将您已经完成前面打包好的交易通过该接口广播上链，发送给节点验证。

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	交易哈希

解析交易

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

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）

代币模块

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

查询代币列表信息

获取某个代币的基本信息

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
token	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	价格，美元为单位
> website	String	官方网站
> totalMarketCap	String	总市值

稳定币模块

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

查询USDT印钞/销毁记录

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

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网络，默认为all
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	交易时间

错误码

REST

REST API 错误码从 50000 到 59999

公共

错误码从 50000 到 53999

通用类

错误提示	HTTP 状态码	错误码
操作成功	200	0
操作全部失败	200	1
批量操作部分成功	200	2
body不能为空	400	50000
服务暂时不可用，请稍后重试	503	50001
非法的json数据	400	50002
接口请求超时（不代表请求成功或者失败，请检查请求结果）	400	50004
接口已下线或无法使用	410	50005
无效的Content_Type，请使用"application/json"格式	400	50006
用户被冻结	200	50007
用户不存在	200	50008
用户处于爆仓冻结	200	50009
用户ID为空	200	50010
用户请求频率过快，超过该接口允许的限额	429	50011
用户状态无效	200	50012
当前系统繁忙，请稍后重试	429	50013
必填参数{0}不能为空	400	50014
参数{0}和{1}不能同时为空	400	50015
参数{0}和{1}不匹配	400	50016
当前仓位处于ADL冻结中，无法进行相关操作	200	50017
{0}币种处于ADL冻结中，无法进行相关操作	200	50018
当前账户处于ADL冻结中，无法进行相关操作	200	50019
当前仓位处于强平冻结中，无法进行相关操作	200	50020
{0}币种处于强平冻结中，无法进行相关操作	200	50021
当前账户处于强平冻结中，无法进行相关操作	200	50022
资金费冻结，无法进行相关操作	200	50023
参数{0}和{1}不能同时存在	200	50024
参数{0}传值个数超过最大限制{1}	200	50025
系统错误	500	50026
当前账户已被限制交易	200	50027
账户异常无法下单	200	50028
你的账户已经触发风控体系，禁止该标的{0}交易，请联系客服进行处理	200	50029
用户没有使用此API接口的权限	200	50030
设置币种数量不能大于100个	200	50031
您的账户已设置禁止该币种交易，请确认后重试	200	50032
您的账户已设置禁止该业务线交易，请确认后重试	200	50033
您当前不在白名单列表，请联系客服	200	50034
该接口要求APIKey必须绑定IP	403	50035

API 类

错误提示	HTTP 状态码	错误码
Api 已被冻结，请联系客服处理	400	50100
APIKey 与当前环境不匹配	401	50101
请求时间戳过期	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
券商ID不存在	401	50108
券商域名不存在	401	50109
无效的ip	401	50110
无效的OK_ACCESS_KEY	401	50111
无效的OK_ACCESS_TIMESTAMP	401	50112
无效的签名	401	50113
无效的授权	401	50114
无效的请求类型	405	50115

交易类

错误提示	HTTP 状态码	错误码
{0}参数错误	400	51000
交易产品ID不存在	200	51001
交易产品ID不匹配指数	200	51002
ordId或clOrdId至少填一个	200	51003
委托数量超过用户当前档位	200	51004
委托数量大于单笔上限	200	51005
委托价格不在限价范围内	200	51006
委托失败，委托数量不可小于 1 张（用户下单数量不足 1 张时）	200	51007
委托失败，账户可用余额不足	200	51008
下单功能被平台冻结	200	51009
当前账户模式不支持此操作	200	51010
ordId重复	200	51011
币种不存在	200	51012
指数不存在	200	51014
instId和instType不匹配	200	51015
clOrdId重复	200	51016
杠杆委托交易借币超出限额	200	51017
期权交易账户不能有净空头持仓	200	51018
期权全仓不能有净多头持仓	200	51019
委托数量必须超过单笔下限	200	51020
合约待上线	200	51021
合约暂停中	200	51022
仓位不存在	200	51023
交易账户冻结	200	51024
委托笔数超限	200	51025
交易产品类型不匹配指数（instType和uly不匹配）	200	51026
合约已到期	200	51027
合约交割中	200	51028
合约结算中	200	51029
资金费结算中	200	51030
委托价格不在平仓限价范围内	200	51031
市价全平中	200	51032
币对单笔交易已达限额	200	51033
PM账户仅支持买卖模式	200	51041
当前订单类型{0}, {1}不支持设置止盈和止损	200	51044
止盈触发价格应该大于委托价格	200	51046
止损触发价格应该小于委托价格	200	51047
止盈触发价格应该小于委托价格	200	51048
止损触发价格应该大于委托价格	200	51049
止盈触发价格应该大于卖一价	200	51050
止损触发价格应该小于卖一价	200	51051
止盈触发价格应该小于买一价	200	51052
止损触发价格应该大于买一价	200	51053
获取信息超时，请稍候重试	500	51054
币交易金额小于最小可交易金额	200	51100
超出单笔最大挂单张数	200	51101
超出合约最大挂单数量	200	51102
超出标的最大挂单数量	200	51103
超出标的最大挂单张数	200	51104
超出合约最大可开张数	200	51105
超出标的最大可开张数	200	51106
超出标的最大持仓张数	200	51107
持仓量超过市价全平最大限制	200	51108
订单深度中无买一卖一价	200	51109
集合竞价开始后方可下限价单	200	51110
批量下单时，超过最大单数{0}	200	51111
平仓张数大于该仓位的可平张数	200	51112
市价全平操作过于频繁	429	51113
市价全平前请先撤销所有平仓单	200	51115
委托价格或触发价格超过{0}美元	200	51116
平仓单挂单单数超过限制	200	51117
委托总数量需大于单笔上限	200	51118
下单数量不足{0}张	200	51120
下单张数应为一手张数的倍数	200	51121
委托价格小于最小值{0}	200	51122
价格发现期间您只可下限价单	200	51124
当前杠杆存在非只减仓挂单，请撤销所有非只减仓挂单后进行只减仓挂单	200	51125
当前杠杆存在只减仓挂单，请撤销所有只减仓挂单后进行非只减仓挂单	200	51126
仓位可用余额为0	200	51127
跨币种账户无法进行全仓杠杆交易	200	51128
持仓及买入订单价值已达到持仓限额，不允许继续买入	200	51129
逐仓杠杆保证金币种错误	200	51130
仓位可用余额不足	200	51131
仓位正资产小于最小交易单位	200	51132
跨币种全仓币币不支持只减仓功能	200	51133
平仓失败，请检查持仓和挂单	200	51134
您的平仓价格已触发限价，最高买入价格为{0}	200	51135
您的平仓价格已触发限价，最低卖出价格为{0}	200	51136
您的开仓价格已触发限价，最高买入价格为{0}	200	51137
您的开仓价格已触发限价，最低卖出价格为{0}	200	51138
交易账户下币币不支持只减仓功能	200	51139
逐仓自主划转保证金模式不支持提前挂单	200	51145
交易账户资产总价值需要大于5万美元来交易期权	200	51147
只减仓委托仅允许减少仓位数量，确保你的仓位不会增加	200	51148
下单超时，请稍候重试	500	51149
市价委托单笔价值不能超过 1,000,000 USDT	200	51201
市价单下单数量超出最大值	200	51202
普通委托数量超出最大限制{0}	200	51203
限价委托单价格不能为空	200	51204
不支持只减仓操作	200	51205
策略委托价格不在正确范围内	200	51250
策略委托类型错误	200	51251
策略委托数量不在正确范围内	200	51252
冰山委托单笔均值超限	200	51253
冰山委托单笔均值错误	200	51254
冰山委托单笔委托超限	200	51255
冰山委托深度错误	200	51256
跟踪委托回调服务错误，回调幅度限制为{0}<x<={1}%	200	51257
跟踪委托失败，卖单激活价格需大于最新成交价格	200	51258
跟踪委托失败，买单激活价格需小于最新成交价格	200	51259
每个用户最多可同时持有{0}笔未成交的跟踪委托	200	51260
每个用户最多可同时持有{0}笔未成交的止盈止损	200	51261
每个用户最多可同时持有{0}笔未成交的冰山委托	200	51262
每个用户最多可同时持有{0}笔未成交的时间加权单	200	51263
时间加权单笔均值超限	200	51264
时间加权单笔上限错误	200	51265
时间加权扫单比例出错	200	51267
时间加权扫单范围出错	200	51268
时间加权委托间隔错误，应为{0}<=x<={1}	200	51269
时间加权委托深度限制为 0<x<=1%	200	51270
时间加权委托失败，扫单比例应该为 0<x<=100%	200	51271
时间加权委托失败，扫单范围应该为 0<x<=1%	200	51272
时间加权委托总量应为大于 0	200	51273
时间加权委托总数量需大于单笔上限	200	51274
止盈止损市价单笔委托数量不能超过最大限制	200	51275
止盈止损市价单不能指定价格	200	51276
止盈触发价格不能大于最新成交价	200	51277
止损触发价格不能小于最新成交价	200	51278
止盈触发价格不能小于最新成交价	200	51279
止损触发价格不能大于最新成交价	200	51280
计划委托不支持使用tgtCcy参数	200	51281
吃单价优于盘口的比例范围	200	51282
时间间隔的范围{0}s~{1}s	200	51283
单笔数量的范围{0}~{1}	200	51284
委托总量的范围{0}~{1}	200	51285
下单金额需大于等于{0}	200	51286
策略不支持此合约	200	51287
策略正在停止中，请勿重复点击	200	51288
策略配置不存在，请稍后再试	200	51289
策略引擎正在升级，请稍后重试	200	51290
策略不存在或已停止	200	51291
策略类型不存在	200	51292
策略不存在	200	51293
该策略暂不能创建，请稍后再试	200	51294
PM账户不支持ordType为{0}的策略委托单	200	51295
交割、永续合约的买卖模式下，不支持计划委托	200	51298
止盈触发价格不能大于标记价格	200	51300
止损触发价格不能小于标记价格	200	51302
止盈触发价格不能小于标记价格	200	51303
止损触发价格不能大于标记价格	200	51304
止盈触发价格不能大于指数价格	200	51305
止损触发价格不能小于指数价格	200	51306
止盈触发价格不能小于指数价格	200	51307
止损触发价格不能大于指数价格	200	51308
集合竞价期间不能创建策略	200	51309
逐仓自主划转保证金模式不支持ordType为iceberg、twap的策略委托单	200	51310
移动止盈止损委托失败，回调幅度限制为{0}<x<={1}	200	51311
移动止盈止损委托失败，委托数量范围{0}<x<={1}	200	51312
逐仓自主划转模式不支持策略部分	200	51313
当前账户风险状态，仅支持降低账户风险方向的IOC订单	200	51037
当前风险模块下已经存在降低账户风险方向的IOC类型订单	200	51038
PM账户下交割和永续的全仓不能调整杠杆倍数	200	51039
期权逐仓的买方不能调整保证金	200	51040
撤单失败，订单不存在	200	51400
撤单失败，订单已撤销	200	51401
撤单失败，订单已完成	200	51402
撤单失败，该委托类型无法进行撤单操作	200	51403
价格发现第二阶段您不可撤单	200	51404
撤单失败，您当前没有未成交的订单	200	51405
撤单数量超过最大允许单数{0}	400	51406
ordIds 和 clOrdIds 不能同时为空	200	51407
币对 id 或币对名称与订单信息不匹配	200	51408
币对 id 或币对名称不能同时为空	200	51409
撤单失败，订单已处于撤销中	200	51410
用户没有执行mass cancel的权限	200	51411
委托已触发，暂不支持撤单	200	51412
价格和数量不能同时为空	200	51500
修改订单超过最大允许单数{0}	400	51501
修改订单失败，用户保证金不足	200	51502
修改订单失败,订单不存在	200	51503
订单类型不支持改单	200	51506
集合竞价第一阶段和第二阶段不允许改单	200	51508
修改订单失败,订单已撤销	200	51509
修改订单失败,订单已完成	200	51510
修改订单失败,订单价格不满足Post Only条件	200	51511
修改订单失败，PM账户下，批量改单不允许一批量请求中包含相同的订单	200	51512
改单校验失败，请稍后重试	200	51513
查询订单的状态不存在	200	51600
订单状态和订单id不能同时存在	200	51601
订单状态或订单id必须存在一个	200	51602
查询订单不存在	200	51603

数据类

错误提示	HTTP 状态码	错误码
没有最新行情信息	200	52000

资金类

错误码从 58000 到 58999

错误提示	HTTP 状态码	错误码
获取母账户余额，{0}不支持	200	58000
交易密码错误	200	58001
请先开通余币宝服务	200	58002
余币宝不支持该币种	200	58003
账户冻结	200	58004
申购/赎回额度不可超过{0}	200	58005
币种{0}不支持当前操作	200	58006
资金接口服务异常，请稍后再试。	200	58007
您没有该币种资产	200	58008
币对不存在	200	58009
行权或结算中，暂无法转入或转出	200	58100
划转冻结	200	58101
划转过于频繁，请降低划转频率	429	58102
您在法币区的交易异常，现已被限制划转功能，请您联系在线客服以解除限制	200	58104
您在法币区的交易异常，现已被限制划转功能，请您在网页或APP进行法币划转操作以完成身份验证	200	58105
请先开通币币杠杆账户	200	58106
请先开通交割合约账户	200	58107
请先开通期权合约账户	200	58108
请先开通永续合约账户	200	58109
当前交易产品触发市场风控，平台已暂停相关用户的资金转出功能，请耐心等待	200	58110
永续合约正在收取资金费，暂时无法做资金划转，请稍后重试	200	58111
资金划转失败，请稍后重试	200	58112
转账金额必须大于零（划转接口，金额输入不正确）	400	58114
子账户不存在	200	58115
转出数量大于最大可转数量	200	58116
账户资产异常，请先处理负资产后再划转	200	58117
该币种暂不支持从{0}提现至{1}，敬请谅解	200	58200
今日提现金额累计超过每日限额	200	58201
NEO最小提现数量为1，且提现数量必须为整数	200	58202
请先添加提现地址	200	58203
提现冻结	200	58204
提现金额大于单笔提现最大金额（单笔提现最大金额提现接口，提现金额输入有误）	200	58205
提现金额小于最小提现金额（最小提现金额提现接口，提现金额输入有误）	200	58206
提现失败，认证地址错误	200	58207
提现失败，邮箱未绑定	200	58208
子账户不能充值或提现	200	58209
提现手续费大于最大值（提现接口，提现手续费输入有误）	200	58210
提现手续费小于最小值（提现接口，手续费输入有误）	200	58211
提现手续费应填写为提币数量的{0}%	200	58212
提现前请先设置交易密码	200	58213
{chainName}维护中，暂停提币	200	58214
创建充值地址超过上限	200	58300
您的余额不足	200	58350
invoice已经过期	200	58351
invoice无效	200	58352
充币数量需要在限额范围内	200	58353
单日达到生成invoice10000个的上限	200	58354
用户没有使用此API接口的权限	200	58355
同节点账户不支持闪电网络充币或提币	200	58356
币种{0}不允许创建充值地址	200	58357
fromCcy与toCcy不可相同	200	58358

概览

入门指引

API使用方式

限速规则

API 介绍

REST API

公链基础模块

查询公链列表

HTTP请求

请求参数

返回参数

查询公链详情

HTTP请求

请求参数

返回参数

查询持币地址基础信息

HTTP请求

请求参数

返回参数

查询区块基础信息

HTTP请求

请求参数

返回参数

查询最佳手续费或Gas费

HTTP请求

请求参数

返回参数

查询算力基础信息

HTTP请求

请求参数

返回参数

查询挖矿基础信息

HTTP请求

请求参数

返回参数

查询链上交易信息

HTTP请求

请求参数

返回参数

区块模块

查询区块头明细

HTTP请求

请求参数

返回参数

查询区块列表

HTTP请求

请求参数

返回参数

查询区块交易列表

HTTP请求

请求参数

返回参数

地址模块

查询地址余额明细

HTTP请求

请求参数

返回参数

获取地址基本信息

HTTP请求

请求参数

返回参数

富豪地址排行榜TOP100

HTTP请求

请求参数

返回参数

查询地址交易列表信息

HTTP请求

请求参数

返回参数

查询地址UTXO交易

HTTP请求

请求参数

返回参数

挖矿模块

查询矿池份额

HTTP请求

请求参数

返回参数

查询查询矿池算力排名

HTTP请求