介绍
OKLink是全球首家区块链大数据上市公司打造的区块链信息服务网站,旨在利用区块链+大数据技术为用户提供安全可靠的区块链信息服务。
OKLink作为业内领先的链上数据服务商,将自己强大的链上数据能力,以API的方式为区块链的开发者提供高质量的数据。开发人员使用GET/POST请求,通过RestAPI直接访问OKLink的浏览器和链上大师的数据服务,用于构建相关应用程序。
入门指引
欢迎您使用开发者文档。OKLink提供了简单而强大的RestAPI接口服务,您可以从众多API端点当中选用您需要的接口功能,来构建您的应用程序。非常适用于高校的学术课题研究、中心化交易所、公链开发、数字钱包、金融机构、业内媒体等群体。
如需使用OKLink的API服务或需要调整API接口的请求频率,请提供以下信息发送邮件至: [email protected]
,官方人员会在最短时间内与您进行沟通。
- 姓名
- 邮箱
- 电话
- 微信
- 使用场景描述
使用流程
1、邮件申请APIkey
2、官方人员为您提供专属的APIkey
3、使用APIKey访问RestAPI接口
使用方式
API请求地址URL如下:
- https://www.oklink.com/
APIkey使用方法:
- 对于每个API请求,需要在Http Request Headers 中添加(“x-apiKey”,填写您的专属APIkey)
举例说明:
- Request Headers
x-apiKey: 47e6bc5d-8e78-xxxxxxx4f3e86a3466
限速规则
为保证OKLink的API数据服务的质量,我们的所有RestAPI接口受到访问频率限制,如果您的请求速率达到限制,API请求将会被拒绝。因此在申请APIkey时,请提前预估所需的接口访问频率,并提出您所需的访问频率。
免费版 API
- 60次/分钟
- 试用30天
标准版 API
- 300次/分钟
专业版 API
- 1200次/分钟
机构版本 API
- 可支持定制化的需求和API限速
API 概述
使用OKLink的API,可以获取以下功能模块的数据:
- 公链基本信息
- 区块信息
- 链上交易信息
- 地址余额
- DeFi数据
- 链上大师的统计图表数据
如果您有特殊需求,请与我们联系,为您提供私人定制的API服务。
REST API
通用接口
主链通用查询接口
根据输入的高度/交易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":14727352,
"hits":[
{
"hash":"0x26eef60d6b3c9e9aa1c2197f2d389c1ad40efbb0d66160c743e154e7d5895d4e",
"height":14727351,
"transactionCount":69,
"previousBlockHash":"0xf76a9fed746296e8ebaed4cda80be6999cb5d607584b0e65d61cc2daae22268a",
"blocktime":1651892446,
"legalRate":2686.97,
"totalTransactionCount":1564295173,
"valueTotal":62.15543476484758,
"minerHash":"0xea674fdde714fd979de3edf0f56aa9716b898ec8",
"guessedMiner":"ethermine",
"size":28916,
"nonce":"303c173d53c758e3",
"sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"logsBloom":"0x6130210010280001808200c08001a000200000002400000080010400111000120404e802041800402000c108002001004206008028404001140000001821245000804000400200080800008e00000466001060480041000418001842800440208200009002241048140100a4442108100148003001000c401200241000000122042001600000000088cc000000800000844000c10b4840290040204000120842420a80010b02a83140004090008258204000420404020000890000cb18200150400004120000010000000041088098100040040a04c8801808040166010160848790322840040040003414a000000840045c00a323108040000409c11228a029",
"transactionsRoot":"0x89714c4351136575cd6d7db2800320da889a981c73fba60fbf7cab6071b2cbea",
"stateRoot":"0xc693d6950a16f79398109b3a982e9d6426d16f955e4f05f2c6229367af7cbd80",
"receiptsRoot":"0x53931eeecf92c246e2a34348ed25d71be4ecdaf55c2b3d7ce16c20451d38b954",
"mixHash":"0xf6324b5154301de65c568b763946b3dcd1bdf7fbda653689e0c36b5424c793b9",
"extraData":"asia-east2-7",
"extraDataHex":"0x617369612d65617374322d37",
"gasLimit":30029295,
"gasUsed":3781955,
"avgGasPrice":33448114388.15479,
"difficulty":"13805140443274576",
"totalDifficulty":"48289899294991253504404",
"reward":2,
"fee":0.12649926345085394,
"blockReward":2.007880231317462,
"uncleReward":0,
"tokenTransferCount":33,
"unclesCount":0,
"internalTranCount":26,
"internalValueTotal":22.010360176489694,
"hashRate":"0",
"tokenValueTotal":21590.386177401222,
"totalInternalTxCount":553174279,
"baseFeePreGas":31364474758,
"burntFee":0.1186190321333919,
"highestTip":0.000280144,
"totalTip":0.004436876185078048,
"confirm":1,
"minepoolName":"ethermine",
"minepoolCode":"ethermine",
"minepoolUrl":"",
"minepoolLogoUrl":"https://static.oklink.com/cdn/explorer/icon/pool/Ethermine.png"
}
]
}
}
返回参数
参数名 | 类型 | 描述 |
---|---|---|
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}/transactionsNoRestrict
请求示例
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 | 地址余额 |
地址接口
查询地址信息
查询一个地址的基本信息。
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 请求
GET /api/explorer/v1/{chain}/tokens
请求示例
GET https://www.oklink.com/api/explorer/v1/eth/tokens?t=1652081274542&offset=0&limit=20&type=ERC20
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
Path | chain | String | 是 | 待查询区块链的符号小写,例如:eth |
queryString | offset | Integer | 否 | 起始位置,默认0| |
queryString | limit | Integer | 否 | 返回条数,默认20条,最多20条| |
queryString | type | String | 否 | 代币类型 eth: erc20,erc721,erc1155 okc: kip20,kip721,kip1155,kip10| |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"total": 3736,
"hits": [
{
"symbol": "USDT",
"name": "tether",
"precision": 6,
"logoUrl": "https://static.oklink.com/cdn/explorer/ethToken/ETH_USDT_0xdac17f958d2ee523a2206206994597c13d831ec7.jpg",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"tokenType": "erc20",
"holders": 4573113,
"rank": 1,
"circulatingSupply": 8.321737709491782E10,
"legalRate": 2441.41,
"legalRateEth": 4.0987E-4,
"price": 4.0987E-4,
"volume24h": 3.025302190329312E7,
"percentChange1h": -0.007907899999999968,
"percentChange24h": -0.006820779999999971,
"percentChange7d": -0.02632597999999997,
"marketCap": 3.415696664763793E7,
"avgHolderValue": 0.0
}]}}
返回参数
参数名 | 类型 | 描述 |
---|---|---|
symbol | String | 币种 |
name | String | 名称 |
precision | Integer | 精度 |
logoUrl | String | logo链接 |
tokenContractAddress | String | 合约地址 |
tokenType | Integer | 币种类型 |
holders | Integer | 持币地址数 |
rank | Integer | 排名 |
circulatingSupply | Long | 流通量 |
legalRate | Integer | 法币价格 |
legalRateEth | Integer | 以eth为单位的法定利率 |
price | Integer | 价格(最小精度) |
volume24h | Long | 24小时的数量 |
percentChange1h | 1小时涨跌幅 | |
percentChange24h | Long | 24小时涨跌幅 |
percentChange7d | Long | 7天涨跌幅 |
marketCap | Long | 市值 |
avgHolderValue | Long | 平均持有数量 |
查询代币持仓详情
获取代币列表明细,获取持仓列表
HTTP 请求
GET /api/explorer/v1/{chain}/tokens/holders/{contractAddress}
请求示例
GET https://www.oklink.com/api/explorer/v1/eth/tokens/holders/0xdac17f958d2ee523a2206206994597c13d831ec7?offset=0&limit=20&address=0xdac17f958d2ee523a2206206994597c13d831ec7
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
Path | chain | String | 是 | 待查询区块链的符号小写,例如:eth |
Path | contractAddress | String | 是 | 合约地址 |
queryString | offset | Integer | 否 | 起始位置,默认0| |
queryString | limit | Integer | 否 | 返回条数,默认20条,最多20条| |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"total": 10000,
"hits": [
{
"holderAddress": "0x5754284f345afc66a98fbb0a0afe71e0f007b949",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"value": 1.822466100247277E9,
"transactionCount": 4082,
"firstTransferTime": 1532769326,
"lastTransferTime": 1652079226,
"totalSend": 5.839764061877673E10,
"totalReceive": 6.021610671902401E10,
"sendCount": 3163,
"receiveCount": 918,
"legalRateEth": 4.0621E-4,
"ethValue": 0.0,
"percentChange24h": 0.0,
"rate": 0.04577272189672151,
"precision": 6,
"rank": 1,
"isContract": false,
"hover": "Exchange: Bitfinex. Treasury",
"tag": "Bitfinex. Treasury",
"legalRate": 2451.71
}]}}
返回参数
参数名 | 类型 | 描述 |
---|---|---|
holderAddress | String | 持仓地址 |
tokenContractAddress | String | 合约地址 |
value | Integer | 持币数量 |
transactionCount | Integer | 交易次数 |
firstTransferTime | Integer | 第一笔交易时间 |
lastTransferTime | Integer | 最新一笔交易时间 |
totalSend | Integer | 总发送次数 |
totalReceive | Integer | 总接收次数 |
sendCount | Integer | 发送次数 |
receiveCount | Integer | 接收次数 |
legalRateEth | Integer | 以eth为单位的法定利率 |
ethValue | Integer | Eth数量 |
percentChange24h | Integer | 24小时涨跌幅 |
rate | Integer | 费率 |
precision | Integer | 精度 |
rank | Integer | 排名 |
isContract | bol | 是否是合约 |
hover | String | 备注 |
tag | String | 地址标签 |
legalRate | Long | 法币价格 |
查询未花费交易列表
查询一个地址未被花费的交易列表。
HTTP 请求
/api/explorer/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/defi/list
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/list
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/info
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/info
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/history
请求示例
GET https://www.oklink.com/api/explorer/v1/{chain}/defi/history
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/marketcap/list
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/marketcap/list
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/stablecoin/list
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/stablecoin/list
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/marketcap/chart
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/marketcap/chart
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/stablecoin/chart
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/stablecoin/chart
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/pegged/list
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/pegged/list
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/anchor/chart
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/anchor/chart
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/project/rate
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/project/rate
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/token/rate
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/token/rate
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/farmings
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/farmings
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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/defi/history
请求示例
GET https://www.oklink.com/api/explorer/v1/defi/history
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
request | 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":"OKC_TEST",
"price":0,
"lastBlockTime":1619053943000,
"totalTransacationCount":45402317,
"totalSupply":1002123882,
"totalSupplyPercent":100.2123882,
"pendingTransactionCount":0,
"runTime":18796351405,
"pricePercentChange24h":-0.060869565217391355,
"height":2251099
},
{
"symbol":"OKC_TEST",
"price":0,
"lastBlockTime":1619053943000,
"totalTransacationCount":45402317,
"totalSupply":1002123882,
"totalSupplyPercent":100.2123882,
"pendingTransactionCount":0,
"runTime":18796351405,
"pricePercentChange24h":-0.060869565217391355,
"height":2251099
},
{
"symbol":"OKC",
"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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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 |
86 | ETH链上日交易量 | ETH |
27 | BTC链上日交易量 | BTC |
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 |
返回结果
{
"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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
返回结果
{
"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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
返回结果
{
"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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
返回结果
{
"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/tag/address/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/tag/address/{type}
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
Path | Chain | String | 是 | 待查询区块链的符号小写,eth |
Path | type | long | 是 | 查询的指标id |
param | exchangeName | String | 是 | 交易所名字 okex、huobi、bian、coinbase |
Param | starttime | Long | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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 |
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 |
返回结果
{
"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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
返回结果
{
"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/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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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 | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
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/{chain}/datamaster/indicators/download
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/indicators/download
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
param | targetId | String | 是 | 指标Id。如:48 |
path | chain | String | 是 | 链 |
Param | starttime | Long | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
返回结果
文件
热门搜索接口
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 请求
GET /api/oklink/v1/{chain}/datamaster/circulation/distribution/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/circulation/distribution/{type}
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
Path | Chain | String | 是 | 待查询区块链的符号小写,eth、btc、usdt |
Path | type | String | 是 | 查询的指标 |
Param | starttime | Long | 是 | 开始时间,如:1604332800000 |
Param | endtime | Long | 是 | 结束时间,如:1649347199999 |
type值选项
type | 含义 | 链 |
---|---|---|
19 | btc流通量 | BTC |
98 | eth流通量 | ETH |
返回结果
{
"code": 0,
"msg": "",
"detailMsg": "",
"data": {
"chain": "btc",
"indicatorName": "BTC Supply Distribution",
"targetId": 19,
"detail": "The relative distribution of the circulating supply held by entity.",
"description": "该数据每日更新",
"exchangeName": null,
"updateTime": 1626051600000,
"content": [
{
"value": 0.0,
"usdtValue": 0.0,
"price": 33954.39,
"percent": 0.0,
"usdtFee": 0.0,
"usdtReward": 0.0,
"project": "other institution"
},
{
"value": 0.0,
"usdtValue": 0.0,
"price": 33954.39,
"percent": 0.0,
"usdtFee": 0.0,
"usdtReward": 0.0,
"project": "other"
},
{
"value": 0.0,
"usdtValue": 0.0,
"price": 33954.39,
"percent": 0.0,
"usdtFee": 0.0,
"usdtReward": 0.0,
"project": "exchange"
},
{
"value": 0.0,
"usdtValue": 0.0,
"price": 33954.39,
"percent": 0.0,
"usdtFee": 0.0,
"usdtReward": 0.0,
"project": "asset"
},
{
"value": 0.0,
"usdtValue": 0.0,
"price": 33954.39,
"percent": 0.0,
"usdtFee": 0.0,
"usdtReward": 0.0,
"project": "huidu"
},
{
"value": 0.0,
"usdtValue": 0.0,
"price": 33954.39,
"percent": 0.0,
"usdtFee": 0.0,
"usdtReward": 0.0,
"project": "miner"
}
],
"startTime": 0,
"id": null
}
}
查询链上大师所有指标接口
通过该接口获取链上大师所有指标数据,type填写对应的指标ID。
HTTP 请求
GET /api/oklink/v1/datamaster/common/data/target/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/datamaster/common/data/target/{type}
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
Path | type | long | 是 | 查询的指标ID| |
Param | starttime | Long | 是 | 开始时间,如:1604332800000| |
Param | endtime | Long | 是 | 结束时间,如:1649347199999| |
type选项值
type | 含义 |
---|---|
228 | OKC链上交易笔数 |
229 | OKC链上日交易量 |
232 | OKC总收入(区块奖励+手续费) |
233 | OKC日平均交易手续费 |
234 | OKC平均出块时间 |
235 | OKT流通量 |
237 | OKC链上总地址数 |
238 | OKC链上新增地址数 |
239 | OKC链上活跃地址数 |
240 | OKC链上非零地址数 |
241 | OKC代币数量 |
242 | OKC合约数量 |
243 | OKC去重合约数量 |
244 | OKC验证合约数量 |
245 | OKC合约调用次数 |
246 | OKC合约调用账户数 |
247 | OKC DeFi总锁仓 |
254 | OKT市值 |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"OKT",//链 String
"indicatorName":"price",//指标名英文 String
"targetId":2,//指标id long
"detail":"btc 价格",//指标含义 String
"description":"每日更新"//指标描述 String
"content":[
{
"statisDate":20150815, //日期 long
"value":1404,// 纵坐标值,object 类型
"usdtValue":1404,// value * price
"reward": 1403.2,//区块奖励 Double
"fee": 123.4//手续费 Double
"reward": 1403.2,//区块奖励 Double
"kip20TokenCount": 119,//kip20代币数量
"kip721TokenCount": 20,//kip721代币数量
"supplyRate": 0.238,//流通率
"price":1404.5// 价格,double 类型
}
]
}
OKC超级节点指标接口
HTTP 请求
GET /api/oklink/v1/{chain}/datamaster/distribution/{type}
请求示例
GET https://www.oklink.com/api/oklink/v1/{chain}/datamaster/distribution/{type}
请求参数
参数 scope | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
Path | chain | String | 是 | 待查询区块链的符号小写,eth、btc、usdt、OKC |
Path | type | String | 是 | 查询的指标 |
type选项值
type | 含义 | 对应的链 |
---|---|---|
252 | OKC超级节点出块分布图 | OKC |
253 | OKC超级节点的票分布图 | OKC |
返回结果
{
"code":0,
"msg":"",
"detailMsg":"",
"data":{
"chain":"OKC",
"indicatorName":"OKC Validator Block Distribution",
"targetId":252,
"detail":"OKC超级节点出块分布图",
"description":"该数据每日更新",
"exchangeName":null,
"updateTime":1633741200000,
"content":[
{
"value":323460,
"usdtValue":0,
"percent":0.05326415,
"usdtFee":0,
"usdtReward":0,
"project":"DeLab"
},
{
"value":6252,
"usdtValue":0,
"percent":0.00102952,
"usdtFee":0,
"usdtReward":0,
"project":"jiqix"
},
{
"value":203,
"usdtValue":0,
"percent":0.00003343,
"usdtFee":0,
"usdtReward":0,
"project":"OKLive"
}
],
"startTime":0,
"id":null
}
}
合约验证接口
合约验证
HTTP 请求
POST/api/explorer/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/api/explorer/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 |