API Key申请
OKLink为机构客户、开发者及研究者提供强大的API工具产品，API涵盖主流数字资产的多链实时数据、链上交易以及地址分析，可免除自建节点、同步区块以及运维的成本。
如需申请使用或需要更高调用频率请提供以下信息发送邮件至: [email protected]
- 姓名
- 邮箱
- 电话
- 微信
- 使用场景描述
入门指引
欢迎使用开发者文档。
使用流程
1、申请你的专属 key
2、联系管理员，添加 key
3、访问接口。
使用方式
- 将请求的 header 中添加(“x-apiKey”,yourApiKey)。
限速规则
访问次数限制根据用户角色确定，不同的角色设置不同的访问次数（例如 free 每月 500 次，common 每月 10000 次，vip 无限次）。
访问速率限根据用户角色确定，不同的角色设置不同的访问速率（例如 free 每分钟 60 次，common 每分钟 1000 次，vip 不设置限制。
API 概述
我们的 API 包括了对区块链、区块、交易、地址的查询，为了方便用户，我们还提供 了一系列统计接口，内容丰富，还能私人定制，满足您的需求。
REST API
通用接口
token 模糊匹配接口
根据输入的内容对 token 进行模糊匹配。
限速：10次/2s
HTTP 请求
GET /api/explorer/v1/{chain}/matchTokens
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/matchTokens
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| QueryString | q | String | 是 | 模糊搜索的代币符号，代币名称，合约地址 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"total":50,
"hits":[
{
"symbol":"BNB",
"coinName":"BNB",
"tokenContractAddress":"aadfsdfafdaffasdafs",
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| symbol | String | 符号 |
| coinName | String | 币种名称 |
| tokenContractAddress | String | 合约地址 |
主链通用查询接口
根据输入的高度/交易Hash/地址等数据返回查询的类型。
HTTP 请求
GET /api/explorer/v1/{chain}/search
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/search
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| QueryString | q | String/Long | 是 | 待查询的高度/交易Hash/地址 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"dataType":"BLOCK",
"chain":"BTC"
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| dataType | String | 数据类型，包括区块（block）/交易（transaction）/地址 （address） |
| chain | String | 链 |
查询链的详情
查询一个区块链的详情信息。
HTTP 请求
GET /api/explorer/v1/{chain}/info
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/info
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"id": 1,
"coinType": "chain",
"name": "bitcoin",
"symbol": "BTC",
"coinName": "Bitcoin",
"fullName": "Bitcoin (BTC)",
"websiteSlug": "bitcoin",
"iconPath": "https://oss.bafang.com/blockchain/icon/eth/BTC.jpg",
"rank": 1,
"mineable": true,
"algorithm": "SHA-256",
"proofType": "PoW",
"fullyPremined": false,
"preMinedValue": null,
"netHashesPerSecond": 91054733765.6216,
"blockReward": 12.5,
"blockPeriodTime": 600,
"circulatingSupply": 18018812.5,
"totalSupply": 18018812.5,
"maxSupply": 21000000,
"tokenAddress": null,
"firstBlockTime": null,
"firstBlockHeight": null,
"firstHistoricalData": null,
"lastHistoricalData": 1573747209390,
"lastSyncTime": 1573747209390,
"createTime": 1570691307644,
"updateTime": 1573747209390,
"icoPrice": null,
"market": {
"symbol": "BTC",
"marketSymbol": "CNY",
"price": 64922,
"volume24h": 190837349081.5128,
"percentChange1h": 0,
"percentChange24h": 0.5698582219203002,
"percentChange7d": 0,
"marketCap": 1170673140208.1343,
"timestamp": 1572872407
},
"address": {
"validAddressCount": 1102795,
"newAddressCount24h": 0
},
"block": {
"height": 603841,
"firstExchangeHistoricalTime": 0,
"firstBlockTime": 0,
"firstBlockHeight": 0,
"avgBlockInterval": 627,
"avgBlockSize24h": 0,
"avgBlockSize24hPercent": 0,
"mediaBlockSize": 0,
"halveTime": 0
}
"fee": {
"bestFeePerKbyte": 23332
"bestFeePerKwu": 0,
"bestFeePerKvbyte": 0,
"bestGasPrice": null
},
"globalDifficulty": {
"currentDiffculty": "12.72T",
"currentDiffcultyPercentChange": -0.07095469361664279,
"currentDiffcultyChangeTime": 1573169436000,
"currentDiffcultyChangeHeight": 602784,
"nextDiffculty": "12.45T",
"nextDiffcultyChangeTime": 1574373589000,
"nextDiffcultyChangeHeight": 0,
"nextDiffcultyPercentChange": -0.02153946011009916,
"nextDifficultyChangeBlock": 0
},
"hashes": {
"globalHashes": "92.89EH",
"globalHashesPercentChange24h": -3.2471268000960922
},
"mine": {
"avgMineReward24h": 0,
"minerIncomePerUnit": 1.1923362838585598,
"minerIncomePerUnitCoin": 0.00001836567394501956
},
"reduceReward": {
"nextReduceRewardTime": 1589821189000
"nextReduceRewardHeight": 630000
},
"transaction": {
"pendingTransactionCount": 3566
"transactionValue24h": 0,
"totalTransactionCount": 3815326,
"tranRate": 3.56,
"avgTransactionCount24h": 0,
"avgTransactionCount24hPercent": 0
},
"okchain": null,
"usdt": {
"fee": 23332,
"omiUsdtTotalSupply": 18018812.5,
"trxUsdtTotalSupply": 0,
"ethUsdtTotalSupply": 0,
"weekAddCoin": 0,
"weekDestoryCoin": 0
},
"trxUsdtTotalSupply": 0,
"ethUsdtTotalSupply": 0,
"coreAlgorithm": null,
"platformId": null,
"platform": null
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| id | Long | 唯一标识 |
| coinType | String | 币种类型 |
| name | String | 币种名称 |
| symbol | String | 符号 |
| coinName | String | 币种名称 |
| fullName | String | 币种全名 |
| websiteSlug | String | 货币互联网名称 |
| iconPath | String | 图标链接 |
| rank | Integer | 排名 |
| mineable | Boolean | 是否挖矿 |
| algorithm | String | 挖矿算法 |
| netHashesPerSecond | BigDecimal | 下次挖矿难度 |
| blockReward | Double | 区块奖励 |
| blockPeriodTime | BigDecimal | 出块时间 |
| circulatingSupply | Double | 流通量 |
| maxSupply | Double | 最大供应量 |
| tokenAddress | String | 合约地址 |
| firstBlockTime | Long | 第一个区块时间 |
| firstBlockHeight | Long | 第一个区块高度 |
| firstHistoricalData | Long | 最早交易时间 |
| lastHistoricalData | Long | 最晚交易时间 |
| lastSyncTime | Long | 上次同步时间 |
| createTime | Long | 创建时间 |
| updateTime | Long | 更新时间 |
| icoPrice | String | ICO 价格 |
| market | 行情信息 | |
| symbol | String | 符号 |
| marketSymbol | String | 法币符号 |
| price | Double | 价格 |
| volume24h | Double | 24 小时交易量 |
| percentChange1h | Double | 价格 1 小时涨幅 |
| percentChange24h | Double | 价格 24 小时涨幅 |
| percentChange7d | Double | 价格 7 天涨幅 |
| marketCap | Double | 市值 |
| timestamp | Long | 时间戳 |
| address | 地址信息 | |
| validAddressCount | Integer | 持币地址数量 |
| newAddressCount24h | Integer | 24 小时新增地址数 |
| block | 区块信息 | |
| height | Integer | 高度 |
| firstExchangeHistoricalTime | Long | 第一次交易时间 |
| firstBlockTime | Long | 第一个出块时间 |
| firstBlockHeight | Long | 第一个区块高度 |
| avgBlockInterval | Long | 平均出块时间 |
| avgBlockSize24h | Double | 24 小时平均区块大小 |
| avgBlockSize24hPercent | Double | 24 小时平均区块大小涨幅 |
| mediaBlockSize | Double | 一周区块中位数大小 |
| halveTime | Long | 减半时间 |
| fee | Long | 费用, 单位 satoshi |
| bestFeePerKbyte | BigInteger | 每 K 字节最佳手续费 |
| bestFeePerKwu | BigDecimal | 每 K 重量最佳手续费 |
| bestFeePerKvbyte | BigDecimal | 每 K 虚拟字节最佳手续费 |
| bestGasPrice | BigInteger | 最佳 Gas 价格 |
| globalDifficulty | 全网难度 | |
| currentDiffculty | String | 当前难度 |
| currentDiffcultyPercentChange | Double | 上次难度调整百分比 |
| currentDiffcultyChangeTime | Long | 上次难度调整时间 |
| currentDiffcultyChangeHeight | Long | 上次难度调整高度 |
| nextDiffculty | String | 预测下次难度 |
| nextDiffcultyChangeTime | Long | 预测下次难度调整时间 |
| nextDiffcultyChangeHeight | Long | 预测下次难度调整高度 |
| nextDiffcultyPercentChange | Double | 预测下次难度调整百分比 |
| nextDifficultyChangeBlock | Long | 预测下次难度调整区块 |
| hashes | 算力 | |
| globalHashes | String | 全网算力 |
| globalHashesPercentChange24h | Double | 全网算力 24 小时变化比分币 |
| mine | 挖矿 | |
| avgMineReward24h | Double | 24 小时平均挖矿奖励 |
| minerIncomePerUnit | Double | 每单位算力收益 |
| minerIncomePerUnitCoin | Double | 每单位算力收益币数 |
| reduceReward | 减半奖励 | |
| nextReduceRewardTime | Long | 预测下次产量减半时间 |
| nextReduceRewardHeight | Long | 预测下次产量减半高度 |
| transaction | 交易信息 | |
| pendingTransactionCount | Integer | 未确认交易数 |
| transactionValue24h | BigDecimal | 24 小时的链上交易量 |
| totalTransactionCount | Integer | 链上交易宗数 |
| tranRate | BigDecimal | 50 块平均 tps |
| avgTransactionCount24h | Double | 24 小时平均交易数量 |
| avgTransactionCount24hPercent | Double | 24 小时平均交易数量涨幅 |
| pendingTransactionSize | Double | pending 交易大小 |
查询链的基本统计信息
查询支持的区块链的汇总信息。
HTTP 请求
GET /api/explorer/v1/info/summary
请求示例
GET https://www.oklink.com/api/explorer/v1/info/summary
请求参数
无
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
{
"symbol":"BTC",
"price":72657,
"lastBlockTimeU0":1566991498,
"totalTransacationCount":449445678,
"totalSupply":17900250,
"totalSupplyPercent":0.8523928571428572,
"pendingTransactionCount":9890,
"runTime":1567001611630,
"pricePercentChange24h":-0.007104239350452387,
"height":592119
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| symbol | String | 符号 |
| price | Double | 价格 |
| lastBlockTimeU0 | Long | 上一个区块时间 |
| totalTransacationCount | Long | 交易总数 |
| totalSupply | Double | 流通量 |
| totalSupplyPercent | Double | 流通量占比 |
| pendingTransactionCount | Integer | 未确认交易总数 |
| runTime | Long | 运行时间 |
| pricePercentChange24h | Double | 24 小时价格变化 |
| height | Integer | 高度 |
统计接口
查询链的基本统计信息
查询一个区块链的基本统计信息。
HTTP 请求
GET /api/explorer/v1/{chain}/statistic/common
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/statistic/common
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| QueryString | Limit | Integer | 否 | 返回条数，默认首页图表需要的条数 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
{
"day":1567000800000,
"activeAddressCount":10,
"validAddressCount":10,
"newAddressCount":10,
"transactionCount":10,
"transactionValue":"12.12",
"transactionValuePercent":"-1.0000",
"activeAddressPercent":"-1.0000",
"validAddressPercent":"0.23",
"newAddressPercent":"0.23",
"transactionCountPercent":"-1.0000",
"pricePercent":"-0.0099",
"market":{
"symbol":"USDT",
"marketSymbol":"CNY",
"price":2193.58,
"volume24h":10047275360.93245,
"percentChange1h":0,
"percentChange24h":-0.8763967208936047,
"percentChange7d":0,
"marketCap":39484526848.115005,
"timestamp":1567000761
},
"price":"2193.5800"
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| day | Long | 时间 |
| activeAddressCount | String | 活跃地址数 |
| validAddressCount | String | 持币地址数 |
| newAddressCount | Integer | 新增地址数 |
| transactionCount | Integer | 交易数 |
| transactionValue | Double | 交易币数量 |
| transactionValuePercent | Double | 交易币数量 24 小时占比 |
| activeAddressPercent | Double | 活跃地址数 24 小时占比 |
| validAddressPercent | Double | 持币地址数 24 小时占比 |
| newAddressPercent | Double | 新增地址数 24 小时占比 |
| transactionCountPercent | Double | 交易数 24 小时占比 |
| pricePercent | Double | 价格 24 小时占比 |
| market | 行情信息 | |
| symbol | String | 符号 |
| marketSymbol | String | 法币符号 |
| price | Double | 价格 |
| volume24h | Double | 24 小时交易量 |
| percentChange1h | Double | 价格 1 小时涨幅 |
| percentChange24h | Double | 价格 24 小时涨幅 |
| percentChange7d | Double | 价格 7 天涨幅 |
| marketCap | Double | 市值 |
| timestamp | Long | 时间戳 |
| price | Double | 价格 |
查询当前大额交易统计
查询一个区块链的 24 小时大额转账信息。
HTTP 请求
GET /api/explorer/v1/{chain}/statistic/large/transfer/lastest
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/statistic/large/transfer/lastest
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": [
{
"datetime": 1572505723,
"transferRangeFrom": 2000,
"transferRangeTo": 0,
"transferCount": 0,
"transferValue": 0.0,
"transferAddressCount": 0,
"market": {
"symbol": "BTC",
"marketSymbol": "CNY",
"price": 64922.0,
"volume24h": 1.908373490815128E11,
"percentChange1h": 0.0,
"percentChange24h": 0.5698582219203002,
"percentChange7d": 0.0,
"marketCap": 1.1706731402081343E12,
"timestamp": 1572872407
}
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| datetime | Long | 时间 |
| transferRangeFrom | Integer | 转账数量起点 |
| transferRangeTo | Integer | 转账数量终点 |
| transferCount | Integer | 转帐笔数 |
| transferValue | Double | 转账总币数 |
| transferAddressCount | Integer | 转账的地址数 |
| market | 行情信息 | |
| symbol | String | 符号 |
| marketSymbol | String | 法币符号 |
| price | Double | 价格 |
| volume24h | Double | 24 小时交易量 |
| percentChange1h | Double | 价格 1 小时涨幅 |
| percentChange24h | Double | 价格 24 小时涨幅 |
| percentChange7d | Double | 价格 7 天涨幅 |
| marketCap | Double | 市值 |
| timestamp | Long | 时间戳 |
查询当前持仓分布统计
查询一个区块链的主链币或代币的持仓分布统计。
HTTP 请求
GET /api/explorer/v1/{chain}/statistic/richers/stat
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/statistic/richers/stat
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | tokenId | String | 否 | 统计的代币id，默认为null，统计主链币种 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": [
{
"holderRangeFrom": 1,
"holderRangeTo": 100,
"addressCount": 100,
"holdersValue": 2604892.0049283006,
"percentRate": 0.1456
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| holderRangeFrom | Integer | 排名起点 |
| holderRangeTo | Integer | 排名终点 |
| addressCount | Integer | 地址总数 |
| holdersValue | Double | 持币总数 |
| percentRate | Double | 占比 |
区块接口
查询区块列表
查询一个区块链的区块列表，区块的排序默认为区块高度倒序。
HTTP 请求
GET /api/explorer/v1/{chain}/blocks
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/blocks
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | offset | Integer | 否 | 起始位置，默认 0 |
| queryString | limit | Integer | 否 | 返回条数，默认 20 条 |
| queryString | Sort | String | 否 | 排序，规则为field：desc/asc；支持的排序字段为height、timestamp，默认height倒序 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": {
"total": 590801,
"hits": [
{
"hash": "0000000000000000001b406f5ebabb45bb9d6d62d6992b343335188ce4c4ffc1",
"height": 580640,
"transactionCount": 2292,
"previousBlockHash": "0000000000000000001f00b6c00780b8d3bbef6106e9c2f3781c747317abc8f2",
"nextBlockHash": "00000000000000000010784a6225f02f82a9e14b5e4087a37cc2fe7a7e1cb41b",
"blocktime": 1560494759,
"legalRate": 56874.531124,
"size": 1149545,
"version": 536870912,
"merkleRoot": "2731759ff86e9083cad7ea872178c3ab4c9e0836b123d4df1ab58c5537ef8435",
"inputsCount": 6146,
"outputsCount": 5486,
"inputsValue": 3438.6456265,
"outputsValue": 3451.1456265,
"nonce": "0xb17d5e36",
"minerHash": "18cBEMRxXHqzWWCxZNtU91F5sbUNKhL5PX",
"reward": 1250000000,
"fee": 28423704,
"feePerKbyte": 24733,
"blockReward": 1278423704,
"aux": true,
"bits": "0x1725fd03",
"difficulty": 7409399249090.253,
"mineDifficulty": 10328557357853.107,
"chainwork": "000000000000000000000000000000000000000006abc18bcec54323d3aab079",
"coinbaseDataHex": "0320dc08082f5669614254432f2cfabe6d6deda0cc7684dc7256d1f6797cad93768a da2eb953a3807c61826fdfa38906e4ef1000000000000000100459071037049bba43 377e3e3d280300",
"inputsValueSat": 343864562650,
"outputsValueSat": 345114562650,
"coindaysDestroyed": 2455583199983,
"medianTime": 1560493002,
"feePerKwu": 7120,
"witnessCount": 1829,
"weight": 3992777,
"strippedSize": 947744,
"btcDifficulty": "7.41T",
"btcMineDifficulty": "10.33T",
"minepoolName": "aaa",
"minepoolCode": "bbb",
"minepoolLogoUrl": "ccc",
"minepoolUrl": "ddd"
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| height | Integer | 高度 |
| size | Integer | 大小 |
| timestamp | Long | 出块的时间 |
| guessedMiner | String | 矿池标识 |
| guessedMinerName | String | 矿池名称 |
| reward | Long | 挖矿奖励，单位 satoshi |
| fee | Long | 费用，单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| blockReward | Long | 总奖励，单位 satoshi |
| transactionCount | Integer | 交易数 |
| wintnessCount | Integer | 隔离见证交易数量 |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| inputsValue | Double | 输入总量 |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| outputsValue | Double | 输出总量 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| legalRate | Double | 兑法币汇率 |
| sizeLevel | Integer | 区块体积的level，从小到大，以256K为基数，每增加256K表示增加一个等级，共6个等级，0-5，前端可以使用该等级显示颜色 |
| minerName | String | 矿池名称 |
| minerCode | String | 矿池url |
| minerLogoUrl | String | 矿池图标的地址 |
查询区块详情
查询一个区块链的区块详情。
HTTP 请求
GET /api/explorer/v1/{chain}/blocks/{heightHash|lastest}
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/blocks/{heightHash|lastest}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| Path | height hash lastest | Integer | 否 | 区块高度或区块hash，为lastest获取最新区块 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": {
"hash": "0000000000000000001b406f5ebabb45bb9d6d62d6992b343335188ce4c4ffc1",
"height": 580640,
"transactionCount": 2292,
"previousBlockHash": "0000000000000000001f00b6c00780b8d3bbef6106e9c2f3781c747317abc8f2",
"nextBlockHash": "00000000000000000010784a6225f02f82a9e14b5e4087a37cc2fe7a7e1cb41b",
"blocktime": 1560494759,
"legalRate": 56874.531124,
"size": 1149545,
"version": 536870912,
"merkleRoot": "2731759ff86e9083cad7ea872178c3ab4c9e0836b123d4df1ab58c5537ef8435",
"inputsCount": 6146,
"outputsCount": 5486,
"inputsValue": 3438.6456265,
"outputsValue": 3451.1456265,
"nonce": "0xb17d5e36",
"minerHash": "18cBEMRxXHqzWWCxZNtU91F5sbUNKhL5PX",
"reward": 1250000000,
"fee": 28423704,
"feePerKbyte": 24733,
"blockReward": 1278423704,
"aux": true,
"bits": "0x1725fd03",
"difficulty": 7409399249090.253,
"mineDifficulty": 10328557357853.107,
"chainwork": "000000000000000000000000000000000000000006abc18bcec54323d3aab079",
"coinbaseDataHex": "0320dc08082f5669614254432f2cfabe6d6deda0cc7684dc7256d1f6797cad93768a da2eb953a3807c61826fdfa38906e4ef1000000000000000100459071037049bba43 377e3e3d280300",
"inputsValueSat": 343864562650,
"outputsValueSat": 345114562650,
"coindaysDestroyed": 2455583199983,
"medianTime": 1560493002,
"feePerKwu": 7120,
"witnessCount": 1829,
"weight": 3992777,
"strippedSize": 947744,
"btcDifficulty": "7.41T",
"btcMineDifficulty": "10.33T",
"minepoolName": "aaa",
"minepoolCode": "bbb",
"minepoolLogoUrl": "ccc",
"minepoolUrl": "ddd"
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| height | Integer | 高度 |
| size | Integer | 大小 |
| timestamp | Long | 出块的时间 |
| guessedMiner | String | 矿池标识 |
| guessedMinerName | String | 矿池名称 |
| reward | Long | 挖矿奖励，单位 satoshi |
| fee | Long | 费用，单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| blockReward | Long | 总奖励，单位 satoshi |
| transactionCount | Integer | 交易数 |
| wintnessCount | Integer | 隔离见证交易数量 |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| inputsValue | Double | 输入总量 |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| outputsValue | Double | 输出总量 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| legalRate | Double | 兑法币汇率 |
| sizeLevel | Integer | 区块体积的level，从小到大，以256K为基数，每增加256K表示增加一个等级，共6个等级，0-5，前端可以使用该等级显示颜色 |
| minerName | String | 矿池名称 |
| minerCode | String | 矿池 url |
| minerLogoUrl | String | 矿池图标的地址 |
查询矿池出块列表
查询一个区块链的矿池出块列表，默认为区块高度倒序。
HTTP 请求
GET /api/explorer/v1/{chain}/blocks
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/blocks
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | type | String | 是 | 唯一值：pool，表示基于矿池查询区块 |
| queryString | pool | String | 是 | 矿池标识 |
| queryString | offset | Integer | 否 | 起始位置，默认 0 |
| queryString | limit | Integer | 否 | 返回条数，默认 10 条 |
| queryString | sort | String | 否 | 排序，规则为：field:desc/asc，支持的排序字段为height，timestamp，默认height倒序 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": {
"total": 590801,
"hits": [
{
"hash": "0000000000000000001b406f5ebabb45bb9d6d62d6992b343335188ce4c4ffc1",
"height": 580640,
"transactionCount": 2292,
"previousBlockHash": "0000000000000000001f00b6c00780b8d3bbef6106e9c2f3781c747317abc8f2",
"nextBlockHash": "00000000000000000010784a6225f02f82a9e14b5e4087a37cc2fe7a7e1cb41b",
"blocktime": 1560494759,
"legalRate": 56874.531124,
"size": 1149545,
"version": 536870912,
"merkleRoot": "2731759ff86e9083cad7ea872178c3ab4c9e0836b123d4df1ab58c5537ef8435",
"inputsCount": 6146,
"outputsCount": 5486,
"inputsValue": 3438.6456265,
"outputsValue": 3451.1456265,
"nonce": "0xb17d5e36",
"minerHash": "18cBEMRxXHqzWWCxZNtU91F5sbUNKhL5PX",
"reward": 1250000000,
"fee": 28423704,
"feePerKbyte": 24733,
"blockReward": 1278423704,
"aux": true,
"bits": "0x1725fd03",
"difficulty": 7409399249090.253,
"mineDifficulty": 10328557357853.107,
"chainwork": "000000000000000000000000000000000000000006abc18bcec54323d3aab079",
"coinbaseDataHex": "0320dc08082f5669614254432f2cfabe6d6deda0cc7684dc7256d1f6797cad93768a da2eb953a3807c61826fdfa38906e4ef1000000000000000100459071037049bba43 377e3e3d280300",
"inputsValueSat": 343864562650,
"outputsValueSat": 345114562650,
"coindaysDestroyed": 2455583199983,
"medianTime": 1560493002,
"feePerKwu": 7120,
"witnessCount": 1829,
"weight": 3992777,
"strippedSize": 947744,
"btcDifficulty": "7.41T",
"btcMineDifficulty": "10.33T",
"minepoolName": "aaa",
"minepoolCode": "bbb",
"minepoolLogoUrl": "ccc",
"minepoolUrl": "ddd"
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| height | Integer | 高度 |
| size | Integer | 大小 |
| timestamp | Long | 出块的时间 |
| guessedMiner | String | 矿池标识 |
| guessedMinerName | String | 矿池名称 |
| reward | Long | 挖矿奖励，单位 satoshi |
| fee | Long | 费用，单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| blockReward | Long | 总奖励，单位 satoshi |
| transactionCount | Integer | 交易数 |
| wintnessCount | Integer | 隔离见证交易数量 |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| inputsValue | Double | 输入总量 |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| outputsValue | Double | 输出总量 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| legalRate | Double | 兑法币汇率 |
| sizeLevel | Integer | 区块体积的level，从小到大，以256K为基数，每增加256K表示增加一个等级，共6个等级，0-5，前端可以使用该等级显示颜色 |
| minerName | String | 矿池名称 |
| minerCode | String | 矿池 url |
| minerLogoUrl | String | 矿池图标的地址 |
交易接口
查询交易列表
查询一个区块链的交易列表,条件查询交易的排序默认为区块高度倒序，index正序，主页交易列表为高度倒序，index倒序。
HTTP 请求
GET /api/explorer/v1/{chain}/transactions
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/transactions
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | blockHash | String | 否 | 区块哈希 |
| queryString | blockHeight | Long | 否 | 区块高度 |
| queryString | offset | Integer | 否 | 起始位置，默认 0 |
| queryString | limit | Integer | 否 | 返回条数，默认 20 条 |
| queryString | sort | String | 否 | 排序，规则为：field:desc/asc，支持的排序字段为 blockHeight,index,timestamp，默认blockHeight倒序+index asc |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": {
"total": 3196783,
"scrollId": null,
"hits": [
{
"hash": "3bbcf905c61831b7558936e03ff5257baa6f6dcc629796cea7bf7af16acfb9b7",
"blocktime": 1573211898,
"legalRate": 64922,
"index": 2326,
"blockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"blockHeight": 602850,
"coinbase": false,
"size": 250,
"version": 1,
"doubleSpend": false,
"fee": 500,
"feePerKbyte": 2000,
"inputsCount": 1,
"outputsCount": 2,
"inputsValue": 0.00354234,
"outputsValue": 0.00353734,
"realTransferValue": 0.00348017,
"inputsValueSat": 354234,
"outputsValueSat": 353734,
"realTransferValueSat": 348017,
"inputs": [
{
"prevBlockHash": "0000000000000000000efd376141e80ec85b8c3b57cd0dde9739806321b0d730",
"prevAddresses": [ "325TBWEEv5dpBvCppYGKfoEshro6PP64np" ],
"scriptType": "P2SH_P2WPKH",
"vinIndex": 0,
"prevBlockHeight": 602849,
"prevTxhash": "1b3dad3bc83b3d518ee1eb6d9ffa83275a550e66a4263b2daedbcd3dcb21783e",
"prevVoutIndex": 0,
"prevValueSat": 354234,
"prevValue": 0.00354234,
"prevBlocktime": 1573211540,
"prevScriptType": "P2SH",
"scriptHex": "160014eaff5e6d6ce5fd8cbd2ee6cabc58c6e4973f046c",
"scriptData": "",
"sequence": 4294967293,
"lifespan": 358,
"coindaysDestroyed": 1467,
"witness": [ "3045022100c0a5b0e2708e42fbcc746e029da6616cfe78e8c5b2c 448b833381ba12a168da702204ab212d7856a90d88d3911671a8c973e42fd0b1984 2a86741475c9780b06403201", "02cb2dbdbcedbfb0bfd33a34f243a62122bd60739f3c465f0b44f3 e650bfa1be12"
]
}
],
"outputs": [
{
"addresses": [
"1Ep36WYw8LctrT7XhQpYuzWVQZeQWZFi5q"
],
"scriptType": "P2PKH",
"voutIndex": 0,
"valueSat": 347517,
"value": 0.00347517,
"fromCoinbase": false,
"spent": false,
"spentBlockHeight": -1,
"spentBlockHash": "",
"spentTxhash": "",
"spentVinIndex": -1,
"spentBlocktime": -1,
"scriptAsm": "OP_DUP OP_HASH160 977eef27fb7cec70417c9f0545a96e7fe5b3a1c6 OP_EQUALVERIFY OP_CHECKSIG",
"scriptHex": "76a914977eef27fb7cec70417c9f0545a96e7fe5b3a1c688ac",
"outputType": "Spendable"
},
{
"addresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH",
"voutIndex": 1,
"valueSat": 6217,
"value": 0.00006217,
"fromCoinbase": false,
"spent": true,
"spentBlockHeight": 602850,
"spentBlockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"spentTxhash": "d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3",
"spentVinIndex": 0,
"spentBlocktime": 1573211898,
"scriptAsm": "OP_HASH160 043e3c4552688c5a4b5358bd50651457127a70fa OP_EQUAL",
"scriptHex": "a914043e3c4552688c5a4b5358bd50651457127a70fa87",
"outputType": "Spendable"
}
],
"lockTime": 0,
"coindaysDestroyed": 1467,
"sigops": 1,
"strippedSize": 140,
"virtualSize": 168,
"weight": 670,
"hasWitness": true,
"witnessHash": "f2191fdce43988b670f89e9cdedb71614a8163c18089e2f03a0f8da7717bb86a",
"feePerKwu": 746,
"feePerKvbyte": 2976,
"confirm": 1,
"realAddressBalance": 0
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| blocktime | Long | 区块时间 |
| legalRate | Double | 兑法币汇率 |
| index | Long | 交易索引 |
| blockHash | String | 区块哈希 |
| blockHeight | Integer | 区块高度 |
| coinbase | Boolean | 是否为coinbase交易 |
| size | Integer | 交易大小 |
| version | Long | 版本 |
| doubleSpend | Boolean | 是否双花 |
| fee | Long | 费用, 单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValue | Double | 输入总量 |
| outputsValue | Double | 输出总量 |
| realTransferValue | Double | 实际交易金额 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| realTransferValueSat | Long | 交易总量 |
| inputs | Array | 输入列表 |
| prevAddresses | String Array | 前一输出地址 |
| scriptType | String | 脚本类型 |
| vinIndex | Integer | 在交易中的位置 |
| prevBlockHeight | Integer | 前一区块高度 |
| prevTxhash | String | 前一输出交易哈希 |
| prevVoutIndex | Integer | 前一输出在交易的位置 |
| prevValueSat | Long | 前一输出数量，单位 satoshi |
| prevValue | Double | 前一输出数量 |
| prevBlocktime | Long | 前一输出交易时间 |
| prevScriptType | String | 前一输出脚本类型 |
| scriptHex | String | 脚本数据 |
| scriptData | String | 脚本显示数据 |
| sequence | Long | 输入序列 |
| lifespan | Integer | output 存活时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| witness | String array | 隔离见证签名数据 |
| outputs | Array | 输出列表 |
| addresses | String array | 输出地址 |
| scriptType | String | 脚本类型 |
| voutIndex | Integer | 输出位置 |
| valueSat | Long | 输出数量，单位 satoshi |
| value | Double | 输出数量 |
| fromCoinbase | Boolean | 是否coinbase输出 |
| spent | Boolean | 是否已经花费 |
| spentBlockHeight | Integer | 花费区块高度 |
| spentBlockHash | String | 花费区块hash |
| spentTxhash | String | 花费交易 hash |
| spentVinIndex | Integer | 花费 input 位置 |
| spentBlocktime | Long | 花费区块时间 |
| scriptAsm | String | 脚本asm |
| scriptHex | String | 脚本数据 |
| ouputType | String | ouput类型 分为：spendable, segwit, unknow |
| lockTime | Long | 锁定时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| sigops | Integer | 交易中的签名数量 |
| strippedSize | Integer | 基础交易大小 |
| virtualSize | Integer | 虚拟大小 |
| weight | Integer | 重量 |
| hasWitness | Boolean | 是否包含隔离见证交易 |
| witnessHash | String | 隔离见证哈希 |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| feePerKvbyte | Long | 每 K 虚拟字节费用，单位 satoshi |
| confirm | Integer | 确认数 |
| realAddressBalance | Double | 地址余额 |
查询交易详情
查询一个区块链的交易详情，该接口将同时支持未确认交易及已确认交易的查询，未确认与已确认交易的区别在于返回的区块高度数据是否存在。
HTTP 请求
GET /api/explorer/v1/{chain}/transactions/{hash}
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/transactions/{hash}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| Path | hash | String | 是 | 交易 hash |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": {
"hash": "5554fcec49e919347205aa6e7487d0d6b956ee505bbcf 43739153070b8da618e",
"blocktime": 1576355590,
"legalRate": 10081.89,
"index": 181,
"blockHash": "0000000000000000000ff6ac728cedff8cbcd04e 4d77e54de0aa77d10d9996b1",
"blockHeight": 608141,
"coinbase": false,
"size": 257,
"version": 2,
"doubleSpend": false,
"fee": 5140,
"feePerKbyte": 20000,
"inputsCount": 1,
"outputsCount": 2,
"inputsValue": 1499.0986048,
"outputsValue": 1499.0985534,
"realTransferValue": 1499.0986048,
"inputsValueSat": 149909860480,
"outputsValueSat": 149909855340,
"realTransferValueSat": 149909860480,
"inputs": [
{
"prevAddresses": [
"19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ"
]，
"scriptType": "P2PKH",
"vinIndex": 0,
"prevBlockHeight": 581174,
"prevTxhash": "0130cbdc86f81aedeb65afca20add3db8f92 c296e7c92cb07cfbf9ac91265f02",
"prevVoutIndex": 0,
"prevValueSat": 149909860480,
"prevValue": 1499.0986048,
"prevBlocktime": 1560813252,
"prevScriptType": "P2PKH",
"scriptHex": "47304402201392300e8a660d34c4f98eab85 0874a574174a4868db9625ee9d8d244a54603002202d1e231724c5 0e3ed4e76567467ee24aeb2ed5bb78b62b225ebec674d7a2b7de014 10442b804899a46342d0668eb257ca7ac67aef3a91e5b9468b6747c 32e69ae661c925cc5869f6fa676c8960156688ab8551dda4757999ea 275765ae63a135bd295b",
"scriptData": "",
"sequence": 4294967293,
"lifespan": 15542338,
"coindaysDestroyed": 26967010661030
}
],
"outputs": [
{
"addresses": [
"1AvtcQYQiwwJkHZsExVHmjf12qbCWR48t6"
],
"scriptType": "P2PKH",
"voutIndex": 0,
"valueSat": 4000000000,
"value": 40.0,
"fromCoinbase": false,
"spent": true,
"spentBlockHeight": 608143,
"spentBlockHash": "0000000000000000000ca127a3835e 0e1dc6608801bbe5b3bd9f374d2b1d4ccc",
"spentTxhash": "5f48c0f3c0cfcc88c263464841c74c4fd05 b6f5ca181b28b8f5c11a358b54a12",
"spentVinIndex": 0,
"spentBlocktime": 1576357017,
"scriptAsm": "OP_DUP OP_HASH160 6cea42a0638e3caf 79a1624a3649b8c996afba74 OP_EQUALVERIFY OP_CHECKSIG ",
"scriptHex": "76a9146cea42a0638e3caf79a1624a3649b8 c996afba7488ac",
"outputType": "Spendable"
},
{
"addresses": [
"19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2"
],
"scriptType": "P2PKH",
"voutIndex": 1,
"valueSat": 145909855340,
"value": 1459.0985534,
"fromCoinbase": false,
"spent": false,
"spentBlockHeight": -1,
"spentBlockHash": "",
"spentTxhash": "",
"spentVinIndex": -1,
"spentBlocktime": -1,
"scriptAsm": "OP_DUP OP_HASH160 5ad08fb4e408998 7b68a20d681216ae8b3003963 OP_EQUALVERIFY OP_CHECKSI G",
"scriptHex": "76a9145ad08fb4e4089987b68a20d681216a e8b300396388ac",
"outputType": "Spendable"
}
],
"lockTime": 608140,
"coindaysDestroyed": 26967010661030,
"sigops": 2,
"strippedSize": 257,
"virtualSize": 257,
"weight": 1028,
"hasWitness": false,
"witnessHash": "",
"feePerKwu": 5000,
"feePerKvbyte": 20000,
"confirm": 9769,
"realAddressBalance": 0,
"tagMap": {
"19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ":
["tag": "huobi"]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| blocktime | Long | 区块时间 |
| legalRate | Double | 兑法币汇率 |
| index | Long | 交易索引 |
| blockHash | String | 区块哈希 |
| blockHeight | Integer | 区块高度 |
| coinbase | Boolean | 是否为coinbase交易 |
| size | Integer | 交易大小 |
| version | Long | 版本 |
| doubleSpend | Boolean | 是否双花 |
| fee | Long | 费用, 单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValue | Double | 输入总量 |
| outputsValue | Double | 输出总量 |
| realTransferValue | Double | 实际交易金额 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| realTransferValueSat | Long | 交易总量 |
| inputs | Array | 输入列表 |
| prevAddresses | String Array | 前一输出地址 |
| scriptType | String | 脚本类型 |
| vinIndex | Integer | 在交易中的位置 |
| prevBlockHeight | Integer | 前一区块高度 |
| prevTxhash | String | 前一输出交易哈希 |
| prevVoutIndex | Integer | 前一输出在交易的位置 |
| prevValueSat | Long | 前一输出数量，单位 satoshi |
| prevValue | Double | 前一输出数量 |
| prevBlocktime | Long | 前一输出交易时间 |
| prevScriptType | String | 前一输出脚本类型 |
| scriptHex | String | 脚本数据 |
| scriptData | String | 脚本显示数据 |
| sequence | Long | 输入序列 |
| lifespan | Integer | output 存活时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| witness | String array | 隔离见证签名数据 |
| outputs | Array | 输出列表 |
| addresses | String array | 输出地址 |
| scriptType | String | 脚本类型 |
| voutIndex | Integer | 输出位置 |
| valueSat | Long | 输出数量，单位 satoshi |
| value | Double | 输出数量 |
| fromCoinbase | Boolean | 是否coinbase输出 |
| spent | Boolean | 是否已经花费 |
| spentBlockHeight | Integer | 花费区块高度 |
| spentBlockHash | String | 花费区块hash |
| spentTxhash | String | 花费交易hash |
| spentVinIndex | Integer | 花费input位置 |
| spentBlocktime | Long | 花费区块时间 |
| scriptAsm | String | 脚本asm |
| scriptHex | String | 脚本数据 |
| ouputType | String | ouput类型 分为：spendable, segwit, unknow |
| lockTime | Long | 锁定时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| sigops | Integer | 交易中的签名数量 |
| strippedSize | Integer | 基础交易大小 |
| virtualSize | Integer | 虚拟大小 |
| weight | Integer | 重量 |
| hasWitness | Boolean | 是否包含隔离见证交易 |
| witnessHash | String | 隔离见证哈希 |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| feePerKvbyte | Long | 每 K 虚拟字节费用，单位 satoshi |
| confirm | Integer | 确认数 |
| realAddressBalance | Double | 地址余额 |
| tagMap | Map | 标签map，地址哈希为key，value为标签数组 |
查询区块交易列表
查询一个高度的区块的交易列表
HTTP 请求
GET /api/explorer/v1/{chain}/transactionNoRestrict
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/transactionNoRestrict
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | blockHeight | Integer | 是 | 区块高度 |
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认20条 |
| queryString | sort | String | 否 | 排序，规则为：field:desc/asc，默认blockHeight倒序 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data": {
"total": 3196783,
"scrollId": null,
"hits": [
{
"hash": "3bbcf905c61831b7558936e03ff5257baa6f6dcc629796cea7bf7af16acfb9b7",
"blocktime": 1573211898,
"legalRate": 64922,
"index": 2326,
"blockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"blockHeight": 602850,
"coinbase": false,
"size": 250,
"version": 1,
"doubleSpend": false,
"fee": 500,
"feePerKbyte": 2000,
"inputsCount": 1,
"outputsCount": 2,
"inputsValue": 0.00354234,
"outputsValue": 0.00353734,
"realTransferValue": 0.00348017,
"inputsValueSat": 354234,
"outputsValueSat": 353734,
"realTransferValueSat": 348017,
"inputs": [
{
"prevBlockHash": "0000000000000000000efd376141e80ec85b8c3b57cd0dde9739806321b0d730",
"prevAddresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH_P2WPKH",
"vinIndex": 0,
"prevBlockHeight": 602849,
"prevTxhash": "1b3dad3bc83b3d518ee1eb6d9ffa83275a550e66a4263b2daedbcd3dcb21783e",
"prevVoutIndex": 0,
"prevValueSat": 354234,
"prevValue": 0.00354234,
"prevBlocktime": 1573211540,
"prevScriptType": "P2SH",
"scriptHex": "160014eaff5e6d6ce5fd8cbd2ee6cabc58c6e4973f046c",
"scriptData": "",
"sequence": 4294967293,
"lifespan": 358,
"coindaysDestroyed": 1467,
"witness": [
"3045022100c0a5b0e2708e42fbcc746e029da6616cfe78e8c5b2c448b833381ba12a168da702204ab212d7856a90d88d3911671a8c973e42fd0b19842a86741475c9780b06403201",
"02cb2dbdbcedbfb0bfd33a34f243a62122bd60739f3c465f0b44f3e650bfa1be12"
]
}
],
"outputs": [
{
"addresses": [
"1Ep36WYw8LctrT7XhQpYuzWVQZeQWZFi5q"
],
"scriptType": "P2PKH",
"voutIndex": 0,
"valueSat": 347517,
"value": 0.00347517,
"fromCoinbase": false,
"spent": false,
"spentBlockHeight": -1,
"spentBlockHash": "",
"spentTxhash": "",
"spentVinIndex": -1,
"spentBlocktime": -1,
"scriptAsm": "OP_DUP OP_HASH160 977eef27fb7cec70417c9f0545a96e7fe5b3a1c6 OP_EQUALVERIFY OP_CHECKSIG",
"scriptHex": "76a914977eef27fb7cec70417c9f0545a96e7fe5b3a1c688ac",
"outputType": "Spendable"
},
{
"addresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH",
"voutIndex": 1,
"valueSat": 6217,
"value": 0.00006217,
"fromCoinbase": false,
"spent": true,
"spentBlockHeight": 602850,
"spentBlockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"spentTxhash": "d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3",
"spentVinIndex": 0,
"spentBlocktime": 1573211898,
"scriptAsm": "OP_HASH160 043e3c4552688c5a4b5358bd50651457127a70fa OP_EQUAL",
"scriptHex": "a914043e3c4552688c5a4b5358bd50651457127a70fa87",
"outputType": "Spendable"
}
],
"lockTime": 0,
"coindaysDestroyed": 1467,
"sigops": 1,
"strippedSize": 140,
"virtualSize": 168,
"weight": 670,
"hasWitness": true,
"witnessHash": "f2191fdce43988b670f89e9cdedb71614a8163c18089e2f03a0f8da7717bb86a",
"feePerKwu": 746,
"feePerKvbyte": 2976,
"confirm": 1,
"realAddressBalance": 0
}
]
"extend": {
"19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ":
"okex"],
"19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2":
"huobi",
"id": "19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2"
}
}
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| blocktime | Long | 区块时间 |
| legalRate | Double | 兑法币汇率 |
| index | Long | 交易索引 |
| blockHash | String | 区块哈希 |
| blockHeight | Integer | 区块高度 |
| coinbase | Boolean | 是否为 coinbase 交易 |
| size | Integer | 交易大小 |
| version | Long | 版本 |
| doubleSpend | Boolean | 是否双花 |
| fee | Long | 费用，单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValue | Double | 输入总量 |
| outputsValue | Double | 输出总量 |
| realTransferValue | Double | 实际交易金额 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| realTransferValueSat | Long | 交易总量 |
| inputs | Array | 输入列表 |
| prevAddresses | String Array | 前一输出地址 |
| scriptType | String | 脚本类型 |
| vinIndex | Integer | 在交易中的位置 |
| prevBlockHeight | Integer | 前一区块高度 |
| prevTxhash | String | 前一输出交易哈希 |
| prevVoutIndex | Integer | 前一输出在交易的位置 |
| prevValueSat | Long | 前一输出数量，单位 satoshi |
| prevValue | Double | 前一输出数量 |
| prevBlocktime | Long | 前一输出交易时间 |
| prevScriptType | String | 前一输出脚本类型 |
| scriptHex | String | 脚本数据 |
| scriptData | String | 脚本显示数据 |
| sequence | Long | 输入序列 |
| lifespan | Integer | output 存活时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| witness | String array | 隔离见证签名数据 |
| outputs | Array | 输出列表 |
| addresses | String array | 输出地址 |
| scriptType | String | 脚本类型 |
| voutIndex | Integer | 输出位置 |
| valueSat | Long | 输出数量，单位 satoshi |
| value | Double | 输出数量 |
| fromCoinbase | Boolean | 是否 coinbase 输出 |
| spent | Boolean | 是否已经花费 |
| spentBlockHeight | Integer | 花费区块高度 |
| spentBlockHash | String | 花费区块hash |
| spentTxhash | String | 花费交易 hash |
| spentVinIndex | Integer | 花费 input 位置 |
| spentBlocktime | Long | 花费区块时间 |
| scriptAsm | String | 脚本 asm |
| scriptHex | String | 脚本数据 |
| ouputType | String | ouput 类型 分为：spendable, segwit, unknow |
| lockTime | Long | 锁定时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| sigops | Integer | 交易中的签名数量 |
| strippedSize | Integer | 基础交易大小 |
| virtualSize | Integer | 虚拟大小 |
| weight | Integer | 重量 |
| hasWitness | Boolean | 是否包含隔离见证交易 |
| witnessHash | String | 隔离见证哈希 |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| feePerKvbyte | Long | 每 K 虚拟字节费用，单位 satoshi |
| confirm | Integer | 确认数 |
| realAddressBalance | Double | 地址余额 |
| textend | Map | 标签map，地址hash为key，value为标签数组 |
查询大额交易列表
查询一个区块链的大额交易列表，交易的排序默认为区块高度倒序，index正序。
HTTP 请求
GET /api/explorer/v1/{chain}/transactions
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/transactions
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | type | String | 是 | 唯一值：large，表示查询大额交易 |
| queryString | upperBound | Long | 是 | 大额额度边界 |
| downBound | ||||
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认20条 |
| queryString | sort | String | 否 | 排序，规则为：field:desc/asc，默认blockHeight倒序 |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"total": 3196783,
"scrollId": null,
"hits": [
{
"hash": "3bbcf905c61831b7558936e03ff5257baa6f6dcc629796cea7bf7af16acfb9b7",
"blocktime": 1573211898,
"legalRate": 64922,
"index": 2326,
"blockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"blockHeight": 602850,
"coinbase": false,
"size": 250,
"version": 1,
"doubleSpend": false,
"fee": 500,
"feePerKbyte": 2000,
"inputsCount": 1,
"outputsCount": 2,
"inputsValue": 0.00354234,
"outputsValue": 0.00353734,
"realTransferValue": 0.00348017,
"inputsValueSat": 354234,
"outputsValueSat": 353734,
"realTransferValueSat": 348017,
"inputs": [
{
"prevBlockHash": "0000000000000000000efd376141e80ec85b8c3b57cd0dde9739806321b0d730",
"prevAddresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH_P2WPKH",
"vinIndex": 0,
"prevBlockHeight": 602849,
"prevTxhash": "1b3dad3bc83b3d518ee1eb6d9ffa83275a550e66a4263b2daedbcd3dcb21783e",
"prevVoutIndex": 0,
"prevValueSat": 354234,
"prevValue": 0.00354234,
"prevBlocktime": 1573211540,
"prevScriptType": "P2SH",
"scriptHex": "160014eaff5e6d6ce5fd8cbd2ee6cabc58c6e4973f046c",
"scriptData": "",
"sequence": 4294967293,
"lifespan": 358,
"coindaysDestroyed": 1467,
"witness": [
"3045022100c0a5b0e2708e42fbcc746e029da6616cfe78e8c5b2c448b833381ba12a168da702204ab212d7856a90d88d3911671a8c973e42fd0b19842a86741475c9780b06403201",
"02cb2dbdbcedbfb0bfd33a34f243a62122bd60739f3c465f0b44f3e650bfa1be12"
]
}
],
"outputs": [
{
"addresses": [
"1Ep36WYw8LctrT7XhQpYuzWVQZeQWZFi5q"
],
"scriptType": "P2PKH",
"voutIndex": 0,
"valueSat": 347517,
"value": 0.00347517,
"fromCoinbase": false,
"spent": false,
"spentBlockHeight": -1,
"spentBlockHash": "",
"spentTxhash": "",
"spentVinIndex": -1,
"spentBlocktime": -1,
"scriptAsm": "OP_DUP OP_HASH160 977eef27fb7cec70417c9f0545a96e7fe5b3a1c6 OP_EQUALVERIFY OP_CHECKSIG",
"scriptHex": "76a914977eef27fb7cec70417c9f0545a96e7fe5b3a1c688ac",
"outputType": "Spendable"
},
{
"addresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH",
"voutIndex": 1,
"valueSat": 6217,
"value": 0.00006217,
"fromCoinbase": false,
"spent": true,
"spentBlockHeight": 602850,
"spentBlockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"spentTxhash": "d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3",
"spentVinIndex": 0,
"spentBlocktime": 1573211898,
"scriptAsm": "OP_HASH160 043e3c4552688c5a4b5358bd50651457127a70fa OP_EQUAL",
"scriptHex": "a914043e3c4552688c5a4b5358bd50651457127a70fa87",
"outputType": "Spendable"
}
],
"lockTime": 0,
"coindaysDestroyed": 1467,
"sigops": 1,
"strippedSize": 140,
"virtualSize": 168,
"weight": 670,
"hasWitness": true,
"witnessHash": "f2191fdce43988b670f89e9cdedb71614a8163c18089e2f03a0f8da7717bb86a",
"feePerKwu": 746,
"feePerKvbyte": 2976,
"confirm": 1,
"realAddressBalance": 0
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| blocktime | Long | 区块时间 |
| legalRate | Double | 兑法币汇率 |
| index | Long | 交易索引 |
| blockHash | String | 区块哈希 |
| blockHeight | Integer | 区块高度 |
| coinbase | Boolean | 是否为 coinbase 交易 |
| size | Integer | 交易大小 |
| version | Long | 版本 |
| doubleSpend | Boolean | 是否双花 |
| fee | Long | 费用，单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValue | Double | 输入总量 |
| outputsValue | Double | 输出总量 |
| realTransferValue | Double | 实际交易金额 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| realTransferValueSat | Long | 交易总量 |
| inputs | Array | 输入列表 |
| prevAddresses | String Array | 前一输出地址 |
| scriptType | String | 脚本类型 |
| vinIndex | Integer | 在交易中的位置 |
| prevBlockHeight | Integer | 前一区块高度 |
| prevTxhash | String | 前一输出交易哈希 |
| prevVoutIndex | Integer | 前一输出在交易的位置 |
| prevValueSat | Long | 前一输出数量，单位 satoshi |
| prevValue | Double | 前一输出数量 |
| prevBlocktime | Long | 前一输出交易时间 |
| prevScriptType | String | 前一输出脚本类型 |
| scriptHex | String | 脚本数据 |
| scriptData | String | 脚本显示数据 |
| sequence | Long | 输入序列 |
| lifespan | Integer | output 存活时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| witness | String array | 隔离见证签名数据 |
| outputs | Array | 输出列表 |
| addresses | String array | 输出地址 |
| scriptType | String | 脚本类型 |
| voutIndex | Integer | 输出位置 |
| valueSat | Long | 输出数量，单位 satoshi |
| value | Double | 输出数量 |
| fromCoinbase | Boolean | 是否 coinbase 输出 |
| spent | Boolean | 是否已经花费 |
| spentBlockHeight | Integer | 花费区块高度 |
| spentBlockHash | String | 花费区块hash |
| spentTxhash | String | 花费交易 hash |
| spentVinIndex | Integer | 花费 input 位置 |
| spentBlocktime | Long | 花费区块时间 |
| scriptAsm | String | 脚本 asm |
| scriptHex | String | 脚本数据 |
| ouputType | String | ouput类型 分为：spendable, segwit, unknow |
| lockTime | Long | 锁定时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| sigops | Integer | 交易中的签名数量 |
| strippedSize | Integer | 基础交易大小 |
| virtualSize | Integer | 虚拟大小 |
| weight | Integer | 重量 |
| hasWitness | Boolean | 是否包含隔离见证交易 |
| witnessHash | String | 隔离见证哈希 |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| feePerKvbyte | Long | 每 K 虚拟字节费用，单位 satoshi |
| confirm | Integer | 确认数 |
| realAddressBalance | Double | 地址余额 |
查询未确认交易列表
查询一个区块链的未确认交易列表，默认blocktime逆序。
HTTP 请求
GET /api/explorer/v1/{chain}/transactions
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/transactions
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认20条 |
| queryString | sort | String | 否 | 排序，规则为：field:desc/asc，交易的排序默认为时间戳倒序 |
| queryString | type | String | 是 | 唯一值，"pending" |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"total": 3196783,
"scrollId": null,
"hits": [
{
"hash": "3bbcf905c61831b7558936e03ff5257baa6f6dcc629796cea7bf7af16acfb9b7",
"blocktime": 1573211898,
"legalRate": 64922,
"index": 2326,
"blockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"blockHeight": 602850,
"coinbase": false,
"size": 250,
"version": 1,
"doubleSpend": false,
"fee": 500,
"feePerKbyte": 2000,
"inputsCount": 1,
"outputsCount": 2,
"inputsValue": 0.00354234,
"outputsValue": 0.00353734,
"realTransferValue": 0.00348017,
"inputsValueSat": 354234,
"outputsValueSat": 353734,
"realTransferValueSat": 348017,
"inputs": [
{
"prevBlockHash": "0000000000000000000efd376141e80ec85b8c3b57cd0dde9739806321b0d730",
"prevAddresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH_P2WPKH",
"vinIndex": 0,
"prevBlockHeight": 602849,
"prevTxhash": "1b3dad3bc83b3d518ee1eb6d9ffa83275a550e66a4263b2daedbcd3dcb21783e",
"prevVoutIndex": 0,
"prevValueSat": 354234,
"prevValue": 0.00354234,
"prevBlocktime": 1573211540,
"prevScriptType": "P2SH",
"scriptHex": "160014eaff5e6d6ce5fd8cbd2ee6cabc58c6e4973f046c",
"scriptData": "",
"sequence": 4294967293,
"lifespan": 358,
"coindaysDestroyed": 1467,
"witness": [
"3045022100c0a5b0e2708e42fbcc746e029da6616cfe78e8c5b2c448b833381ba12a168da702204ab212d7856a90d88d3911671a8c973e42fd0b19842a86741475c9780b06403201",
"02cb2dbdbcedbfb0bfd33a34f243a62122bd60739f3c465f0b44f3e650bfa1be12"
]
}
],
"outputs": [
{
"addresses": [
"1Ep36WYw8LctrT7XhQpYuzWVQZeQWZFi5q"
],
"scriptType": "P2PKH",
"voutIndex": 0,
"valueSat": 347517,
"value": 0.00347517,
"fromCoinbase": false,
"spent": false,
"spentBlockHeight": -1,
"spentBlockHash": "",
"spentTxhash": "",
"spentVinIndex": -1,
"spentBlocktime": -1,
"scriptAsm": "OP_DUP OP_HASH160 977eef27fb7cec70417c9f0545a96e7fe5b3a1c6 OP_EQUALVERIFY OP_CHECKSIG",
"scriptHex": "76a914977eef27fb7cec70417c9f0545a96e7fe5b3a1c688ac",
"outputType": "Spendable"
},
{
"addresses": [
"325TBWEEv5dpBvCppYGKfoEshro6PP64np"
],
"scriptType": "P2SH",
"voutIndex": 1,
"valueSat": 6217,
"value": 0.00006217,
"fromCoinbase": false,
"spent": true,
"spentBlockHeight": 602850,
"spentBlockHash": "0000000000000000000645e30db580cc132ed096669a84dd5192c654e0950f65",
"spentTxhash": "d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3",
"spentVinIndex": 0,
"spentBlocktime": 1573211898,
"scriptAsm": "OP_HASH160 043e3c4552688c5a4b5358bd50651457127a70fa OP_EQUAL",
"scriptHex": "a914043e3c4552688c5a4b5358bd50651457127a70fa87",
"outputType": "Spendable"
}
],
"lockTime": 0,
"coindaysDestroyed": 1467,
"sigops": 1,
"strippedSize": 140,
"virtualSize": 168,
"weight": 670,
"hasWitness": true,
"witnessHash": "f2191fdce43988b670f89e9cdedb71614a8163c18089e2f03a0f8da7717bb86a",
"feePerKwu": 746,
"feePerKvbyte": 2976,
"confirm": 1,
"realAddressBalance": 0
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| blocktime | Long | 区块时间 |
| legalRate | Double | 兑法币汇率 |
| index | Long | 交易索引 |
| blockHash | String | 区块哈希 |
| blockHeight | Integer | 区块高度 |
| coinbase | Boolean | 是否为 coinbase 交易 |
| size | Integer | 交易大小 |
| version | Long | 版本 |
| doubleSpend | Boolean | 是否双花 |
| fee | Long | 费用，单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValue | Double | 输入总量 |
| outputsValue | Double | 输出总量 |
| realTransferValue | Double | 实际交易金额 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| realTransferValueSat | Long | 交易总量 |
| inputs | Array | 输入列表 |
| prevAddresses | String Array | 前一输出地址 |
| scriptType | String | 脚本类型 |
| vinIndex | Integer | 在交易中的位置 |
| prevBlockHeight | Integer | 前一区块高度 |
| prevTxhash | String | 前一输出交易哈希 |
| prevVoutIndex | Integer | 前一输出在交易的位置 |
| prevValueSat | Long | 前一输出数量，单位 satoshi |
| prevValue | Double | 前一输出数量 |
| prevBlocktime | Long | 前一输出交易时间 |
| prevScriptType | String | 前一输出脚本类型 |
| scriptHex | String | 脚本数据 |
| scriptData | String | 脚本显示数据 |
| sequence | Long | 输入序列 |
| lifespan | Integer | output 存活时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| witness | String array | 隔离见证签名数据 |
| outputs | Array | 输出列表 |
| addresses | String array | 输出地址 |
| scriptType | String | 脚本类型 |
| voutIndex | Integer | 输出位置 |
| valueSat | Long | 输出数量，单位 satoshi |
| value | Double | 输出数量 |
| fromCoinbase | Boolean | 是否 coinbase 输出 |
| spent | Boolean | 是否已经花费 |
| spentBlockHeight | Integer | 花费区块高度 |
| spentBlockHash | String | 花费区块hash |
| spentTxhash | String | 花费交易 hash |
| spentVinIndex | Integer | 花费 input 位置 |
| spentBlocktime | Long | 花费区块时间 |
| scriptAsm | String | 脚本 asm |
| scriptHex | String | 脚本数据 |
| ouputType | String | ouput 类型 分为：spendable, segwit, unknow |
| lockTime | Long | 锁定时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| sigops | Integer | 交易中的签名数量 |
| strippedSize | Integer | 基础交易大小 |
| virtualSize | Integer | 虚拟大小 |
| weight | Integer | 重量 |
| hasWitness | Boolean | 是否包含隔离见证交易 |
| witnessHash | String | 隔离见证哈希 |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| feePerKvbyte | Long | 每 K 虚拟字节费用，单位 satoshi |
| confirm | Integer | 确认数 |
| realAddressBalance | Double | 地址余额 |
带标签大额交易推送接口
查询一个区块链的未确认交易列表，默认blocktime逆序。
HTTP 请求
GET /api/explorer/v1/{chain}/transactions/trade
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/transactions/trade
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | tag | String | 否 | 交易所名称 |
| queryString | offset | integer | 否 | 起始位置，默认0 |
| queryString | limit | integer | 否 | 返回条数，默认20 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"total":100,
"hits"[
{
"txHash":"asd23123354asdasd",
"txValue":21345.123,
"blocktime":27250301588841,
"from":"sasdsd1w3sds232423h",
"to":"23nn312n3msadasd31",
"fromTags":["okex"],
"toTags":["huobi"],
"fromLogoUrl":"https://sadasdasd.png",
"toLogoUrl":"https://sdaasda,png",
"oneFrom":true,
"oneTo":false,
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| txhash | String | 交易哈希 |
| txValue | Double | 交易值 |
| blocktime | Long | 区块时间 |
| from | String | 输入地址 |
| to | String | 输出地址 |
| fromTags | List |
输入地址标签 |
| toTags | List |
输出地址标签 |
| fromLogoUrl | String | 输入地址logo |
| toLogoUrl | String | 输出地址logo |
| oneFrom | Boolean | 是否一个输入地址 |
| oneTo | Boolean | 是否一个输出地址 |
地址接口
查询地址信息
查询一个地址的基本信息。
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{address}
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{address}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| Path | address | String | 是 | 地址 |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"address": "bc1qn9enaxtnjhkypusvcmwqf5eg20nxss9gc90rnk",
"balance": 0,
"legalRate": 64922,
"balanceSat": 0,
"totalRecievedSat": 1099,
"totalRecieved": 0.00001099,
"totalSentSat": 1099,
"totalSent": 0.00001099,
"txCount": 2,
"tags":
"unconfirmedTxCount": 0,
"unconfirmedReceivedSat": 0,
"unconfirmedSentSat": 0,
"unspentTxCount": 0,
"firstTransactionTime": 1570446359000,
"lastTransactionTime": 1571840679000
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| address | String | 地址哈希 |
| balance | Double | 余额 |
| legalRate | Double | 兑法币汇率 |
| balanceSat | Long | 交易索引 |
| totalRecievedSat | String | 总接收量（最小精度） |
| totalRecieved | Integer | 总接收量 |
| totalSentSat | Boolean | 是否为coinbase交易 |
| totalSent | Integer | 总发送量 |
| txCount | Long | 参与交易数量 |
| tags | Array | 标签数组 |
| unconfirmedTxCount | Boolean | 未确认交易数量 |
| unconfirmedReceivedSat | Long | 未确认接收量（最小精度） |
| unconfirmedSentSat | Long | 未确认发送量（最小精度） |
| unspentTxCount | Long | 未花费交易数量 |
| firstTransactionTime | Long | 第一次交易时间 |
| lastTransactionTime | Long | 最后一次交易时间 |
查询地址交易列表
查询一个地址的交易列表，包括该地址相关的未确认交易和已确认交易，交易的排序规则为，未确认交易优先级高，并按照广播实际倒排，已确认交易按照区块高度倒序。
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{address}/transactions
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{address}/transactions
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| Path | address | String | 是 | 地址 |
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认20条 |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"total": 1,
"hits": [
{
"hash": "5554fcec49e919347205aa6e7487d0d6b956ee505bbcf43739153070b8da618e",
"blocktime": 1576355590,
"legalRate": 10092.79,
"index": 181,
"blockHash": "0000000000000000000ff6ac728cedff8cbcd04e4d77e54de0aa77d10d9996b1",
"blockHeight": 608141,
"coinbase": false,
"size": 257,
"version": 2,
"doubleSpend": false,
"fee": 5140,
"feePerKbyte": 20000,
"inputsCount": 1,
"outputsCount": 2,
"inputsValue": 1499.0986048,
"outputsValue": 1499.0985534,
"realTransferValue": 1499.0986048,
"inputsValueSat": 149909860480,
"outputsValueSat": 149909855340,
"realTransferValueSat": 149909860480,
"inputs": [
{
"prevAddresses": [
"19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ"
],
"scriptType": "P2PKH",
"vinIndex": 0,
"prevBlockHeight": 581174,
"prevTxhash": "0130cbdc86f81aedeb65afca20add3db8f92c296e7c92cb07cfbf9ac91265f02",
"prevVoutIndex": 0,
"prevValueSat": 149909860480,
"prevValue": 1499.0986048,
"prevBlocktime": 1560813252,
"prevScriptType": "P2PKH",
"scriptHex": "102301203",
"scriptData": "",
"sequence": 4294967293,
"lifespan": 15542338,
"coindaysDestroyed": 26967010661030
}
],
"outputs": [
{
"addresses": [
"1AvtcQYQiwwJkHZsExVHmjf12qbCWR48t6"
],
"scriptType": "P2PKH",
"voutIndex": 0,
"valueSat": 4000000000,
"value": 40.0,
"fromCoinbase": false,
"spent": true,
"spentBlockHeight": 608143,
"spentBlockHash": "0000000000000000000ca127a3835e0e1dc6608801bbe5b3bd9f374d2b1d4ccc",
"spentTxhash": "5f48c0f3c0cfcc88c263464841c74c4fd05b6f5ca181b28b8f5c11a358b54a12",
"spentVinIndex": 0,
"spentBlocktime": 1576357017,
"scriptAsm": "OP_DUP OP_HASH160 6cea42a0638e3caf79a1624a3649b8c996afba74 OP_EQUALVERIFY OP_CHECKSIG",
"scriptHex": "76a9146cea42a0638e3caf79a1624a3649b8c996afba7488ac",
"outputType": "Spendable"
},
{
"addresses": [
"19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2"
],
"scriptType": "P2PKH",
"voutIndex": 1,
"valueSat": 145909855340,
"value": 1459.0985534,
"fromCoinbase": false,
"spent": false,
"spentBlockHeight": -1,
"spentBlockHash": "",
"spentTxhash": "",
"spentVinIndex": -1,
"spentBlocktime": -1,
"scriptAsm": "OP_DUP OP_HASH160 5ad08fb4e4089987b68a20d681216ae8b3003963 OP_EQUALVERIFY OP_CHECKSIG",
"scriptHex": "76a9145ad08fb4e4089987b68a20d681216ae8b300396388ac",
"outputType": "Spendable"
}
],
"lockTime": 608140,
"coindaysDestroyed": 26967010661030,
"sigops": 2,
"strippedSize": 257,
"virtualSize": 257,
"weight": 1028,
"hasWitness": false,
"witnessHash": "",
"feePerKwu": 5000,
"feePerKvbyte": 20000,
"confirm": 9769,
"realAddressBalance": -149909860480
}
],
"extend": {
"19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ": {
"address": "19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ",
"tag": "okex",
"id": "19tK9pC6ggFybYWwkGRcWDSKpT6MxsDWDJ"
},
"19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2": {
"address": "19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2",
"tag": "huobi",
"id": "19HBfMyc7VpwWqk66NJFeHz4Dz3SWeznN2"
}
}
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 块哈希 |
| blocktime | Long | 区块时间 |
| legalRate | Double | 兑法币汇率 |
| index | Long | 交易索引 |
| blockHash | String | 区块哈希 |
| blockHeight | Integer | 区块高度 |
| coinbase | Boolean | 是否为coinbase交易 |
| size | Integer | 交易大小 |
| version | Long | 版本 |
| doubleSpend | Boolean | 是否双花 |
| fee | Long | 费用, 单位 satoshi |
| feePerKbyte | Long | 每 K 字节费用，单位 satoshi |
| inputsCount | Integer | vin 数量 |
| outputsCount | Integer | vout 数量 |
| inputsValue | Double | 输入总量 |
| outputsValue | Double | 输出总量 |
| realTransferValue | Double | 实际交易金额 |
| inputsValueSat | Long | 输入总量，单位 satoshi |
| outputsValueSat | Long | 输出总量，单位 satoshi |
| realTransferValueSat | Long | 交易总量 |
| inputs | Array | 输入列表 |
| prevAddresses | String Array | 前一输出地址 |
| scriptType | String | 脚本类型 |
| vinIndex | Integer | 在交易中的位置 |
| prevBlockHeight | Integer | 前一区块高度 |
| prevTxhash | String | 前一输出交易哈希 |
| prevVoutIndex | Integer | 前一输出在交易的位置 |
| prevValueSat | Long | 前一输出数量，单位 satoshi |
| prevValue | Double | 前一输出数量 |
| prevBlocktime | Long | 前一输出交易时间 |
| prevScriptType | String | 前一输出脚本类型 |
| scriptHex | String | 脚本数据 |
| scriptData | String | 脚本显示数据 |
| sequence | Long | 输入序列 |
| lifespan | Integer | output存活时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| witness | String array | 隔离见证签名数据 |
| outputs | Array | 输出列表 |
| addresses | String array | 输出地址 |
| scriptType | String | 脚本类型 |
| voutIndex | Integer | 输出位置 |
| valueSat | Long | 输出数量，单位 satoshi |
| value | Double | 输出数量 |
| fromCoinbase | Boolean | 是否 coinbase 输出 |
| spent | Boolean | 是否已经花费 |
| spentBlockHeight | Integer | 花费区块高度 |
| spentBlockHash | String | 花费区块hash |
| spentTxhash | String | 花费交易 hash |
| spentVinIndex | Integer | 花费 input 位置 |
| spentBlocktime | Long | 花费区块时间 |
| scriptAsm | String | 脚本 asm |
| scriptHex | String | 脚本数据 |
| ouputType | String | ouput类型 分为：spendable, segwit, unknow |
| lockTime | Long | 锁定时间 |
| coindaysDestroyed | Long | 币天销毁数，单位 satoshi |
| sigops | Integer | 交易中的签名数量 |
| strippedSize | Integer | 基础交易大小 |
| virtualSize | Integer | 虚拟大小 |
| weight | Integer | 重量 |
| hasWitness | Boolean | 是否包含隔离见证交易 |
| witnessHash | String | 隔离见证哈希 |
| feePerKwu | Long | 每 K 重量单位费用，单位 satoshi |
| feePerKvbyte | Long | 每 K 虚拟字节费用，单位 satoshi |
| confirm | Integer | 确认数 |
| realAddressBalance | Double | 地址余额 |
| extend | Map | 标签map，地址哈希为key |
查询富豪地址排行统计
查询一个区块链的富豪地址排行信息。
HTTP 请求
GET /api/explorer/v1/{chain}/richers
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/richers
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认20条 |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"address": "bc1qn9enaxtnjhkypusvcmwqf5eg20nxss9gc90rnk",
"balance": 0,
"legalRate": 64922,
"balanceSat": 0,
"totalRecievedSat": 1099,
"totalRecieved": 0.00001099,
"totalSentSat": 1099,
"totalSent": 0.00001099,
"txCount": 2,
"tags": ["okex"],
"unconfirmedTxCount": 0,
"unconfirmedReceivedSat": 0,
"unconfirmedSentSat": 0,
"unspentTxCount": 0,
"firstTransactionTime": 1570446359000,
"lastTransactionTime": 1571840679000,
"richRank":1
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| address | String | 地址哈希 |
| balance | Double | 余额 |
| legalRate | Double | 兑法币汇率 |
| balanceSat | Long | 交易索引 |
| totalRecievedSat | String | 总接收量（最小精度） |
| totalRecieved | Integer | 总接收量 |
| totalSentSat | Boolean | 是否为coinbase交易 |
| totalSent | Integer | 总发送量 |
| txCount | Long | 参与交易数量 |
| tags | Array | 标签数组 |
| unconfirmedTxCount | Boolean | 未确认交易数量 |
| unconfirmedReceivedSat | Long | 未确认接收量（最小精度） |
| unconfirmedSentSat | Long | 未确认发送量（最小精度） |
| unspentTxCount | Long | 未花费交易数量 |
| firstTransactionTime | Long | 第一次交易时间 |
| lastTransactionTime | Long | 最后一次交易时间 |
| richRank | Integer | 地址排名 |
查询未花费交易列表
查询一个地址未被花费的交易列表。
HTTP 请求
v1/{chain}/addresses/{address}/unspent
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{address}/unspent
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| address | address | String | 是 | 待查询地址 |
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认10条 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"total":24,
"hits":[
{
"txhash":"857986f3eb87b6eef6471e010f136d7dcdcf55bf0ffbe26a49fa293629f73639",
"voutIndex":1,
"blockHeightt":612057,
"valueSat":848,
"value":0.00000848,
"address":"bc1qjl8uwezzlech723lpnyuza0h2cdkvxvh54v3dn",
"scriptHex":"001497cfc76442fe717f2a3f0cc9c175f7561b661997",
"fromCoinbase":false,
"confirmations":10912
}
],
"extend":null
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| txhash | String | 交易哈希 |
| voutIndex | int | 在交易中的index |
| blockHeight | int | 区块高度 |
| valueSat | Long | 地址余额（最小精度） |
| value | double | 地址余额 |
| address | String | 地址 |
| scriptHex | String | 脚本 |
| fromCoinbase | Boolean | 是否来自coinbase交易 |
| confirmations | int | 确认交易数量 |
钱包相关接口
查询地址余额
根据地址查询地址的余额。
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/balance/{addresses}
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/balance/{addresses}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| Path | address | String | 是 | 要查询余额的地址（多个地址可用逗号(英文逗号)分割） |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": [
{
"address": "1FgM2PJkhuyeFQDz3jACiqgGezMFjQgasU",
"balance": 0,
"balanceSat": 0
},
{
"address": "1UttWdiAd9PFrEnZc3tdjPafp4f7AAwnc",
"balance": 0,
"balanceSat": 0
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| address | String | 要查询余额的地址 |
| balance | Double | 余额 |
| balanceSat | BigInteger | 最小精度余额 |
查询地址UTXO接口
根据地址查询地址的UTXO。
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{address}/unspent
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{address}/unspent
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| Path | address | String | 是 | 要查询余额的地址 |
| queryString | offset | Integer | 否 | 起始位置，默认0 |
| queryString | limit | Integer | 否 | 返回条数，默认10条 |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"total": 2,
"hits":[
{
"txhash": "d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3",
"voutIndex": 0,
"blockHeight": 64922,
"valueSat": 990000,
"value": 0.99,
"address": "bc1qn9enaxtnjhkypusvcmwqf5eg20nxss9gc90rnk",
"scriptHex": "a914043e3c4552688c5a4b5358bd50651457127a70fa87",
"fromCoinbase": false,
"confirmations": 2
},
{
"txhash": "d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3",
"voutIndex": 0,
"blockHeight": 64922,
"valueSat": 990000,
"value": 0.99,
"address": "bc1qn9enaxtnjhkypusvcmwqf5eg20nxss9gc90rnk",
"scriptHex": "a914043e3c4552688c5a4b5358bd50651457127a70fa87",
"fromCoinbase": false,
"confirmations": 2
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| txhash | String | 交易哈希 |
| voutIndex | int | 在交易中的index |
| blockHeight | int | 区块高度 |
| valueSat | Long | 地址余额（最小精度） |
| value | double | 地址余额 |
| address | String | 地址 |
| scriptHex | String | 脚本 |
| fromCoinbase | Boolean | 是否来自coinbase交易 |
| confirmations | int | 确认交易数量 |
广播交易
广播交易，同步接口。
HTTP 请求
POST /api/explorer/v1/{chain}/transaction/publish
请求示例
POST https://www.oklink.com/api/explorer/v1/{chain}/transaction/publish
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| RequestBody | signedTx | String | 是 | 打包的交易串 |
| json的形式 | txHash | String | 选填 | 交易hash |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"txhash": d77a269946f72c61aff995e16b457e73bed23a424c0162147b34c262b8f0f4b3,
"resultCode": 100,
"resultMsg": "error info",
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| txhash | String | 交易哈希 |
解析交易
解析交易。
HTTP 请求
POST /api/explorer/v1/{chain}/transaction/decode
请求示例
POST https://www.oklink.com/api/explorer/v1/{chain}/transaction/decode
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| RequestBody | signedTx | String | 是 | 打包的交易串 |
| json的形式 | txHash | String | 选填 | 交易hash |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"m":{
"txid":"81c8447bf780dacedf67c45908aafcde43c78ae108b3a06a278362ad306f7239",
"hash":"81c8447bf780dacedf67c45908aafcde43c78ae108b3a06a278362ad306f7239",
"version":1,
"size":224,
"vsize":224,
"weight":896,
"locktime":0,
"vin":[
{
"txid":"2555fe195e9de0a4725c9b76008e93bfb47d7a844309853a27a66a092ecf457c",
"vout":1,
"scriptSig":{
"asm":"12313[ALL]",
"hex":"12313"
},
"sequence":4294967295
}
],
"vout":[
{
"value":0.00271,
"n":0,
"scriptPubKey":{
"asm":"OP_HASH160 7cfcfaae9ec7c505538c7bbfe23d6b3c9d7e0e0e OP_EQUAL",
"hex":"a9147cfcfaae9ec7c505538c7bbfe23d6b3c9d7e0e0e87",
"reqSigs":1,
"type":"scripthash",
"addresses":[
"3D5tmdpJe2tdNmosuLGNwMT9bcym34K3LT"
]
}
},
{
"value":0.01981163,
"n":1,
"scriptPubKey":{
"asm":"OP_DUP OP_HASH160 de1f36251545fa30bb40d4d5288ceff3b25e2197 OP_EQUALVERIFY OP_CHECKSIG",
"hex":"76a914de1f36251545fa30bb40d4d5288ceff3b25e219788ac",
"reqSigs":1,
"type":"pubkeyhash",
"addresses":[
"1MFUQCaXzoQPkx6xrXbjrpmtnfZrStgQ3y"
]
}
}
]
}
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| m | object | 返回一个mapper对象 |
DeFi相关接口
DeFi项目列表
返回DeFi项目列表及基本锁仓信息，目前只支持以太坊。
HTTP 请求
GET /api/explorer/v1/{chain}/defi/list
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/list
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth |
| queryString | category | String | 否 | 传返回该类型所有项目，不传返回所有项目。 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"total":10,
"hits":[
{
"name":"Maker",
"category":"Lending",
"locked":1017144308,
"lockedRate":0.41,
"logoUrl":"http://static.bafang.com/cdn/explorer/defi/Maker.png",
"totalLocked":null,
"totalLend":null,
"totalTxValue24h":null,
"txValue24ChangeRate":null,
"lendRate":0,
"borrowRate":0.8935243138767099,
"lockedDayChangeRate":4.83
}
],
"extend":{
"totalLocked":2505455469
}
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | String | 项目名称 |
| category | String | 项目类别 |
| secondCategory | String | 二级分类（主要是DEX类项目） |
| underlyingAsset | String | 原生资产（主要是锚定资产） |
| locked | Long | 锁仓量，单位美元 |
| lockedRate | Double | 锁仓占比 |
| logoUrl | String | 图片url |
| totalLocked | Long | 总锁仓量 |
| totalLend | Double | 借款总量（抵押借贷项目专有字段） |
| lendRate | Double | 存款利率（抵押借贷项目专有字段） |
| borrowRate | Double | 借款利率（抵押借贷项目专有字段） |
| timestamp | Long | 时间戳 |
| lockedDayChangeRate | Double | 锁仓量日变化率 |
| lockedWeekChangeRate | Double | 锁仓量周变化率 |
| lockedMonthChangeRate | Double | 锁仓量月变化率 |
DeFi项目详情接口
返回具体defi项目的详细信息。
HTTP 请求
GET /api/explorer/v1/{chain}/defi/info
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/info
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| path | chain | String | 是 | eth |
| queryString | name | String | 是 | 返回该项目信息 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"name":"Compound",
"category":"Lending",
"locked":782608208,
"lockedRate":null,
"logoUrl":"http://static.bafang.com/cdn/explorer/defi/Compound.png",
"totalLocked":null,
"totalLend":null,
"totalTxValue24h":null,
"txValue24ChangeRate":null,
"lendRate":8.401478666154302,
"borrowRate":10.780960217743807,
"lockedDayChangeRate":8.33,
"website":"https://compound.finance",
"tokenSymbol":"COMP",
"tokenAddress":"0xc00e94cb662c3520282e6f5717214004a7f26888",
"tokenPrice":null,
"tokenPriceChangeRate24h":null,
"releaseTime":null,
"location":"San Francisco, CA, US",
"contractAddresses":[
"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643",
"0x6c8c6b02e7b2be14d4fa6022dfd6d75921d90e4e",
"0x39aa39c021dfbae8fac545936693ac917d5e7563",
"0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b"
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | String | 项目名称 |
| category | String | 项目类别 |
| secondCategory | String | 二级分类（主要是DEX类项目） |
| underlyingAsset | String | 原生资产（主要是锚定资产） |
| locked | Long | 锁仓量，单位美元 |
| lockedRate | Double | 锁仓占比 |
| userCount | Long | 每日用户数 |
| txCount | Long | 每日交易数 |
| logoUrl | String | 图片url |
| totalLocked | Double | 总锁仓量 |
| totalLend | Double | 借款总量（抵押借贷项目专有字段） |
| txValue24h | Double | 24h交易量 |
| txValue24hChangeRate | Double | 24h交易量变化率 |
| lendRate | Double | 存款利率（抵押借贷项目专有字段） |
| borrowRate | Double | 借款利率（抵押借贷项目专有字段） |
| liquidate24h | Double | 24h清算量 |
| lockedRank | Integer | 锁仓排名 |
| lockedDayChangeRate | Double | 24h锁仓变化率 |
| lockedWeekChangeRate | Double | 7天锁仓变化率 |
| lockedMonthChangeRate | Double | 30天锁仓变化率 |
| website | String | 官网链接 |
| tokenSymbol | String | 平台币symbol |
| tokenAddress | String | 平台币合约地址 |
| tokenPrice | Double | 平台币价格 |
| tokenPricePercentChange24h | Double | 24小时价格变化率 |
| releaseTime | Long | 发布时间 |
| logoUrl | String | 图片url |
| location | String | 所在地 |
| contractAddresses | List |
合约地址列表 |
| description | String | 项目描述 |
| poster | String | 海报 |
| movie | String | 视频链接 |
| String | twitter群 | |
| discard | String | discard群 |
| telegram | String | telegram群 |
| github | String | github链接 |
| auditOrganization | String | 审计组织 |
| similarList | List | 相似项目 |
DeFi项目历史锁仓信息
返回DeFi项目历史锁仓信息。
HTTP 请求
GET /api/explorer/v1/{chain}/defi/history
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/history
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth |
| queryString | name | String | 否 | 返回该项目相应时间段的历史数据。 |
| queryString | category | String | 否 | name为空时，返回该类型项目的历史数据。 |
| queryString | period | String | 否 | 返回该时间段的相应历史数据，默认30天。7天返回每个小时的数据，其他返回每天8点的数据。1w=7天，1m=30天，3m=90天，1y=一年 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"total":22,
"hits":[
{
"projectName":"Compound",
"type":"day",
"category":"Lending",
"lockedUsd":782608208,
"lockedEth":149096258.17259303,
"totalBtc":3755.163346,
"totalEth":910045.728403,
"totalDai":0,
"userCount":0,
"txCount":0,
"timestamp":1595894400
}
],
"extend":{
"totalLocked":782608208
}
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| projectName | String | 项目名称 |
| locked | Long | 锁仓量，单位美元 |
| type | String | 统计类型 |
| timestamp | Long | 时间戳 |
| totalLocked | Double | 总锁仓量，当name!=null是该项目的总锁仓量；当name=null，categrot=null时，代表所有项目的总锁仓量；当name=null,category!=null时代表该类项目的总锁仓量 |
DeFi项目行情排行列表
返回市值排行各个项目列表，按市值排序
HTTP 请求
GET /api/explorer/v1/{chain}/defi/marketcap/list
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/marketcap/list
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
返回结果
{
"code": 200,
"msg": "success",
"detailMsg": "",
"data":[
{
"project" :"Chainlink",
"symbol" :"LINK",
"price" :23.3543,
"marketCap" :234224211,
"totalTxValue24h" :2342.234,
"priceChange24h" : 0.1231,
},
{
"project" :"Chainlink",
"symbol" :"LINK",
"price" :23.3543,
"marketCap" :234224211,
"totalTxValue24h" :2342.234,
"priceChange24h" : 0.1231,
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 代码 |
| msg | String | 消息 |
| detailMsg | String | 消息详情 |
| data | List<Object> | 数据 |
| > project | String | 项目名称 |
| > symbol | String | 代币类型 |
| > label | String | 图标 |
| > price | double | 价格 |
| > marketCap | double | 市值 |
| > totalTxValue24h | double | 24小时交易额 |
| > priceChange24h | double | 24小时价格变化 |
DeFi稳定币列表
返回稳定币各个代币列表，按流通量排序
HTTP 请求
GET /api/explorer/v1/{chain}/defi/stablecoin/list
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/stablecoin/list
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
返回结果
{
"code": 200,
"msg": "success",
"detailMsg": "",
"data":[
{
"project" :"USDT",
"circulation" :12361371,
"addressCount" :1231231,
"totalTxCount24h":1231,
"totalTxValue24h" :2342123.234,
"additional" : 1231.12
},
{
"project" :"USDT",
"circulation" :12361371,
"addressCount" :1231231,
"totalTxCount24h":1231,
"totalTxValue24h" :2342123.234,
"additional" : 1231.12
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 代码 |
| msg | String | 消息 |
| detailMsg | String | 消息详情 |
| data | List<Object> | 数据 |
| > project | String | 项目名称 |
| > label | String | 图标 |
| > circulation | Long | 流通量 |
| > addressCount | Long | 持币地址数 |
| > totalTxCount24h | Long | 24小时交易量 |
| > totalTxValue24h | Double | 24小时交易额 |
| > additional | Double | 最近增发 |
| > additionalDate | String | 最近增发时间 |
DeFi项目历史总市值折线图
返回市值排行总市值历史数据统计图
HTTP 请求
GET /api/explorer/v1/{chain}/defi/marketcap/chart
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/marketcap/chart
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| request | period | String | 否 | 显示的数据时间段(1w/1m/3m/1y/all)，默认一个月(7天的数据按小时展示) |
返回结果
{
"code": 200,
"msg": "success",
"detailMsg": "",
"data":[
{
"statisticDate":20200101,
"marketCap":12352423.12341,
"timestamp":123423424234
},
{
"statisticDate":20200101,
"marketCap":12352423.12341,
"timestamp":123423424234
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 代码 |
| msg | String | 消息 |
| detailMsg | String | 消息详情 |
| data | List<Object> | 数据 |
| > statisticDate | long | 统计日期 |
| > marketCap | double | 总市值 |
| > timestamp | long | 时间戳 |
DeFi稳定币历史流通量折线图
返回稳定币各个代币流通量历史数据折线图
HTTP 请求
GET /api/explorer/v1/{chain}/defi/stablecoin/chart
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/stablecoin/chart
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| request | period | String | 否 | 显示的数据时间段(1m/3m/1y/all)，默认30天 |
返回结果
{
"code": 200,
"msg": "success",
"detailMsg": "",
"data":[
{
"date": "20200810",
"timestamp": 123123231,
"totalCirculate": 123123123,
"tokens":[
{
"symbel":"ABC",
"project":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"ABCD",
"project":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"AODS",
"project":"ados",
"circulation": 13213,
"percent": 0.8
}
]
},
{
"date": "20200811",
"timestamp": 123123231,
"totalCirculate": 123123123,
"tokens":[
{
"symbel":"ABC",
"name":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"ABCD",
"name":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"AODS",
"name":"ados",
"circulation": 13213,
"percent": 0.8
}
]
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 代码 |
| msg | String | 消息 |
| detailMsg | String | 消息详情 |
| data | List<Object> | 数据 |
| > date | String | 日期 |
| > timestamp | Long | 时间戳 |
| > totalCirculate | Long | 总流通量 |
| > tokens | List<Token> | 代币列表 |
| >> symbel | String | 代币符号 |
| >> project | String | 名称 |
| >> circulation | Long | 流通量 |
| >> percent | Double | 占比 |
DeFi锚定币列表
返回锚定币各个代币列表，按流通量排序
HTTP 请求
GET /api/explorer/v1/{chain}/defi/pegged/list
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/pegged/list
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
返回结果
{
"code": 200,
"msg": "success",
"detailMsg": "",
"data":[
{
"project" :"Chainlink",
"symbol" :"LINK",
"circulation" :234224211,
"marketCap" :2342.234,
"additional" : 0.1231
},
{
"project" :"Chainlink",
"symbol" :"LINK",
"circulation" :234224211,
"marketCap" :2342.234,
"additional" : 0.1231
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 代码 |
| msg | String | 消息 |
| detailMsg | String | 消息详情 |
| data | List<Object> | 数据 |
| > project | String | 项目名称 |
| > label | String | 图标 |
| > symbol | String | 代币类型 |
| > circulation | Long | 流通量 |
| > marketCap | Double | 锁仓市值 |
| > additional | Double | 流通量24小时变化率 |
| > underlyingAsset | String | 原生资产 |
DeFi锚定币历史流通量折线图
返回锚定币各个代币流通量历史数据折线图
HTTP 请求
GET /api/explorer/v1/{chain}/defi/anchor/chart
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/anchor/chart
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| request | period | String | 否 | 显示的数据时间段（1m/3m/1y/all）默认1m |
返回结果
{
"code": 200,
"msg": "success",
"detailMsg": "",
"data":[
{
"date": "20200810",
"timestamp": 123123231,
"totalCirculate": 123123123,
"tokens":[
{
"symbel":"ABC",
"project":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"ABCD",
"project":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"AODS",
"project":"ados",
"circulation": 13213,
"percent": 0.8
}
]
},
{
"date": "20200811",
"timestamp": 123123231,
"totalCirculate": 123123123,
"tokens":[
{
"symbel":"ABC",
"project":"abc",
"circulation": 13213,
"percent": 0.1
},
{
"symbel":"ABCD",
"project":"abc",
"circulate": 13213,
"percent": 0.1
},
{
"symbel":"AODS",
"project":"ados",
"circulation": 13213,
"percent": 0.8
}
]
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 代码 |
| msg | String | 消息 |
| detailMsg | String | 消息详情 |
| data | List<Object> | 数据 |
| > date | String | 日期 |
| > timestamp | Long | 时间戳 |
| > totalCirculate | Long | 总流通量 |
| > tokens | List<Token> | 代币列表 |
| >> symbel | String | 代币符号 |
| >> project | String | 项目名称 |
| >> circulation | Long | 流通量 |
| >> percent | Double | 占比 |
抵押借贷项目利率
返回每个项目支持的币种及其存款、借款利率。
HTTP 请求
GET /api/explorer/v1/{chain}/defi/project/rate
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/project/rate
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | name | String | 否 | 项目名称，不传返回所有抵押借贷项目 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
{
"projectName":"Aave",
"projectLogoUrl":"http://static.bafang.com/cdn/explorer/defi/Aave.png",
"tokenList":[
{
"symbol":"DAI",
"contractAddress":"0x6b175474e89094c44da98b954eedeac495271d0f",
"tokenLogoUrl":"https://oss.bafang.com/blockchain/ethToken/ETH_DAI_0x6b175474e89094c44da98b954eedeac495271d0f.jpg",
"borrowRate":null,
"supplyRate":null
},
{
"symbol":"USDC",
"contractAddress":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"tokenLogoUrl":"https://oss.bafang.com/blockchain/ethToken/ETH_USDC_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.jpg",
"borrowRate":null,
"supplyRate":null
}
]
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| projectName | String | 项目名称 |
| projectLogoUrl | String | 项目logo |
| tokenList | List | 代币列表 |
| symbol | String | 代币名称 |
| contractAddress | String | 合约地址 |
| tokenLogoUrl | String | 代币logo |
| borrow_rate | Double | 借款利率 |
| supply_rate | Double | 存款利率 |
抵押借贷代币利率
返回每个项目支持的币种及其存款、借款利率。
HTTP 请求
GET /api/explorer/v1/{chain}/defi/token/rate
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/token/rate
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写 |
| queryString | symbol | String | 否 | token名称，不传返回所有token |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"ZRX": [
"Compound":{
"borrow_rate": 0.7975518197349599,
"supply_rate": 0.059697601453138724,
"logo_url": "http://static.bafang.com/cdn/explorer/defi/Compound.png"
},
"Aave":{
"borrow_rate": 0.7975518197349599,
"supply_rate": 0.059697601453138724,
"logo_url": "http://static.bafang.com/cdn/explorer/defi/Aave.png"
}
],
"REP":[
"Maker":{
"borrow_rate": 0.7975518197349599,
"supply_rate": 0.059697601453138724,
"logo_url": "http://static.bafang.com/cdn/explorer/defi/Maker.png"
},
"Compound":{
"borrow_rate": 0.7975518197349599,
"supply_rate": 0.059697601453138724,
"logo_url": "http://static.bafang.com/cdn/explorer/defi/Compound.png"
},
"Aave":{
"borrow_rate": 0.7975518197349599,
"supply_rate": 0.059697601453138724,
"logo_url": "http://static.bafang.com/cdn/explorer/defi/Aave.png"
}
]
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| borrow_rate | Double | 借款利率 |
| supply_rate | Double | 存款利率 |
DeFi挖矿列表接口
HTTP 请求
GET /api/explorer/v1/{chain}/defi/farmings
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/farmings
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth |
| queryString | project | String | 否 | 过滤项目名称 |
| queryString | sort | String | 否 | 排序字段total_stake、daily_roi、yearly_roi |
| queryString | order | String | 否 | 排序方式asc/desc |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"total":4,
"hits":[
{
"project":"Uniswap V2",
"pairName":"ETH-WBTC",
"rewards":[
"0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"
],
"impermanentLoss":"High",
"totalStake":640565761.9212956,
"dailyRoi":0.04129808219178,
"yearlyRoi":15.0738,
"timestamp":1603879200,
"projectLogo":"https://static.bafang.com/cdn/explorer/defi/uniswapv2
.png",
"website":"https://app.uniswap.org",
"rewardMap":{
"UNI":"0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"
}
}
],
"extend":null
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| project | String | 项目名称 |
| pairName | String | 总锁仓量 |
| rewards | ||
| impermanentLoss | String | 风险高低 |
| totalStake | Double | 总锁仓 |
| dailyRoi | Double | 日收益率 |
| yearlyRoi | Double | 年收益率 |
| timestamp | Long | 时间戳 |
| projectLogo | String | 项目logo |
| website | Stiring | 项目官网 |
| rewardMap | Map | key奖励token,value为token合约 |
抵押借贷实时列表接口
HTTP 请求
GET /api/explorer/v1/{chain}/defi/history
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/history
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth |
| queryString | category | String | 是 | 填Lending |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
{
"projectName":"Maker",
"lockedUsd":132124.12,
"totalLend":21313.21,
"liquidate24h":213123.12,
"timestamp":1599552000,
"logo":"xxxxxxxxxxxx",
"rank":1
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| projectName | String | 项目名称 |
| lockedUsd | Double | 总锁仓量 |
| totalLend | Double | 总借贷量 |
| liquidate24h | Double | 24h清算量 |
| volume24h | Double | 24h交易量 |
| logo | String | logo url |
| rank | int | 排序 |
下载接口
普通交易下载
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{hash}/transaction/download
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{hash}/transaction/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth目前只支持ETH |
| path | hash | String | 是 | 地址hash |
| queryString | start | long | 是 | 开始时间戳1601136000 |
| queryString | end | long | 是 | 结束时间戳1603814400 |
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 交易哈希 |
| block | Integer | 区块高度 |
| blocktime | Long | 区块时间 |
| from | String | from地址 |
| to | String | to地址 |
| value | Double | 交易金额单位ETH |
| fee | Double | 交易手续费单位ETH |
token转账交易下载
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{hash}/transfer/download
请求示例
Get https://www.oklink.com/api/explorer/v1/{chain}/addresses/{hash}/transfer/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth目前只支持ETH |
| path | hash | String | 是 | 地址hash(既可以是普通地址，也可以是合约地址) |
| queryString | start | long | 是 | 开始时间戳1601136000 |
| queryString | end | long | 是 | 结束时间戳1603814400 |
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 交易哈希 |
| block | Integer | 区块高度 |
| blocktime | Long | 区块时间 |
| from | String | from地址 |
| to | String | to地址 |
| value | Double | 交易金额,单位具体的Token |
| symbol | String | 交易的具体token |
内部交易下载
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{hash}/internal/download
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{hash}/internal/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth目前只支持ETH |
| path | hash | String | 是 | 地址hash |
| queryString | start | long | 是 | 开始时间戳1601136000 |
| queryString | end | long | 是 | 结束时间戳1603814400 |
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 交易哈希 |
| block | Integer | 区块高度 |
| blocktime | Long | 区块时间 |
| from | String | from地址 |
| to | String | to地址 |
| value | Double | 交易金额单位ETH |
地址持币下载
查询支持的区块链的汇总信息。
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{hash}/held/download
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{hash}/held/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth目前只支持ETH |
| path | hash | String | 是 | 地址hash,必须是合约地址 |
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| rank | Integer | 持仓排名 |
| holder | String | 持仓地址 |
| num | Double | 持仓数量 |
| value | Double | 持仓金额,单位$ |
| rate | Double | 持仓占比 |
ERC20代币交易转账下载
HTTP 请求
GET /api/explorer/v1/{chain}/addresses/{hash}/erc20/download
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/addresses/{hash}/erc20/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth目前只支持ETH |
| path | hash | String | 是 | 地址hash,必须是erc20合约地址 |
| queryString | start | long | 是 | 开始时间戳1601136000 |
| queryString | end | long | 是 | 结束时间戳1601136000 |
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| hash | String | 交易哈希 |
| block | Integer | 区块高度 |
| blocktime | Long | 区块时间 |
| from | String | from地址 |
| label | String | from标签 |
| to | String | to地址 |
| label | String | to标签 |
| value | Double | 代币转账数量 |
| symbol | String | ERC20代币symbol |
查询支持的链接口
查询链的信息。
HTTP 请求
GET /api/explorer/v1/info/summary
请求示例
GET https://www.oklink.com/api/explorer/v1/info/summary
请求参数
无
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
{
"symbol":"BTC",
"price":53343.47,
"lastBlockTime":1619082444,
"totalTransacationCount":635928118,
"totalSupply":18687556.25,
"totalSupplyPercent":0.889883630952381,
"pendingTransactionCount":199857,
"runTime":388076246392,
"pricePercentChange24h":-0.03941595823549994,
"height":680108
},
{
"symbol":"OKEXCHAIN_TEST",
"price":0,
"lastBlockTime":1619053943000,
"totalTransacationCount":45402317,
"totalSupply":1002123882,
"totalSupplyPercent":100.2123882,
"pendingTransactionCount":0,
"runTime":18796351405,
"pricePercentChange24h":-0.060869565217391355,
"height":2251099
},
{
"symbol":"OKCHAIN_TEST",
"price":0,
"lastBlockTime":1619053943000,
"totalTransacationCount":45402317,
"totalSupply":1002123882,
"totalSupplyPercent":100.2123882,
"pendingTransactionCount":0,
"runTime":18796351405,
"pricePercentChange24h":-0.060869565217391355,
"height":2251099
},
{
"symbol":"OKEXCHAIN",
"price":169.56,
"lastBlockTime":1619053947000,
"totalTransacationCount":403000,
"totalSupply":11535930.5,
"totalSupplyPercent":1.15359305,
"pendingTransactionCount":0,
"runTime":8399551419,
"pricePercentChange24h":-0.060869565217391355,
"height":2253726
},
{
"symbol":"LTC",
"price":262.013,
"lastBlockTime":1619082664,
"totalTransacationCount":67808152,
"totalSupply":67488350,
"totalSupplyPercent":0.8034327380952381,
"pendingTransactionCount":141,
"runTime":301110086429,
"pricePercentChange24h":0.002582862040728691,
"height":2039167
},
{
"symbol":"BCH",
"price":902.408,
"lastBlockTime":1619081565,
"totalTransacationCount":325615051,
"totalSupply":18714825,
"totalSupplyPercent":0.8911821428571428,
"pendingTransactionCount":5668,
"runTime":388076246439,
"pricePercentChange24h":-0.03766755889221844,
"height":684471
},
{
"symbol":"BSV",
"price":297.792,
"lastBlockTime":1618240204,
"totalTransacationCount":600813924,
"totalSupply":18703187.5,
"totalSupplyPercent":0.8906279761904762,
"pendingTransactionCount":8,
"runTime":388076246450,
"pricePercentChange24h":-0.01566451041380894,
"height":682609
},
{
"symbol":"USDT",
"price":1.00101,
"lastBlockTime":1619082444,
"totalTransacationCount":18973438,
"totalSupply":37514219968.60655,
"totalSupplyPercent":1,
"pendingTransactionCount":1317,
"runTime":0,
"pricePercentChange24h":0.00033977235252381603,
"height":680108
},
{
"symbol":"ETH",
"price":2437.138,
"lastBlockTime":1619082725,
"totalTransacationCount":1097831760,
"totalSupply":115566627.59323,
"totalSupplyPercent":1,
"pendingTransactionCount":174805,
"runTime":180884778480,
"pricePercentChange24h":0.06192775378614413,
"height":12289114
},
{
"symbol":"DASH",
"price":293.584,
"lastBlockTime":1619082531,
"totalTransacationCount":35291967,
"totalSupply":10095037.70802254,
"totalSupplyPercent":0.5341289792604519,
"pendingTransactionCount":70,
"runTime":228987133491,
"pricePercentChange24h":-0.0835586582517616,
"height":1458623
},
{
"symbol":"ETC",
"price":34.523,
"lastBlockTime":1619082716,
"totalTransacationCount":67656228,
"totalSupply":127415605.83146189,
"totalSupplyPercent":1,
"pendingTransactionCount":8975,
"runTime":183447978502,
"pricePercentChange24h":0.04072711925720506,
"height":12599046
}
]
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| symbol | String | 币种 |
| price | double | 价格 |
| lastBlockTime | long | 最近一次出块时间 |
| totalTransacationCount | Long | 总交易量 |
| totalSupply | double | 总供应量 |
| totalSupplyPercent | double | 供应量占比 |
| pendingTransactionCount | Long | 未成交量 |
| pricePercentChange24h | double | 24h价格 |
| height | Integer | 区块高度 |
链上大师相关接口
查询天级别链指标接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/search/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/search/{type}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth、btc、usdt |
| Path | type | long | 是 | 查询的指标ID |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 39 | BTC链上盈利地址数 | BTC |
| 40 | BTC链上盈利地址数占比 | BTC |
| 108 | ETH链上盈利地址数 | ETH |
| 109 | ETH链上盈利地址数占比 | ETH |
| 42 | BTC链上巨鲸地址数 | BTC |
| 44 | BTC长期持币地址数 | BTC |
| 112 | ETH长期持币地址数 | ETH |
| 5 | 比特币矿工收入（区块奖励+手续费） | BTC |
| 72 | ETH矿工收入（区块奖励+手续费） | ETH |
| 6 | 比特币 FRM | BTC |
| 73 | 以太坊 FRM | ETH |
| 4 | 比特币矿工地址余额 | BTC |
| 71 | 以太坊矿工地址余额 | ETH |
| 68 | 以太坊矿工地址净流入（包含流入、流出、净流入3个指标） | ETH |
| 69 | 以太坊矿工地址流入 | ETH |
| 70 | 以太坊矿工地址流出 | ETH |
| 1 | 比特币矿工地址净流入（包含流入、流出、净流入3个指标） | BTC |
| 2 | 比特币矿工地址流入 | BTC |
| 3 | 比特币矿工地址流出 | BTC |
| 7 | 比特币交易所地址净流入（包含流入、流出、净流入3个指标） | BTC |
| 8 | 比特币交易所地址流入 | BTC |
| 9 | 比特币交易所地址流出 | BTC |
| 10 | 比特币交易所地址余额 | BTC |
| 74 | 以太坊交易所地址净流入（包含流入、流出、净流入3个指标） | ETH |
| 75 | 以太坊交易所地址流入 | ETH |
| 76 | 以太坊交易所地址流出 | ETH |
| 77 | 以太坊交易所地址余额 | ETH |
| 86 | ETH链上日交易量 | ETH |
| 27 | BTC链上日交易量 | BTC |
| 120 | 交易所地址ERC20-USDT净流入 | STABLECOIN |
| 121 | 交易所地址ERC20-USDT流入 | STABLECOIN |
| 122 | 交易所地址ERC20-USDT流出 | STABLECOIN |
| 123 | 交易所地址ERC20-USDT余额 | STABLECOIN |
| 124 | 交易所地址Omni-USDT净流入 | STABLECOIN |
| 125 | 交易所地址Omni-USDT流入 | STABLECOIN |
| 126 | 交易所地址Omni-USDT流出 | STABLECOIN |
| 127 | 交易所地址Omni-USDT余额 | STABLECOIN |
| 128 | 交易所地址TRC20-USDT净流入 | STABLECOIN |
| 129 | 交易所地址TRC20-USDT流入 | STABLECOIN |
| 130 | 交易所地址TRC20-USDT流出 | STABLECOIN |
| 131 | 交易所地址TRC20-USDT余额 | STABLECOIN |
| 132 | 交易所地址USDT净流入 | STABLECOIN |
| 49 | 2.0质押率 | ETH |
| 45 | 2.0总存款人数 | ETH |
| 47 | 2.0总质押数 | ETH |
| 50 | 2.0验证人总数 | ETH |
| 46 | 2.0新增存款人数 | ETH |
| 48 | 2.0新增质押数 | ETH |
| 52 | 2.0验证人总收益 | ETH |
| 53 | 2.0验证人日人均收益(每日总收益/每日总验证人) | ETH |
| 54 | 2.0年化收益率 | ETH |
| 212 | 以太坊增发的合约数 | ETH |
| 213 | 以太坊销毁的合约数 | ETH |
| 214 | 以太坊升级的合约数 | ETH |
| 117 | USTD流通量（限usdt） | STABLECOIN |
| 116 | USDT市值（限usdt） | STABLECOIN |
| 119 | 增发数量（包括销毁数据） | STABLECOIN |
| 113 | 稳定币总流通量 | STABLECOIN |
| 115 | 稳定币市值 | STABLECOIN |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price",//指标名英文 String
"targetId":2,//指标id long
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404,// 纵坐标值，object 类型
"reward": 1403.2,//区块奖励 Double
"fee": 123.4//手续费 Double
"mintAmount":1234.4,//增发数量 Double
"destoryAmount": 1234.5,//销毁数量 Double
"in": 1234.5,//流入 Double
"out": 1234.5,//流出 Double
"price":1404.5// 价格，double 类型
}
]
}
市场纬度数据查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/market/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/market/{type}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth、btc、usdt |
| Path | type | long | 是 | 查询的指标ID |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 200 | ETH 3iQ CoinShares Bitcoin ETF 持仓量 | ETH |
| 201 | ETH 3iQ CoinShares Bitcoin ETF持仓变化 | ETH |
| 202 | ETH CI Galaxy Bitcoin ETF 持仓量 | ETH |
| 203 | ETH CI Galaxy Bitcoin ETF持仓变化 | ETH |
| 204 | ETH Evolve Bitcoin ETF 持仓量 | ETH |
| 205 | ETH Evolve Bitcoin ETF持仓变化 | ETH |
| 206 | BTC 3iQ CoinShares Bitcoin ETF持仓量 | BTC |
| 207 | BTC 3iQ CoinShares Bitcoin ETF持仓变化 | BTC |
| 208 | BTC CI Galaxy Bitcoin ETF持仓量 | BTC |
| 209 | BTC CI Galaxy Bitcoin ETF持仓变化 | BTC |
| 210 | BTC Evolve Bitcoin ETF持仓量 | BTC |
| 211 | BTC Evolve Bitcoin ETF持仓变化 | BTC |
| 22 | 灰度BTC持仓量 | BTC |
| 23 | 灰度BTC持仓变化 | BTC |
| 24 | Purpose Bitcoin ETF持仓量 | BTC |
| 25 | Purpose Bitcoin ETF持仓变化 | BTC |
| 100 | 灰度ETH持仓量 | ETH |
| 101 | 灰度ETH持仓变化 | ETH |
| 102 | Purpose Ether ETF 持仓量 | ETH |
| 103 | Purpose Ether ETF持仓变化 | ETH |
| 21 | BTC锚定资产流通量 | BTC |
| 18 | BTC非活跃流通量 | BTC |
| 97 | ETH非活跃流通量 | ETH |
| 215 | ETH上市公司持有 | ETH |
| 216 | BTC上市公司持有 | BTC |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"targetId":2,//指标id
"chain":"btc",//链
"indicatorName":"price"//指标名英文
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404// 纵坐标值，object 类型
"price":1404.5// 价格，double 类型
}
]
}
锚定BTC流通量查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/assets
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/assets
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，btc |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"totalSupply",//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[//内容
{
"20200120":[
{
"symbol":"wbtc",//符号 String
"value":1404.5,//流通量 Double
"price":1404.5//价格 Double
}
]
}
]
}
}
defi相关数据指标查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/defi/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/defi/{type}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| Path | type | long | 是 | 查询的指标 |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 56 | ETH DEX总锁仓量(TVL） | ETH |
| 57 | ETH DEX日交易量 | ETH |
| 58 | ETH DEX日活跃用户数 | ETH |
| 59 | ETH DEX日交易次数 | ETH |
| 60 | ETH DEX资金利用率 | ETH |
| 62 | ETH DEX协议收益 | ETH |
| 63 | ETH 借贷总锁仓量(TVL） | ETH |
| 64 | ETH 借贷总存款量 | ETH |
| 65 | ETH 借贷总借款量 | ETH |
| 66 | ETH 借贷协议收益 | ETH |
| 67 | ETH 借贷日活跃用户数 | ETH |
| 55 | ETH DeFi项目协议收益 | ETH |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404// 纵坐标值，object 类型
"price":1404.5// 价格，Double 类型
}
]
}
协议收益分布接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/protalrevennu/distributed
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/protalrevennu/distributed
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"protalRevennu"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"project":"uniswap", //日期 long
"value":1404.6// 协议收益，Double
}
]
}
DEX交易量市场份额接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/market/share
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/market/share
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"totalSupply",//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[//内容
{
"20200120":[
{
"symbol":"wbtc",//符号 String
"value":1404.5,//流通量 Double
"price":1404.5//价格 Double
}
]
}
]
}
}
交易所维度指标查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/exchange/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/exchange/{type}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| Path | type | long | 是 | 查询的指标id |
| param | exchangeName | String | 是 | 交易所名字 okex、huobi、bian、coinbase |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 146 | Huobi交易所BTC净流入 | BTC |
| 147 | Huobi交易所BTC流入 | BTC |
| 148 | Huobi交易所BTC流出 | BTC |
| 149 | Huobi交易所地址BTC余额 | BTC |
| 152 | Binance交易所BTC净流入 | BTC |
| 153 | Binance交易所BTC流入 | BTC |
| 154 | Binance交易所BTC流出 | BTC |
| 155 | Binance交易所地址BTC余额 | BTC |
| 158 | Coinbase交易所BTC净流入 | BTC |
| 159 | Coinbase交易所BTC流入 | BTC |
| 160 | Coinbase交易所BTC流出 | BTC |
| 161 | Coinbase交易所地址BTC余额 | BTC |
| 164 | Huobi交易所ETH净流入 | ETH |
| 165 | Huobi交易所ETH流入 | ETH |
| 166 | Huobi交易所ETH流出 | ETH |
| 167 | Huobi交易所地址ETH余额 | ETH |
| 170 | Binance交易所ETH净流入 | ETH |
| 171 | Binance交易所ETH流入 | ETH |
| 172 | Binance交易所ETH流出 | ETH |
| 173 | Binance交易所地址ETH余额 | ETH |
| 176 | Coinbase交易所ETH净流入 | ETH |
| 177 | Coinbase交易所ETH流入 | ETH |
| 178 | Coinbase交易所ETH流出 | ETH |
| 179 | Coinbase交易所地址ETH余额 | ETH |
| 182 | Huobi交易所USDT净流入 | STABLECOIN |
| 183 | Huobi交易所USDT流入 | STABLECOIN |
| 184 | Huobi交易所USDT流出 | STABLECOIN |
| 185 | Huobi交易所地址USDT余额 | STABLECOIN |
| 188 | Binance交易所USDT净流入 | STABLECOIN |
| 189 | Binance交易所USDT流入 | STABLECOIN |
| 190 | Binance交易所USDT流出 | STABLECOIN |
| 191 | Binance交易所地址USDT余额 | STABLECOIN |
| 194 | Coinbase交易所USDT净流入 | STABLECOIN |
| 195 | Coinbase交易所USDT流入 | STABLECOIN |
| 196 | Coinbase交易所USDT流出 | STABLECOIN |
| 197 | Coinbase交易所地址USDT余额 | STABLECOIN |
| 133 | OKEx交易所USDT净流入 | STABLECOIN |
| 134 | OKEx交易所USDT流入 | STABLECOIN |
| 135 | OKEx交易所USDT流出 | STABLECOIN |
| 136 | OKEx交易所地址USDT余额 | STABLECOIN |
| 78 | OKEx交易所ETH净流入 | ETH |
| 79 | OKEx交易所ETH流入 | ETH |
| 80 | OKEx交易所ETH流出 | ETH |
| 81 | OKEx交易所地址ETH余额 | ETH |
| 11 | OKEx交易所BTC净流入 | BTC |
| 12 | OKEx交易所BTC流入 | BTC |
| 13 | OKEx交易所BTC流出 | BTC |
| 14 | OKEx交易所地址BTC余额 | BTC |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404// 纵坐标值，object 类型
"price":1404.5// 价格，double 类型
"in": 1234.5,//流入 Double
"out": 1234.5,//流出 Double
}
]
}
具体交易所流入流出分布接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/exchange/detail/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/exchange/detail/{type}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| Path | type | long | 是 | 查询的指标id |
| param | exchangeName | String | 是 | 交易所名字 okex、huobi、bian、coinbase |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 涉及的链 | 交易所名 |
|---|---|---|---|
| 150 | Huobi交易所BTC流出实体 | BTC | Huobi |
| 151 | Huobi交易所BTC流入实体 | BTC | Huobi |
| 156 | Binance交易所BTC流出实体 | BTC | Binance |
| 157 | Binance交易所BTC流入实体 | BTC | Binance |
| 162 | Coinbase交易所BTC流出实体 | BTC | Coinbase |
| 163 | Coinbase交易所BTC流入实体 | BTC | Coinbase |
| 168 | Huobi交易所ETH流出实体 | ETH | Huobi |
| 169 | Huobi交易所ETH流入实体 | ETH | Huobi |
| 174 | Binance交易所ETH流出实体 | ETH | Binance |
| 175 | Binance交易所ETH流入实体 | ETH | Binance |
| 180 | Coinbase交易所ETH流出实体 | ETH | Coinbase |
| 181 | Coinbase交易所ETH流入实体 | ETH | Coinbase |
| 186 | Huobi交易所USDT流出实体 | STABLECOIN | Huobi |
| 187 | Huobi交易所USDT流入实体 | STABLECOIN | Huobi |
| 192 | Binance交易所USDT流出实体 | STABLECOIN | Binance |
| 193 | Binance交易所USDT流入实体 | STABLECOIN | Binance |
| 137 | OKEx交易所USDT流出实体 | STABLECOIN | OKEx |
| 138 | OKEx交易所USDT流入实体 | STABLECOIN | OKEx |
| 82 | OKEx交易所ETH流出实体 | ETH | OKEx |
| 83 | OKEx交易所ETH流入实体 | ETH | OKEx |
| 15 | OKEx交易所BTC流出实体 | BTC | OKEx |
| 16 | OKEx交易所BTC流入实体 | BTC | OKEx |
| 198 | Coinbase交易所USDT流出实体 | STABLECOIN | Coinbase |
| 199 | Coinbase交易所USDT流入实体 | STABLECOIN | Coinbase |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"project":huobi, //实体名称
"value":1404// 纵坐标值，object 类型
"price":1404.5// 价格，double 类型
}
]
}
流通量分布查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/circulation/ditribution
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/circulation/ditribution
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"project":"huidu",//持仓机构名称 huidu灰度，miner矿工，other其它，institution机构，other institutins其它机构，Anchored 锚定资产
"value":1404.5,// 数量 Double
"percent":0.56//持仓占比 Double
}
]
}
pending交易数查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/pending/count
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/pending/count
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":1620720000, //时间戳 long
"value":"1024",//pending数量 int
}
]}
}
小时级别链上数据查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/hour/search/(type)
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/hour/search/(type)
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，btc |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
| Path | type | String | 是 | 查询的指标 |
type选项值
| type | 含义 |
|---|---|
| avgGasPrice | 平均gasPrice |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"price"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404// 纵坐标值,object 类型
"price":1404.5// 价格,Double 类型
}
]
}
链上基础数据查询接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/chart/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/chart/{type}
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth、btc、usdt |
| Path | type | long | 是 | 指标id |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 36 | BTC链上总地址数 | BTC |
| 37 | BTC链上新增地址数 | BTC |
| 38 | BTC链上活跃地址数 | BTC |
| 41 | BTC链上非零地址数 | BTC |
| 104 | ETH链上总地址数 | ETH |
| 105 | ETH链上新增地址数 | ETH |
| 106 | ETH链上活跃地址数 | ETH |
| 109 | ETH链上非零地址数 | ETH |
| 96 | ETH流通量 | ETH |
| 99 | ETH市值 | ETH |
| 17 | BTC流通量 | BTC |
| 20 | BTC市值 | BTC |
| 85 | ETH链上日交易笔数 | ETH |
| 26 | BTC链上日交易笔数 | BTC |
| 87 | ETH日平均交易手续费 | ETH |
| 28 | BTC日平均交易手续费 | BTC |
| 29 | BTC链上大额交易笔数 | BTC |
| 88 | ETH链上大额交易笔数 | ETH |
| 89 | ETH平均区块大小 | ETH |
| 90 | ETH平均出块时间 | ETH |
| 91 | ETH全网算力 | ETH |
| 92 | ETH全网难度 | ETH |
| 93 | ETH单位算力收益 | ETH |
| 94 | ETH全节点数据大小 | ETH |
| 30 | BTC平均区块大小 | BTC |
| 31 | BTC平均出块时间 | BTC |
| 32 | BTC全网算力 | BTC |
| 33 | BTC全网难度 | BTC |
| 34 | BTC单位算力收益 | BTC |
| 35 | BTC全节点数据大小 | BTC |
| 139 | USDT链上日交易笔数 | STABLECOIN |
| 140 | USDT链上日交易量 | STABLECOIN |
| 141 | USDT链上大额交易笔数 | STABLECOIN |
| 142 | USDT链上总地址数 | STABLECOIN |
| 143 | USDT链上新增地址数 | STABLECOIN |
| 144 | USDT链上活跃地址数 | STABLECOIN |
| 145 | USDT链上非零地址数 | STABLECOIN |
| gasAvailability | gas利用率 | |
| avgGasPrice | gasprice（天级别） |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"价格"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404// 纵坐标值，object 类型
"price":1404.5// 价格，double 类型
}
]
}}
查询周月年级别统计数据实时
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/statistic/(type)
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/statistic/(type)
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth |
| Path | type | long | 是 | 查询的指标 |
| PARAM | startTime | long | 是 | 开始时间戳 |
| PARAM | endTime | long | 是 | 结束时间戳 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 36 | BTC链上总地址数 | BTC |
| 37 | BTC链上新增地址数 | BTC |
| 38 | BTC链上活跃地址数 | BTC |
| 41 | BTC链上非零地址数 | BTC |
| 104 | ETH链上总地址数 | ETH |
| 105 | ETH链上新增地址数 | ETH |
| 106 | ETH链上活跃地址数 | ETH |
| 109 | ETH链上非零地址数 | ETH |
| 96 | ETH流通量 | ETH |
| 99 | ETH市值 | ETH |
| 17 | BTC流通量 | BTC |
| 20 | BTC市值 | BTC |
| 85 | ETH链上日交易笔数 | ETH |
| 26 | BTC链上日交易笔数 | BTC |
| 87 | ETH日平均交易手续费 | ETH |
| 28 | BTC日平均交易手续费 | BTC |
| 29 | BTC链上大额交易笔数 | BTC |
| 88 | ETH链上大额交易笔数 | ETH |
| 89 | ETH平均区块大小 | ETH |
| 90 | ETH平均出块时间 | ETH |
| 91 | ETH全网算力 | ETH |
| 92 | ETH全网难度 | ETH |
| 93 | ETH单位算力收益 | ETH |
| 94 | ETH全节点数据大小 | ETH |
| 30 | BTC平均区块大小 | BTC |
| 31 | BTC平均出块时间 | BTC |
| 32 | BTC全网算力 | BTC |
| 33 | BTC全网难度 | BTC |
| 34 | BTC单位算力收益 | BTC |
| 35 | BTC全节点数据大小 | BTC |
| 139 | USDT链上日交易笔数 | STABLECOIN |
| 140 | USDT链上日交易量 | STABLECOIN |
| 141 | USDT链上大额交易笔数 | STABLECOIN |
| 142 | USDT链上总地址数 | STABLECOIN |
| 143 | USDT链上新增地址数 | STABLECOIN |
| 144 | USDT链上活跃地址数 | STABLECOIN |
| 145 | USDT链上非零地址数 | STABLECOIN |
| gasAvailability | gas利用率 | |
| avgGasPrice | gasprice（天级别） | |
| 200 | ETH 3iQ CoinShares Bitcoin ETF 持仓量 | ETH |
| 201 | ETH 3iQ CoinShares Bitcoin ETF持仓变化 | ETH |
| 202 | ETH CI Galaxy Bitcoin ETF 持仓量 | ETH |
| 203 | ETH CI Galaxy Bitcoin ETF持仓变化 | ETH |
| 204 | ETH Evolve Bitcoin ETF 持仓量 | ETH |
| 205 | ETH Evolve Bitcoin ETF持仓变化 | ETH |
| 206 | BTC 3iQ CoinShares Bitcoin ETF持仓量 | BTC |
| 207 | BTC 3iQ CoinShares Bitcoin ETF持仓变化 | BTC |
| 208 | BTC CI Galaxy Bitcoin ETF持仓量 | BTC |
| 209 | BTC CI Galaxy Bitcoin ETF持仓变化 | BTC |
| 210 | BTC Evolve Bitcoin ETF持仓量 | BTC |
| 211 | BTC Evolve Bitcoin ETF持仓变化 | BTC |
| 22 | 灰度BTC持仓量 | BTC |
| 23 | 灰度BTC持仓变化 | BTC |
| 24 | Purpose Bitcoin ETF持仓量 | BTC |
| 25 | Purpose Bitcoin ETF持仓变化 | BTC |
| 100 | 灰度ETH持仓量 | ETH |
| 101 | 灰度ETH持仓变化 | ETH |
| 102 | Purpose Ether ETF 持仓量 | ETH |
| 103 | Purpose Ether ETF持仓变化 | ETH |
| 21 | BTC锚定资产流通量 | BTC |
| 18 | BTC非活跃流通量 | BTC |
| 97 | ETH非活跃流通量 | ETH |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":
[
"price":{//指标名
"lastWeek": 123.4,//最近一周统计数据 double
"lastMonth": 123.4, //最近1月统计数据 double
"last3month": 123.4, //最近3月统计数据 double
"last6month": 123.4, //最近3月统计数据 double
"ytd": 123.4, //今年以来统计数据 double
"lastYear": 123.4, //最近一年统计数据 double
"priceLastWeek": 123.4//最近一周统计数据 double
"priceLastMonth": 123.4 //最近1月统计数据 double
"priceLast3month": 123.4 //最近3月统计数据 double
"priceLast6month": 123.4 //最近3月统计数据 double
"priceYtd": 123.4 //今年以来统计数据 double
"priceLastYear": 123.4 //最近一年统计数据 double
}
]
}
左侧指标导航接口
HTTP 请求
GET /api/oklink/v1/datamaster/indicators
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/indicators
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| - | - | - | - | - |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"btc":{//链
"market":[//分类
{
"targetId":2,//指标id
"targetNameEn":"price",//指标名英文 String
"targetNameZn":"btc价格",//指标名中文 String
"chain":"btc",//链 String
"category":"market",//分类 String
"type":["transaction","DEX"],//二级分类 String
"detail":"btc价格",//指标详情 String
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price"//url String
}
]
},
"eth":{
"market":[
{
"targetId":2,//指标id
"targetNameEn":"price",
"targetNameZn":"btc价格",
"chain":"btc",
"category":"market",//分类 String
"type":["transaction","DEX"],
"detail":"btc价格",
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price"
}
]
}
}
}
指标搜索接口
HTTP 请求
GET /api/oklink/v1/datamaster/indicators/search
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/indicators/search
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| param | q | String | 查询关键字 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"btc":[
{
"targetId":2,//指标id
"targetNameEn":"price",//指标名英文 String
"targetNameZn":"btc价格",//指标名中文 String
"chain":"btc",//链 String
"category":["market","miner"],//分类 String
"type":["transaction"],//二级分类 String
"detail":"btc价格"//指标解释 String
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price" //图标链接 String
}
],
"eth":[
{
"targetId":2,//指标id
"targetNameEn":"price",
"targetNameZn":"btc价格",
"chain":"btc",
"category":["market","miner"],//分类 String
"type":["transaction"],
"detail":"btc价格"
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price" //图标链接
}
]
}
}
指标过滤接口
HTTP 请求
GET /api/oklink/v1/datamaster/indicators/filter
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/indicators/filter
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| param | q | String | 根据活动id过滤指标，精选指标活动id为1 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"btc":[
{
"targetId":2,//指标id
"targetNameEn":"price",//指标名英文 String
"targetNameZn":"btc价格",//指标名中文 String
"chain":"btc",//链 String
"category":["market","miner"],//分类 String
"type":["transaction]",//二级分类 String
"detail":"btc价格"//指标解释 String
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price" //图标链接 String
}
],
"eth":[
{
"targetId":2,//指标id
"targetNameEn":"price",
"targetNameZn":"btc价格",
"chain":"btc",
"category":["market","miner"],//分类 String
"type":["transaction",
"detail":"btc价格"
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price" //图标链接
}
]
}
}
收藏指标查询接口
HTTP 请求
GET /api/oklink/v1/datamaster/indicators/feature
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/indicators/feature
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| head | token | String | token id |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"btc":[
{
"targetId":2,//指标id
"targetNameEn":"price",//指标名英文 String
"targetNameZn":"btc价格",//指标名中文 String
"chain":"btc",//链 String
"category":["market","miner"],//分类 String
"type":["transaction"],//二级分类 String
"detail":"btc价格"//指标解释 String
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price" //图标链接 String
}
],
"eth":[
{
"targetId":2,//指标id
"targetNameEn":"price",
"targetNameZn":"btc价格",
"chain":"btc",
"category":["market","miner"],//分类 String
"type":["transaction"],
"detail":"btc价格"
"description":"每日更新",//指标说明
"url":"/api/explorer/v1/btc/datamaster/chart/price" //图标链接
}
]
}
}
添加收藏接口
HTTP 请求
GET /api/oklink/v1/datamaster/indicators/feature/add
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/indicators/feature/add
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| param | targetId | Long | 指标Id |
返回结果
code为0表示成功，其它表示失败
{
"code":0,
"msg":"",
"detailMsg":"",
"data":null
}
}
//错误情况
{
"code": 4001,
"msg": "INDICATOR_NOT_FOUND",
"detailMsg": "INDICATOR_NOT_FOUND",
"data": null
}
取消收藏接口
HTTP 请求
GET /api/oklink/v1/datamaster/indicators/feature/delete
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/indicators/feature/delete
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| param | targetId | Long | 指标Id |
返回结果
code为0表示成功，其它表示失败
{
"code":0,
"msg":"",
"detailMsg":"",
"data": null
}
//错误情况
{
"code": 4001,
"msg": "INDICATOR_NOT_FOUND",
"detailMsg": "INDICATOR_NOT_FOUND",
"data": null
}
下载接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/indicators/download
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/indicators/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| param | targetId | String | 指标Id | |
| path | chain | String | 链 |
返回结果
文件
热门搜索接口
HTTP 请求
GET /api/oklink/v1/datamaster/popular/search
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/popular/search
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| - | - | - | - | - |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
{
"keyEn":"pool",
"keyZn":"矿池"
}
]
}
搜索二级分类接口
HTTP 请求
GET /api/oklink/v1/datamaster/type/search
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/type/search
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| PARAM | chain | String | 链名 | |
| PARAM | category | String | 分类 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":[
"dex",
"net"
]
}
下载周月年级别统计数据
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/statistic/(type)/download
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/statistic/(type)/download
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | 待查询区块链的符号小写，eth、btc、usdt |
| Path | type | String | 是 | 查询的指标 |
type选项值
| type | 含义 | 对应的链 |
|---|---|---|
| 36 | BTC链上总地址数 | BTC |
| 37 | BTC链上新增地址数 | BTC |
| 38 | BTC链上活跃地址数 | BTC |
| 41 | BTC链上非零地址数 | BTC |
| 104 | ETH链上总地址数 | ETH |
| 105 | ETH链上新增地址数 | ETH |
| 106 | ETH链上活跃地址数 | ETH |
| 109 | ETH链上非零地址数 | ETH |
| 96 | ETH流通量 | ETH |
| 99 | ETH市值 | ETH |
| 17 | BTC流通量 | BTC |
| 20 | BTC市值 | BTC |
| 85 | ETH链上日交易笔数 | ETH |
| 26 | BTC链上日交易笔数 | BTC |
| 87 | ETH日平均交易手续费 | ETH |
| 28 | BTC日平均交易手续费 | BTC |
| 29 | BTC链上大额交易笔数 | BTC |
| 88 | ETH链上大额交易笔数 | ETH |
| 89 | ETH平均区块大小 | ETH |
| 90 | ETH平均出块时间 | ETH |
| 91 | ETH全网算力 | ETH |
| 92 | ETH全网难度 | ETH |
| 93 | ETH单位算力收益 | ETH |
| 94 | ETH全节点数据大小 | ETH |
| 30 | BTC平均区块大小 | BTC |
| 31 | BTC平均出块时间 | BTC |
| 32 | BTC全网算力 | BTC |
| 33 | BTC全网难度 | BTC |
| 34 | BTC单位算力收益 | BTC |
| 35 | BTC全节点数据大小 | BTC |
| 139 | USDT链上日交易笔数 | STABLECOIN |
| 140 | USDT链上日交易量 | STABLECOIN |
| 141 | USDT链上大额交易笔数 | STABLECOIN |
| 142 | USDT链上总地址数 | STABLECOIN |
| 143 | USDT链上新增地址数 | STABLECOIN |
| 144 | USDT链上活跃地址数 | STABLECOIN |
| 145 | USDT链上非零地址数 | STABLECOIN |
| gasAvailability | gas利用率 | |
| avgGasPrice | gasprice（天级别） | |
| 200 | ETH 3iQ CoinShares Bitcoin ETF 持仓量 | ETH |
| 201 | ETH 3iQ CoinShares Bitcoin ETF持仓变化 | ETH |
| 202 | ETH CI Galaxy Bitcoin ETF 持仓量 | ETH |
| 203 | ETH CI Galaxy Bitcoin ETF持仓变化 | ETH |
| 204 | ETH Evolve Bitcoin ETF 持仓量 | ETH |
| 205 | ETH Evolve Bitcoin ETF持仓变化 | ETH |
| 206 | BTC 3iQ CoinShares Bitcoin ETF持仓量 | BTC |
| 207 | BTC 3iQ CoinShares Bitcoin ETF持仓变化 | BTC |
| 208 | BTC CI Galaxy Bitcoin ETF持仓量 | BTC |
| 209 | BTC CI Galaxy Bitcoin ETF持仓变化 | BTC |
| 210 | BTC Evolve Bitcoin ETF持仓量 | BTC |
| 211 | BTC Evolve Bitcoin ETF持仓变化 | BTC |
| 22 | 灰度BTC持仓量 | BTC |
| 23 | 灰度BTC持仓变化 | BTC |
| 24 | Purpose Bitcoin ETF持仓量 | BTC |
| 25 | Purpose Bitcoin ETF持仓变化 | BTC |
| 100 | 灰度ETH持仓量 | ETH |
| 101 | 灰度ETH持仓变化 | ETH |
| 102 | Purpose Ether ETF 持仓量 | ETH |
| 103 | Purpose Ether ETF持仓变化 | ETH |
| 21 | BTC锚定资产流通量 | BTC |
| 18 | BTC非活跃流通量 | BTC |
| 97 | ETH非活跃流通量 | ETH |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"btc",//链 String
"indicatorName":"价格"//指标名英文 String
"targetId":2,//指标id
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404// 纵坐标值，object 类型
"price":1404.5// 价格，double 类型
}
]
}}
合约验证接口
合约验证
HTTP 请求
POST（请使用https协议）/v1/{chain}/contract/verify
请求示例
POST https://www.oklink.com/api/explorer/v1/{chain}/contract/verify
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth |
| RequestBody | contractAddress | String | 是 | 需要验证的合约地址 |
| RequestBody | contractSource | String | 是 | 用户提交的合约源代码 |
| RequestBody | compilerVersion | String | 是 | 合约编译版本 |
| RequestBody | evmVersion | String | 是 | evm版本 |
| RequestBody | optimization | boolean | 否 | 是否优化 |
| RequestBody | optimizationRuns | Integer | 否 | 优化执行次数 |
| RequestBody | licenseType | String | 是 | 合约开源许可类型 |
| RequestBody | contractAbi | String | 否 | 合约初始化参数 |
| RequestBody | libraryList | List<> | 否 | 引入合约 |
| RequestBody | compilerType | String | 是 | 编译类型Solidity(SingleFile)\Solidity(MultipartFiles)\Vyper(Experimental) |
返回结果
验证成功
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":false,
"isSuccess":true,
"contractAddress":"0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f",
"contractCreateTxHash":"0x034c7f55fa92b432f3bf8d3bace5785b0f2c845a7adcbcf2c179228ef043f58d"
}
}
服务器错误
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"errorType":"SERVER_ERROR",
"isSuccess":false,
"statusCode":500
}
}
合约code不匹配
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":true,
"errorType":"CONTRACT_CODE_ERROR",
"isSuccess":false,
"contractErrorCodeList":[
{
"compileCode":"0x......",
"contractName":"Proxy"
},
{
"compileCode":"0x......",
"contractName":"ProxyERC20"
},
{
"compileCode":"0x......",
"contractName":"Proxyable"
},
{
"compileCode":"0x......",
"contractName":"Owned"
},
{
"compileCode":"0x",
"contractName":"IERC20"
}
],
"contractCreationCode":"0x......",
"contractAddress":"0xdac17f958d2ee523a2206206994597c13d831ec7",
"compilerVersion":"v0.4.25",
"optimizationRuns":200,
"statusCode":501
}
}
合约编译错误
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":true,
"errorType":"CONTRACT_COMPILE_ERROR",
"isSuccess":false,
"compilerVersion":"v0.4.25",
"optimizationRuns":200,
"compileErrorMessage":" Compiling your contracts... =========================== > Compiling ./contracts/Contract.sol ./contracts/Contract.sol:50:5: ParserError: Expected ';' but got 'address' address public nominatedOwner; ^-----^ [31mCompilation failed. See above.[39m Truffle v5.1.26 (core: 5.1.26) Node v12.16.3 ",
"statusCode":502
}
}
引入合约没有完全提供
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":false,
"errorType":"LIBRARY_NOT_PROVIDED",
"isSuccess":false,
"contractErrorCodeList":[
{
"compileCode":"0x......",
"contractName":"TestContract"
},
{
"compileCode":"0x......",
"contractName":"LibraryTestContract"
}
],
"contractCreationCode":"0x......",
"contractAddress":"0x398719cf929cf3c3b51891611e6092186df4c88f",
"compilerVersion":"v0.4.16",
"optimizationRuns":200,
"statusCode":503
}
}
编译后的合约中不存在提供的引入合约
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"errorLibraryMap":{
"SafeDecimalMath":"0x84d626b2bb4d0f064067e4bf80fce7055d8f3e7b"
},
"optimization":true,
"errorType":"PROVIDED_LIBRARY_ERROR",
"isSuccess":false,
"contractErrorCodeList":[
{
"compileCode":"0x......",
"contractName":"Proxy"
},
{
"compileCode":"0x......",
"contractName":"ProxyERC20"
},
{
"compileCode":"0x......",
"contractName":"Proxyable"
},
{
"compileCode":"0x......",
"contractName":"Owned"
},
{
"compileCode":"0x",
"contractName":"IERC20"
}
],
"contractCreationCode":"0x......",
"contractAddress":"0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f",
"compilerVersion":"v0.4.25",
"optimizationRuns":200,
"statusCode":504
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| isSuccess | String | 验证结果 |
| contractAddress | String | 合约地址 |
| contractCreateTxHash | String | 合约创建交易hash |
| compilerVersion | String | 合约编译版本 |
| optimization | boolean | 是否优化 |
| optimizationRuns | int | 优化次数 |
| errorType | String | 错误类型 |
| statusCode | int | 状态码 |
| compileErrorMessage | String | 合约编译错误信息 |
| contractCreationCode | String | 合约创建code |
| contractErrorCodeList | List |
合约编译错误code集合 |
| errorLibrary | String | 合约引入错误map |
多文件合约验证
HTTP 请求
POST（请使用https协议）/v1/{chain}/contract/multipartVerify
请求示例
POST https://www.oklink.com/api/explorer/v1/{chain}/contract/multipartVerify
请求参数
| 参数 scope | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| Path | Chain | String | 是 | eth |
| RequestParam | files | MultipartFile[] | 是 | |
| RequestBody | contractAddress | String | 是 | 需要验证的合约地址 |
| RequestBody | contractSource | String | 是 | 用户提交的合约源代码 |
| RequestBody | compilerVersion | String | 是 | 合约编译版本 |
| RequestBody | evmVersion | String | 是 | evm版本 |
| RequestBody | optimization | boolean | 否 | 是否优化 |
| RequestBody | optimizationRuns | Integer | 否 | 优化执行次数 |
| RequestBody | licenseType | String | 是 | 合约开源许可类型 |
| RequestBody | contractAbi | String | 否 | 合约初始化参数 |
| RequestBody | libraryList | List<> | 否 | 引入合约 |
| RequestBody | compilerType | String | 是 | 编译类型Solidity(SingleFile)\Solidity(MultipartFiles)\Vyper(Experimental) |
返回结果
验证成功
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":false,
"isSuccess":true,
"contractAddress":"0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f",
"contractCreateTxHash":"0x034c7f55fa92b432f3bf8d3bace5785b0f2c845a7adcbcf2c179228ef043f58d"
}
}
服务器错误
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"errorType":"SERVER_ERROR",
"isSuccess":false,
"statusCode":500
}
}
合约code不匹配
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":true,
"errorType":"CONTRACT_CODE_ERROR",
"isSuccess":false,
"contractErrorCodeList":[
{
"compileCode":"0x......",
"contractName":"Proxy"
},
{
"compileCode":"0x......",
"contractName":"ProxyERC20"
},
{
"compileCode":"0x......",
"contractName":"Proxyable"
},
{
"compileCode":"0x......",
"contractName":"Owned"
},
{
"compileCode":"0x",
"contractName":"IERC20"
}
],
"contractCreationCode":"0x......",
"contractAddress":"0xdac17f958d2ee523a2206206994597c13d831ec7",
"compilerVersion":"v0.4.25",
"optimizationRuns":200,
"statusCode":501
}
}
合约编译错误
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":true,
"errorType":"CONTRACT_COMPILE_ERROR",
"isSuccess":false,
"compilerVersion":"v0.4.25",
"optimizationRuns":200,
"compileErrorMessage":" Compiling your contracts... =========================== > Compiling ./contracts/Contract.sol ./contracts/Contract.sol:50:5: ParserError: Expected ';' but got 'address' address public nominatedOwner; ^-----^ [31mCompilation failed. See above.[39m Truffle v5.1.26 (core: 5.1.26) Node v12.16.3 ",
"statusCode":502
}
}
引入合约没有完全提供
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"optimization":false,
"errorType":"LIBRARY_NOT_PROVIDED",
"isSuccess":false,
"contractErrorCodeList":[
{
"compileCode":"0x......",
"contractName":"TestContract"
},
{
"compileCode":"0x......",
"contractName":"LibraryTestContract"
}
],
"contractCreationCode":"0x......",
"contractAddress":"0x398719cf929cf3c3b51891611e6092186df4c88f",
"compilerVersion":"v0.4.16",
"optimizationRuns":200,
"statusCode":503
}
}
编译后的合约中不存在提供的引入合约
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"errorLibraryMap":{
"SafeDecimalMath":"0x84d626b2bb4d0f064067e4bf80fce7055d8f3e7b"
},
"optimization":true,
"errorType":"PROVIDED_LIBRARY_ERROR",
"isSuccess":false,
"contractErrorCodeList":[
{
"compileCode":"0x......",
"contractName":"Proxy"
},
{
"compileCode":"0x......",
"contractName":"ProxyERC20"
},
{
"compileCode":"0x......",
"contractName":"Proxyable"
},
{
"compileCode":"0x......",
"contractName":"Owned"
},
{
"compileCode":"0x",
"contractName":"IERC20"
}
],
"contractCreationCode":"0x......",
"contractAddress":"0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f",
"compilerVersion":"v0.4.25",
"optimizationRuns":200,
"statusCode":504
}
}
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| isSuccess | String | 验证结果 |
| contractAddress | String | 合约地址 |
| contractCreateTxHash | String | 合约创建交易hash |
| compilerVersion | String | 合约编译版本 |
| optimization | boolean | 是否优化 |
| optimizationRuns | int | 优化次数 |
| errorType | String | 错误类型 |
| statusCode | int | 状态码 |
| compileErrorMessage | String | 合约编译错误信息 |
| contractCreationCode | String | 合约创建code |
| contractErrorCodeList | List |
合约编译错误code集合 |
| errorLibrary | String | 合约引入错误map |