导航
English

概览

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 公链缩写符号,例如: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目前所支持的公链详情信息

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目前所支持的公链的持币地址的基本信息

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目前所支持的公链详区块的基础信息

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费的基础信息

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": "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 公链缩写符号,例如: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目前所支持的公链的挖矿基础信息

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目前所支持的公链链上交易础信息

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目前所支持的公链的区块明细。

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 公链缩写符号,例如:btceth,请求/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 公链缩写符号,例如:btceth,请求/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