比特派钱包下载|oklink
作者： 比特派钱包下载
2024-03-07 20:19:44
OKLink | The Best Multi-crypto Blockchain Explorer & Search Engine
nk | The Best Multi-crypto Blockchain Explorer & Search EngineBy clicking "Accept", you agree to the storing of cookies on your device to improve your browsing experience, analyze web traffic, and enhance security.AcceptExplorerOnchain AMLWhy OKLink Onchain AMLOKLink Onchain AML is committed to crypto compliance, risk prevention with cutting-edge technologies and premium servicesKYTMonitor on-chain risks to ensure crypto asset securityKYAGet an overview of address risks to improve compliance awarenessSecurity auditConduct on-chain data analysis for dual security protectionChaintelligenceWhy OKLink ChaintelligenceOKLink Chaintelligence serves as a pioneer of blockchain security to empower enforcement and compliance teamsCompliance analysis toolsMake investigations hassle-freeSituation awarenessDetect risks through smart alertsReport & ConsultReport crypto crime and access professional guidanceAPIsIntelligent Web3 data platformExplorer, data analytics, and service providerOne explorer, 0 chainsYour portal to the blockchain worldFeaturesAddressesTransactionsServicesCeFi rankingsAn accessible and transparent overview of on-chain assetsReduction & halving countdownWitness the reduction and halving events with usWeb3 toolkitFull collection of tools for asset security and developmentOn-chain insightsOne place for everything from rankings to most-searched dataToken approval checkerEasily query and manage token approvals under your address to avoid potential asset risksGet startedAddress monitoringMonitor addresses to know first-hand about high-profile transactionsGet startedPrivate labelCreate your exclusive address labelRich listAll the whale addresses at your fingertipsAddress analyticsBuild thorough address personas through asset, transaction behaviour, and major counterparty analysesTransaction mapTrace the source of transactions to keep your crypto assets safe and sound. Highlight high-risk addresses and suspicious transactions under real-time monitoringGet startedGas trackerFind the right time to trade0 GweiETH best Gas feeDeFi trackerReal-time monitoring of top DeFi projects and comprehensive analysis of 10 major trading behaviors to make sense of every transactionNFT tracerVisualized NFT traceability tool to acquire address information and transaction records for lower trading risksLarge transactionsMonitor large transactions in real time to keep you constantly informedOKLink APIEasy-to-use, powerful, and reliable services with all essential functionalities ranging from on-chain data to address monitoringExplore moreToken scannerOriginal risk assessment tool for securer on-chain transactionsGet startedReport & ConsultThe first Report & Consult platform to uphold justice and fairness in the blockchain industryContract auditAutomated detection and manual verification to produce industry-leading on-chain audit reportsBytecode decompilerDebug unverified contracts to ensure on-chain securitySubscribe for the latest crypto newsSubscribe
English简体中文English繁體中文DeutschEspañolFrançaisPortuguésPусскийTiếng ViệtTürkçe한국어日本語ExplorerBitcoinEthereumOKT ChainTRONBNB ChainPolygonzkSync EraStarkNetArbitrum OneOptimismEthereumPoWSuiCosmos HubTether USDAvalanche-CLitecoinDIS CHAINFantomOKT Chain TestnetX1 TestnetEthereum ClassicSolanaAptosBeacon ChainBitcoin CashDASHDogecoinGnosisKlaytnRoninLineaPolygon zkEVMScrollBaseopBNB MainnetGoerli TestnetSepolia TestnetAmoy TestnetPolygon zkEVM TestnetMumbai TestnetCantoManta PacificOnchain AMLKYTKYASecurity auditChaintelligenceCompliance analysis toolsSituation awarenessReport & ConsultAPIsAPI plansAPI documentationAPI managementMore about OKLinkAbout usTerms of servicePrivacy policy statementAcademyOTCContact usPartnership[email protected]Partnership[email protected]WechatTelegramTwitterWeiboDiscord© 2014-2024 OKLink.com. All Rights Reserved.Beijing ICP No. 2001701
OKLink API接入指南 | OKLink技术对接 | 欧科云链
OKLink API接入指南 | OKLink技术对接 | 欧科云链
导航
Onchain AML
浏览器
更新日志
Onchain AML1
浏览器
更新日志
English
浏览器 API 介绍
快速入门
入门指南
API 鉴权与调用示例
支持的公链
访问限制
支持与帮助
常见问题
错误码
联系我们
区块链通用数据
公链基础数据
查询公链列表
查询公链详情
查询区块基础信息
查询持币地址统计信息
查询最佳手续费或Gas费
查询链上交易统计信息
查询算力基础信息
查询挖矿基础信息
区块数据模块
查询区块头明细
查询区块列表
查询区块交易列表
批量查询区块交易列表
根据时间戳查询区块高度
查询区块倒计时时间
查询地址验证的区块列表
地址数据模块
获取地址基本信息
查询地址详细信息
查询地址活跃链
查询地址代币余额明细
查询代币余额明细
查询地址历史余额
查询地址交易列表信息
查询地址普通交易列表信息
查询地址内部交易列表信息
查询地址代币交易列表信息
批量查询地址实体标签
批量查询余额
批量查询代币余额
批量查询普通交易
批量查询内部交易
批量查询代币交易
富豪地址排行榜TOP100
主链币持仓地址排行榜
矿工数据模块
查询矿池份额
查询矿池算力排名
查询超级节点/验证人列表
交易数据模块
查询交易列表信息
查询大额交易列表
查询未确认交易列表
查询内部交易
查询代币交易
查询交易明细
批量查询交易明细
批量查询内部交易
批量查询代币交易
代币数据模块
查询代币列表信息
查询代币持仓列表详情
查询代币持仓地址统计数据
查询代币转帐详情
批量查询代币交易
查询代币历史供应量
日志数据模块
根据区块和地址查询事件日志
根据地址和topic查询事件日志
根据地址查询事件日志
查询交易事件日志
统计数据模块
查询链上统计数据
查询区块统计数据
查询gas统计数据
UTXO数据模块
查询地址UTXO交易
查询地址剩余UTXO
BRC20数据模块
查询inscriptions列表
查询BRC20代币列表
获取代币详细信息
代币持仓地址列表
查询代币转账列表
查询地址代币余额列表
查询地址代币余额明细
EVM数据模块
ETH通缩数据模块
获取ETH通缩概览
获取ETH通缩详情
获取ETH质押详情
获取ETH的gas历史
Beacon数据模块
查询信标链基础信息
查询信标链的出块列表
查询信标链验证者列表
查询信标链验证者详情
查询信标链的质押记录列表
查询信标链的赎回记录列表
查询提款凭证对应验证者详情
StarkNet数据模块
查询StarkNet区块头明细
查询StarkNet区块交易列表
查询StarkNet链地址代币余额明细
查询StarkNet地址普通交易列表信息
查询StarkNet地址代币交易列表信息
Cosmos数据模块
查询公链信息
查询区块头明细
查询区块交易列表
查询验证者信息
查询地址原生代币余额
查询地址代币余额明细
查询地址普通交易列表信息
查询交易列表信息
查询代币列表信息
查询代币持仓列表信息
批量查询代币价格
铭文数据模块
查询铭文代币列表
查询铭文代币持仓地址列表
查询铭文代币转账列表
查询铭文列表
查询地址持仓铭文代币列表
查询地址持仓铭文列表
查询地址铭文代币转账
根据交易哈希查询铭文代币交易明细
根据区块查询铭文代币交易明细
稳定币数据模块
查询USDT印钞/销毁记录
POR数据模块
获取交易所储备金
获取交易所历史储备金
获取交易所POR地址列表
获取交易所TOP50地址资产详情
获取交易所资产流动数据
NFT数据模块
所支持的链列表
NFT市场概览
获取集合的概览
获取集合详细数据
获取集合NFT列表
获取集合的持仓列表
获取集合地板价
获取NFT详细数据
获取NFT的持有者地址
获取NFT的历史交易
获取NFT的出价订单
获取NFT的出售订单
获取地址持有的NFT列表
Defi数据模块
查询借贷存取交易
查询借贷借还交易
查询借贷清算交易
Defi项目收益率和TVL
查询支持的Defi协议和公链
根据代币查询Defi数据
根据流动性池查询Defi数据
K线数据模块
支持公链列表
代币列表
代币历史数据
批量查询代币价格
代币市场数据
逐笔交易数据
链上工具模块
合约验证
验证合约源代码
查询合约源代码验证结果
使用hardhat进行合约验证
验证代理合约
查询代理合约验证结果
查询已验证合约的合约ABI和源代码
查询代币授权列表
查询地址授权代币列表
域名风险检测
广播交易上链
Webhook订阅服务
创建webhook任务
更新webhook任务条件
更新webhook任务状态
删除webhook任务
修改webhook任务地址集合
获取webhook任务列表
获取webhook任务订阅地址列表
获取webhook任务详情
webhook测试demo
RPC API
地址模块
查询地址本链币余额
批量查询地址本链币余额
查询地址普通交易列表
根据地址查询内部交易
根据交易哈希查询内部交易
根据区块高度查询内部交易
查询地址ERC-20代币转账
查询地址ERC-721代币转账
查询地址ERC-1155代币转账
查询地址验证的区块
查询地址历史本链币余额
合约模块
查询已验证合约的ABI
查询已验证合约的源代码
查询合约创建者和创建交易哈希
验证合约源代码
查询合约验证结果
验证代理合约
查询代理合约验证结果
交易模块
查询合约执行状态
查询交易执行状态
区块模块
查询区块奖励
查询区块预估倒计时时间
根据时间戳查询区块高度
查询每日平均区块大小
查询每日区块数量和奖励
查询每日区块奖励
查询每日平均出块时间
代币模块
查询ERC-20代币总供应量
查询地址ERC-20代币余额
查询ERC-20代币历史总供应量
查询地址ERC-20代币历史余额
查询ERC-20代币持仓地址列表
查询ERC-20/721/1155代币信息
查询地址ERC-20代币持仓列表
查询地址ERC-721代币持仓列表
查询地址特定ERC-721代币持仓列表
日志模块
查询事件日志
Gas模块
查询预估 gas 价格
查询每日平均 gas 限额
查询每日 gas 消耗总额
查询每日平均 gas 价格
统计模块
查询本链币总供应量
查询本链币最新价格
查询每日网络交易费用
查询每日新增地址数
查询每日网络利用率
查询每日交易数量
查询本链币历史每日价格
API使用和管理
查询公链支持接口
查询接口支持公链
API管理
查询订阅信息
查询历史调用数据
查询调用消耗TOP10接口
浏览器 API 介绍
OKLink 浏览器 API 为 Web3 开发人员提供高度可拓展的 API，获取所有主流 L1 及 L2 网络上最全面的区块链数据。OKLink 浏览器支持 40+ 主流 L1 及 L2 公链网络的逐块数据，并跟踪 200+ 区块链网络的代币价格数据，涵盖超过 700 万代币和 NFT。作为基础设施层，OKLink 浏览器 API 能够帮助开发者显著减少开发时间、基础设施成本和商业化时间。
OKLink 浏览器 API 是符合 OpenAPI 规范的 RESTful API，并提供 Webbook 服务。无论您有何数据需求，OKLink 浏览器 API 都可满足：主流 L1 及 L2 公链上的区块、交易、代币、NFT、市场数据等。
以下是我们目前支持的功能模块：
区块链通用数据：获取各公链的公链基础数据、区块数据、地址数据、矿工数据、交易数据、代币数据。
UTXO 数据模块：获取 BTC、BCH、LTC、DASH、DOGE 等 UTXO 链数据和 BRC-20 数据。
EVM 数据模块：获取 ETH 通缩数据、信标链数据、StarkNet 数据等。
Cosmos 数据模块：获取 Cosmos 的公链信息、区块信息、验证者信息、地址持仓和交易信息、代币信息等。
稳定币数据模块：获取 USDT 在 TRX、BTC、ETH 公链的发行和销毁记录。
交易所 POR 数据模块：获取 OKX、Binance、Bitfinex 等 9 家主流交易所的储备金详情、历史储备金记录、资产详情。
NFT 数据模块：获取 NFT 相关数据，包括项目合集数据、NFT 属性、NFT 稀有度、地板价等相关数据。
Defi 数据模块：获取 Defi 相关数据，包括 Defi 借贷（存取、借还、清算）、不同 Defi 项目的收益率和 TVL 数据。
K线数据模块：获取 200+ 公链的全币种代币行情数据、逐笔交易数据等。
链上工具模块：提供合约验证、查询地址授权代币列表、检测域名风险、广播交易等链上工具。
Webhook 订阅服务：用于订阅地址或链上发生的事件，并快速集成到您的应用当中。
同时，为了使各 EVM 系公链开发者能够低成本快速迁移至 OKLink，我们支持与 Etherscan 完全兼容的接口，包含以下模块：
RPC API：支持地址、合约、交易、区块、代币、日志、Gas、统计模块数据，所有 module（模块名称）、action（接口功能）及其他请求参数，均与 Etherscan 保持一致。
此外，为了更好地帮助您使用和管理 OKLink 浏览器 API，我们提供了 API 来查询公链支持的接口、接口支持的公链、订阅信息、调用统计数据。
API 使用和管理：查询不同公链支持的 API 接口、不同 API 接口支持的公链，以及您的 OKLink 浏览器 API 订阅信息、历史调用数据、调用消耗排名前十的接口。
快速入门入门指南
OKLink 浏览器 API 入门指南，快速了解如何创建账户、生成 API 密钥、进行身份验证等步骤，助力您利用 API 构建个性化应用。
进入 OKLink 官网，使用邮箱或手机号即可快速注册。
注册成功后使用邮箱或手机号登录。
进入 API 管理页面，创建您的 API 密钥。
使用 API 密钥，调用 OKLink 浏览器 API，开始您的数据探索之旅！
API 鉴权与调用示例
API 密钥是访问 API 接口的唯一身份标识，所有 OpenAPI 接口都需要 API 密钥鉴权才可访问。
您可根据自己的需求创建最多 5 个 API 密钥。为了您的数据安全，请不要和任何人共享您的 API 密钥。
API 请求地址 URL：
https://www.oklink.com/
API 密钥使用方法：
对于每个 API 请求，需要在 HTTP Request Headers 中添加 (“Ok-Access-Key”，填写您的 API 密钥)。
API 接口调用示例：
我们提供 cURL、Python、JavaScript - jQuery、Go、Java - OkHttp、PHP、Rust 不同语言的调用示例，帮助您快速上手。
cURL
curl -X GET 'https://www.oklink.com/api/v5/explorer/blockchain/summary' \
--header 'Ok-Access-Key:你的APIkey' \
--header 'Content-type: application/json'
Python
import requests
url = "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH"
payload = ""
headers = {
# apiKey
'Ok-Access-Key': 'apiKey'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
JavaScript - jQuery
var settings = {
"url": "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH",
"method": "GET",
"timeout": 0,
"headers": {
"Accept": "*/*",
"Ok-Access-Key": "apiKey",
},
};
$.ajax(settings).done(function (response) {
console.log(response);
});
Go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH"
method := "GET"
apiKey := "apiKey"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Ok-Access-Key", apiKey)
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Java - OkHttp
package com.oklink.demo;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class JavaDemo {
public static void main(String[] args) {
try {
String url = "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH";
String apiKey = "apiKey";
OkHttpClient client = new OkHttpClient.Builder().build();
Request request = new Request.Builder()
.url(url)
.addHeader("Ok-Access-Key", apiKey)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}catch (IOException e){
e.printStackTrace();
}
}
}
PHP
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
$headers = array();
$headers[] = 'Ok-Access-Key: apiKey';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Rust
extern crate reqwest;
use reqwest::header;
fn main() -> Result<(), Box
let mut headers = header::HeaderMap::new();
headers.insert("Ok-Access-Key", "apiKey".parse().unwrap());
let res = reqwest::Client::new()
.get("https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH")
.headers(headers)
.send()?
.text()?;
println!("{}", res);
Ok(())
}
支持的公链
OKLink 浏览器 API 目前支持包括主流 L1 及 L2 公链在内的 42 条公链：
公链全称
公链缩写符号
公链 ID
Bitcoin
BTC
0
Bitcoin Cash
BCH
145
Litecoin
LTC
2
DASH
DASH
5
Dogecoin
DOGE
3
Ethereum
ETH
1
OKT Chain
OKTC
66
BNB Chain
BSC
56
Ethereum Classic
ETC
61
Polygon
POLYGON
137
Avalanche-C
AVAXC
43114
EthereumPoW
ETHW
10001
Dis Chain (EthereumFair)
DIS (ETHF)
513100
Fantom
FTM
250
Canto
CANTO
70000014
OP Mainnet
OP
10
Arbitrum One
ARBITRUM
42161
KLAYTN
KLAYTN
8217
zkSync Era
ZKSYNC
324
Gnosis
GNOSIS
100
Ronin
RONIN
2020
LINEA
LINEA
59144
Beacon
BEACON
70000040
StarkNet
STARKNET
9004
Polygon zkEVM
POLYGON_ZKEVM
1101
Base
BASE
8453
Scroll
SCROLL
534352
Omega
OMEGA
408
Manta Pacific
MANTA
169
opBNB Mainnet
OPBNB
204
X1 Test
X1_TEST
19500
Sepolia Testnet
SEPOLIA_TESTNET
11155111
Goerli Testnet
GOERLI_TESTNET
70000030
Mumbai Testnet
MUMBAI_TESTNET
80001
Amoy Testnet
AMOY_TESTNET
80002
Polygon zkEVM Testnet
POLYGON_ZKEVM_TESTNET
1442
Aptos
APT
637
Sui
SUI
784
TRON
TRON
195
Cosmos Hub
COSMOS
118
Kava
KAVA
459
Evmos
EVMOS
710
此外，支持查询 200+ 条公链的币价数据
OKLink 浏览器 API 将逐步支持更多公链。如果您需要接入的公链不在列表中，请通过发送邮件至 [email protected] 与我们取得联系，我们将进行后续的评估和跟进。
访问限制
为防止 API 过载，我们对 API 调用实行访问限制，以确保最佳的处理速度和响应时间，并保证 OKLink 浏览器 API 使用和获取数据的安全性。对于免费用户和付费用户，我们采取不同的访问限制：
免费用户，限制为每个账户每秒 5 次
付费用户，限制为每个账户每秒 80 次
关于付费订阅方案，可登录后进入“API 管理页面 > 我的订阅 > 查看更多 API 方案”（弹窗中可查看具体方案）。
如果您收到 "errorcode": "50011" JSON 响应，则表明您已达到 API 速率限制。
支持与帮助 常见问题
1. 浏览器 API 支持多少条公链数据？
OKLink 浏览器 API 目前共支持包括主流 L1 及 L2 公链在内的 42 条公链，您可以在这里查看公链名单。
对于代币价格数据，OKLink 浏览器 API 目前共支持 200+ 条公链，您可以通过支持公链列表 查询支持的公链列表。
OKLink 浏览器 API 将逐步支持更多公链。如果您需要接入的公链不在列表中，请通过发送邮件至 [email protected] 与我们取得联系，我们将进行后续的评估和跟进。
2. 目前是否提供 SDK？
我们提供 cURL、Python、JavaScript - jQuery、Go、Java - OkHttp、PHP、Rust 不同语言的调用示例，以帮助您快速上手。您可以在这里查看详情。
3. 浏览器 API 是如何定价的？
关于订阅方案的价格，可登录后进入“API 管理页面 > 我的订阅 > 查看更多 API 方案”的弹窗中查看更多报价方案。
4. 如何查询不同 API 接口支持哪些公链？
您可以在对应 API 接口的描述中找到该接口支持的公链，也可以通过查询公链支持接口、查询接口支持公链进行查询。
5. 如何查看我的 API 调用量？
您可以在“API 管理页面 > 我的订阅”中查看您的总调用次数、剩余调用次数以及到期时间，也可以通过查询订阅信息接口查询以上数据，该接口也可以用于设置到期监控的预警。
此外，在这个模块下，您也可以通过查询历史调用数据和查询调用消耗Top 10接口查询您的历史调用消耗和消耗最多的接口，以帮助您实现 API 接口的个性化管理。
错误码
向服务器发出请求时，服务器会通过发出 HTTP 代码和错误代码来响应用户的请求。请参考下表进一步了解 API 调用失败时返回的不同错误码和错误提示。
返回示例
{
"code": "50038",
"msg": "This chain does not currently support.",
"data": []
}
以下是我们使用的错误代码及其含义：
通用类
错误提示
HTTP 状态码
错误码
操作成功
200
0
body不能为空
400
50000
服务暂时不可用，请稍后重试
503
50001
非法的json数据
400
50002
接口请求超时（不代表请求成功或者失败，请检查请求结果）
400
50004
接口已下线或无法使用
410
50005
无效的Content_Type，请使用"application/json"格式
400
50006
账户被封禁
200
50007
账户不存在
200
50008
账户因清算被暂停使用
200
50009
用户ID为空
200
50010
用户请求频率过快，超过该接口允许的限额
429
50011
账户状态无效
429
50012
当前系统繁忙，请稍后重试
200
50013
必填参数{0}不能为空
400
50014
参数{0}和{1}不能同时为空
400
50015
参数{0}和{1}不匹配
400
50016
参数{0}和{1}不能同时存在
200
50024
参数{0}传值个数超过最大限制{1}
200
50025
系统错误
500
50026
您没有该API接口的访问权限，需要升级您的账户付费等级
403
50030
参数{%}错误
400
50036
代币不存在
200
50037
该公链不支持
200
50038
该警报ID没有历史处理记录
200
50039
此区块高度无数据
200
50040
当前不支持该代币的历史余额查询
200
50041
该代币不支持风险扫描
200
50042
您的账户行为触发了风险控制，API功能已冻结。可以通过[email protected]与我们联系。
200
50043
数据不存在
400
50044
客户端操作错误
400
50045
鉴权类
错误提示
HTTP 状态码
错误码
Api 已被冻结，请联系客服处理
400
50100
请求时间戳过期
401
50102
请求头"OK_ACCESS_KEY"不能为空
401
50103
请求头"OK_ACCESS_PASSPHRASE"不能为空
401
50104
请求头"OK_ACCESS_PASSPHRASE"错误
401
50105
请求头"OK_ACCESS_SIGN"不能为空
401
50106
请求头"OK_ACCESS_TIMESTAMP"不能为空
401
50107
无效的IP
401
50110
无效的OK_ACCESS_KEY
401
50111
无效的OK_ACCESS_TIMESTAMP
401
50112
无效的签名
401
50113
无效的授权
401
50114
无效的请求类型
405
50115
超过了历史数据查询的范围
400
50117
业务类
错误提示
HTTP 状态码
错误码
{0}参数错误
404
51000
您填写的outputAddress地址在该交易中没有找到。
200
51001
这个索引所指定的outputAddress在这个交易中不存在。
200
51002
该笔交易Hash在区块链上未解析到交易信息，无法确定该笔交易风险详情。
200
51003
联系我们
若您想要咨询与 OKLink 浏览器 API 相关问题，可以通过以下方式联系我们：
微信号：jztbeijing，oklinkAPI
官方邮箱：[email protected]
电报 (Telegram)：https://t.me/OKLinkAPI
OKLink 保留对 API 工具的最终解释权。
区块链通用数据
区块链通用数据功能模块接口，可获取各公链的公链基础数据、区块数据、地址数据、矿工数据、交易数据、代币数据等。
公链基础数据
公链基础数据模块功能模块的接口，可获取所有支持的公链列表，公链的基础信息数据。
查询公链列表
获取OKLink目前所支持的所有公链列表，和每个链的基本信息。
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/blockchain/summary
请求示例
GET /api/v5/explorer/blockchain/summary
请求参数
参数名
类型
是否必须
描述
chainShortName
String
否
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"lastHeight": "812740",
"lastBlockTime": "1697622753000",
"circulatingSupply": "19517050",
"circulatingSupplyProportion": "0.9294",
"transactions": "913669129"
},
{
"chainFullName": "Bitcoin Cash",
"chainShortName": "BCH",
"symbol": "BCH",
"lastHeight": "815586",
"lastBlockTime": "1697622060000",
"circulatingSupply": "19534862.5",
"circulatingSupplyProportion": "0.9302",
"transactions": "376125240"
},
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"symbol": "ETH",
"lastHeight": "18376498",
"lastBlockTime": "1697623103000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "2127824775"
},
{
"chainFullName": "OKT Chain",
"chainShortName": "OKTC",
"symbol": "OKT",
"lastHeight": "22989718",
"lastBlockTime": "1697623102000",
"circulatingSupply": "20077976.25",
"circulatingSupplyProportion": "0.9560941071428571",
"transactions": "167592112"
},
{
"chainFullName": "X1_TEST",
"chainShortName": "X1_TEST",
"symbol": "OKB",
"lastHeight": "26938",
"lastBlockTime": "1700031881000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "26801.0"
},
{
"chainFullName": "BNB Chain",
"chainShortName": "BSC",
"symbol": "BNB",
"lastHeight": "32707931",
"lastBlockTime": "1697623106000",
"circulatingSupply": "151705624.6",
"circulatingSupplyProportion": "1",
"transactions": "3584346166"
},
{
"chainFullName": "Ethereum Classic",
"chainShortName": "ETC",
"symbol": "ETC",
"lastHeight": "18541162",
"lastBlockTime": "1697623087000",
"circulatingSupply": "143564715.29",
"circulatingSupplyProportion": "1",
"transactions": "115483536"
},
{
"chainFullName": "Litecoin",
"chainShortName": "LTC",
"symbol": "LTC",
"lastHeight": "2564279",
"lastBlockTime": "1697622845000",
"circulatingSupply": "73774507.97",
"circulatingSupplyProportion": "0.8783",
"transactions": "181126166"
},
{
"chainFullName": "DASH",
"chainShortName": "DASH",
"symbol": "DASH",
"lastHeight": "1956330",
"lastBlockTime": "1697623059000",
"circulatingSupply": "11499070.93",
"circulatingSupplyProportion": "0.6087",
"transactions": "49535771"
},
{
"chainFullName": "TRON",
"chainShortName": "TRON",
"symbol": "TRX",
"lastHeight": "55663883",
"lastBlockTime": "1697623107000",
"circulatingSupply": "90580932915.58",
"circulatingSupplyProportion": "1",
"transactions": "6.56881736E+9"
},
{
"chainFullName": "Polygon",
"chainShortName": "POLYGON",
"symbol": "MATIC",
"lastHeight": "48859754",
"lastBlockTime": "1697623104000",
"circulatingSupply": "9299803030.72",
"circulatingSupplyProportion": "",
"transactions": "3071306297"
},
{
"chainFullName": "Avalanche-C",
"chainShortName": "AVAXC",
"symbol": "AVAX",
"lastHeight": "36601091",
"lastBlockTime": "1697623102000",
"circulatingSupply": "354811879.38",
"circulatingSupplyProportion": "",
"transactions": "257890662"
},
{
"chainFullName": "Aptos",
"chainShortName": "APT",
"symbol": "APT",
"lastHeight": "104439850",
"lastBlockTime": "1697623100438",
"circulatingSupply": "245335823.53",
"circulatingSupplyProportion": "0",
"transactions": "289582063"
},
{
"chainFullName": "EthereumPoW",
"chainShortName": "ETHW",
"symbol": "ETHW",
"lastHeight": "18110977",
"lastBlockTime": "1697623090000",
"circulatingSupply": "107818999.05",
"circulatingSupplyProportion": "1",
"transactions": "1688548041"
},
{
"chainFullName": "DIS CHAIN",
"chainShortName": "DIS",
"symbol": "DIS",
"lastHeight": "18144023",
"lastBlockTime": "1697623083000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "1660726868"
},
{
"chainFullName": "Fantom",
"chainShortName": "FTM",
"symbol": "FTM",
"lastHeight": "69463847",
"lastBlockTime": "1697623104000",
"circulatingSupply": "2803634835.53",
"circulatingSupplyProportion": "0.883035",
"transactions": "446638938"
},
{
"chainFullName": "OP Mainnet",
"chainShortName": "OP",
"symbol": "ETH",
"lastHeight": "111012162",
"lastBlockTime": "1697623101000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "168183124"
},
{
"chainFullName": "Arbitrum One",
"chainShortName": "ARBITRUM",
"symbol": "ETH",
"lastHeight": "141661625",
"lastBlockTime": "1697623108000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "373814666"
},
{
"chainFullName": "Dogecoin",
"chainShortName": "DOGE",
"symbol": "DOGE",
"lastHeight": "4928818",
"lastBlockTime": "1697622845000",
"circulatingSupply": "141459666383.71",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "Sui",
"chainShortName": "SUI",
"symbol": "SUI",
"lastHeight": "15891997",
"lastBlockTime": "1697623099245",
"circulatingSupply": "860392959.69",
"circulatingSupplyProportion": "0.08603929596900001",
"transactions": "821855364"
},
{
"chainFullName": "KLAYTN",
"chainShortName": "KLAYTN",
"symbol": "KLAY",
"lastHeight": "135657958",
"lastBlockTime": "1697623108000",
"circulatingSupply": "3234951226.08",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "zkSync Era",
"chainShortName": "ZKSYNC",
"symbol": "ETH",
"lastHeight": "16684962",
"lastBlockTime": "1697623105000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "140220679"
},
{
"chainFullName": "Gnosis",
"chainShortName": "GNOSIS",
"symbol": "ETH",
"lastHeight": "30516833",
"lastBlockTime": "1697623100000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "Ronin",
"chainShortName": "RONIN",
"symbol": "RONIN",
"lastHeight": "28598542",
"lastBlockTime": "1697623106000",
"circulatingSupply": "251442247.22",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "LINEA",
"chainShortName": "LINEA",
"symbol": "LINEA",
"lastHeight": "659835",
"lastBlockTime": "1697623102000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "2127828200"
},
{
"chainFullName": "POLYGON_ZKEVM",
"chainShortName": "POLYGON_ZKEVM",
"symbol": "ETH",
"lastHeight": "6371025",
"lastBlockTime": "1697623096000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "5236188.0"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
lastHeight
String
最新区块高度
lastBlockTime
String
最新区块时间；Unix时间戳的毫秒数格式，如 1597026383085
circulatingSupply
String
当前公链本币流通数量
circulatingSupplyProportion
String
当前公链本币流通数量所占总供应量的比例，以小数展示.举例：0.85等于所占比例为85%
transactions
String
交易总数
查询公链详情
获取公链详情信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/info
请求示例
GET /api/v5/explorer/blockchain/info?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"rank": "1",
"mineable": true,
"algorithm": "SHA-256",
"consensus": "PoW",
"diffEstimation": "65.70T",
"currentDiff": "61.03T",
"diffAdjustTime": "1698582329000",
"circulatingSupply": "19517050",
"totalSupply": "21000000",
"tps": "3.16",
"lastHeight": "812742",
"lastBlockTime": "1697623175000",
"issueDate": "1231006505000"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
rank
String
公链市值排名
mineable
Bol
是否支持挖矿，例如：true / false
algorithm
String
核心算法，例如：SHA-256
consensus
String
共识算法，例如：PoW
diffEstimation
String
下次挖矿难度预测，BTC的单位：T， 如果该某个链没有该参数，返回""
currentDiff
String
当前全网挖矿难度
diffAdjustTime
String
下次挖矿难度调整时间
circulatingSupply
String
流通量
totalSupply
String
最大供应量
tps
String
链上每秒交易处理数量，近一周平均值
lastHeight
String
最新区块高度
lastBlockTime
String
最新区块时间；Unix时间戳的毫秒数格式，如 1597026383085
issueDate
String
发行日期；Unix时间戳的毫秒数格式，如 1597026383085
查询区块基础信息
获取公链详区块的基础信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/block
请求示例
GET /api/v5/explorer/blockchain/block?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"lastHeight": "812742",
"firstExchangeHistoricalTime": "1231006505000",
"firstBlockTime": "1231006505000",
"firstBlockHeight": "0",
"avgBlockInterval": "573.2926587301587",
"avgBlockSize24h": "1565974.456375839",
"avgBlockSize24hPercent": "-0.10001506153712443",
"mediaBlockSize": "1575044.942857143",
"halveTime": "1712805881000"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
lastHeight
String
最新区块高度
firstExchangeHistoricalTime
String
第一次交易时间 ；Unix时间戳的毫秒数格式，如 1597026383085
firstBlockTime
String
第一次出块时间；Unix时间戳的毫秒数格式，如 1597026383085
firstBlockHeight
String
第一个区块高度
avgBlockInterval
String
平均出块时间（近一周），单位是S
avgBlockSize24h
String
平均区块大小（24小时）
avgBlockSize24hPercent
String
平均区块大小涨跌幅（24小时）
mediaBlockSize
String
区块大小中位数（近一周）
halveTime
String
减半时间；Unix时间戳的毫秒数格式，如 1597026383085
查询持币地址统计信息
获取公链的持币地址统计信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/address
请求示例
GET /api/v5/explorer/blockchain/address?chainShortName=eth
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"symbol": "ETH",
"validAddressCount": "107721078",
"newAddressCount24h": "47093",
"totalAddresses": "305937721",
"newTotalAddresses24h": "109599",
"contractAddresses": "64007840",
"newContractAddresses24h": "19582",
"externalAddresses": "241929881",
"newExternalAddresses24h": "90017",
"activeAddresses": "714816",
"newActiveAddresses": "19728"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
validAddressCount
String
持公链本币地址数量
newAddressCount24h
String
持币地址数近24小时新增/减少量
totalAddresses
String
该链所有的地址数
newTotalAddresses24h
String
总地址数近24小时新增/减少量
contractAddresses
String
该链所有的合约地址数
newContractAddresses24h
String
合约地址数近24小时新增/减少量
externalAddresses
String
该链所有的普通地址数
newExternalAddresses24h
String
普通地址数24小时新增/减少量
activeAddresses
String
该链所有的活跃地址数
newActiveAddresses
String
活跃地址数24小时新增/减少量
查询最佳手续费或Gas费
获取公链Gas费的基础信息，支持公链：BTC, BCH, LTC, DASH, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, GNOSIS, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OPBNB, MANTA, CANTO, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/fee
请求示例
GET /api/v5/explorer/blockchain/fee?chainShortName=eth
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"symbol": "ETH",
"bestTransactionFee": "",
"bestTransactionFeeSat": "",
"recommendedGasPrice": "34.843994267",
"rapidGasPrice": "35.043994267",
"standardGasPrice": "34.793994267",
"slowGasPrice": "34.743994267",
"baseFee": "34.057663431",
"gasUsedRatio": "0.4781578,0.420984233333333333,0.5279502,0.485460466666666667,0.434564833333333333"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
bestTransactionFee
String
最佳交易手续费（币本位）
bestTransactionFeeSat
String
最佳交易手续费 （聪本位）
recommendedGasPrice
String
建议 Gas 费，ETH单位：Gwei
rapidGasPrice
String
极速 Gas 费，预估 15 s 内完成交易确认
standardGasPrice
String
一般 Gas 费，预估 3 分钟内完成交易确认
slowGasPrice
String
缓慢 Gas 费，预估大于 15 分钟完成交易确认
baseFee
String
每 Gas 基础费用
gasUsedRatio
String
最近 5 个区块的 Gas 消耗比例（即 Gas 消耗 / Gas 限额），以逗号分隔
查询链上交易统计信息
获取公链链上交易统计信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OPBNB, MANTA, CANTO
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/transaction
请求示例
GET /api/v5/explorer/blockchain/transaction?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"pendingTransactionCount": "22597",
"transactionValue24h": "34410716804875",
"totalTransactionCount": "913670420",
"tranRate": "3.16",
"avgTransactionCount24h": "1936.8523489932886",
"avgTransactionCount24hPercent": "0.0211",
"pendingTransactionSize": "164205183"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
pendingTransactionCount
String
未确认交易数
transactionValue24h
String
24 小时的链上交易量
totalTransactionCount
String
链上交易总数
tranRate
String
50个块的平均TPS
avgTransactionCount24h
String
24 小时平均交易数量
avgTransactionCount24hPercent
String
24 小时平均交易数量涨跌幅
pendingTransactionSize
String
未确认交易的大小
查询算力基础信息
获取公链算力的基础信息，支持公链：BTC, BCH, LTC, DASH, ETH, ETC
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/hashes
请求示例
GET /api/v5/explorer/blockchain/hashes?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"hashRate": "437.58EH",
"hashRateChange24h": "-0.0074"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
hashrate
String
近一周全网算力
hashrateChange24h
String
全网算力 24 小时涨跌幅，小数展示. 例如：正数为上涨；0.02，表示上涨2% 例如：负数为下跌：-0.02，表示下跌2%
查询挖矿基础信息
获取公链的挖矿基础信息，支持公链：BTC, BCH, LTC, DASH, ETH
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/blockchain/mine
请求示例
GET /api/v5/explorer/blockchain/mine?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"avgMineReward24h": "6.37771195",
"minerIncomePerUnit": "0.000002082802405598016",
"minerIncomePerUnitCoin": "0.000002060056106572138"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
公链原生代币，例如：btc
avgMineReward24h
String
24 小时平均区块奖励
minerIncomePerUnit
String
每单位算力收益
minerIncomePerUnitCoin
String
每单位算力收益币数
区块数据模块
区块数据模块的接口，可获取各个公链区块列表，区块交易明细，区块详情等信息
查询区块头明细
获取公链的区块明细，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/block-fills
请求示例
GET /api/v5/explorer/block/block-fills?chainShortName=eth&height=735732
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
是
区块高度
netWork
String
否
USDT该字段必填写，需要指定所属网络
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"hash": "0x545f02750b8fffe8354140b8ec2414fd72fa34a5ca93c58fe25f94c07ebb44ff",
"height": "735732",
"validator": "NanoPool",
"blockTime": "1450873643000",
"txnCount": "4",
"amount": "12.950329114",
"blockSize": "1509",
"mineReward": "5.012841864",
"totalFee": "0.012841864",
"feeSymbol": "ETH",
"ommerBlock": "0",
"merkleRootHash": "0xcfb7cc8bc5f11bb9c3e05a9fec1a17b63b0899a75624038a762ce800bda588b3",
"gasUsed": "249382",
"gasLimit": "3141592",
"gasAvgPrice": "0.000000051494751025",
"state": "",
"burnt": "",
"netWork": "",
"txnInternal": "0",
"miner": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5",
"difficuity": "8518354788907",
"nonce": "e246c1795e5cc38f",
"tips": "",
"confirm": "17640838",
"baseFeePerGas": ""
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
hash
String
块哈希
height
String
区块高度
validator
String
出块者/超级节点/验证人
blockTime
String
出块时间；Unix时间戳的毫秒数格式，如 1597026383085
txnCount
String
该区块包含的普通交易个数
amount
String
交易金额
blockSize
String
区块大小，单位是：bytes
mineReward
String
区块奖励，块收益等于mineReward+totalFee，以手续费币种为单位
totalFee
String
该区块所有手续费总和，以手续费币种为单位
feeSymbol
String
手续费币种
ommerBlock
String
叔块数量
merkleRootHash
String
梅克尔根哈希
gasUsed
String
gas消耗
gasLimit
String
gas限额
gasAvgPrice
String
gas均价，单位为ETH
state
String
块状态，确认中：pending、确认完成：done
burnt
String
销毁手续费数量
netWork
String
所在网络，展示对应公链的chainFullName 例如：TRON
txnInternal
String
该区块包含的内部交易个数
miner
String
打包该区块的矿工地址Hash
difficulty
String
打包该区块时的难度
nonce
String
在PoW区块链中，nonce用于描述挖矿难度
tips
String
块内最高小费，交易发起方为了优先打包自己的交易，愿意付给出块者的最大Gas单价
confirm
String
已确认区块数
baseFeePerGas
String
每Gas基础费，单位为ETH
查询区块列表
获取公链的区块列表信息，仅返回近1万条区块列表数据，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/block-list
请求示例
GET /api/v5/explorer/block/block-list?chainShortName=eth&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
否
区块高度
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"blockList": [
{
"hash": "0x68888279454c3a5e20b7f1b814d9b09c42ba13b6ee6e773a8d78dcc0a4bbcaf0",
"height": "18376580",
"validator": "unknown",
"blockTime": "1697624087000",
"txnCount": "134",
"blockSize": "159565",
"mineReward": "0.022295016661867617",
"totalFee": "0.09549692314174378",
"feeSymbol": "ETH",
"avgFee": "0.0007",
"ommerBlock": "0",
"gasUsed": "11074005",
"gasLimit": "30000000",
"gasAvgPrice": "0.000000008623521765",
"state": "",
"burnt": "0.07320190647987616",
"netWork": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
blockList
Array
交易列表
> hash
String
块hash
> height
String
区块高度
> validator
String
出块者/超级节点/验证人
> blockTime
String
出块时间；Unix时间戳的毫秒数格式，如 1597026383085
> txnCount
String
该区块包含的交易条数
> blockSize
String
区块大小，单位是：bytes
> mineReward
String
区块奖励，块收益等于mineReward+totalFee
> totalFee
String
该区块所有手续费总和
> feeSymbol
String
手续费币种
> avgFee
String
每笔交易平均手续费
> ommerBlock
String
叔块数量
> gasUsed
String
gas消耗
> gasLimit
String
gas限额
> gasAvgPrice
String
gas均价
> state
String
块状态 确认中:pending确认完成:done
> burnt
String
销毁手续费数量
> netWork
String
所在网络，展示对应公链的chainFullName 例如：TRON
查询区块交易列表
获取公链下的某一区块里的交易列表，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/transaction-list
请求示例
GET /api/v5/explorer/block/transaction-list?chainShortName=eth&height=18126560&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
是
区块高度
protocolType
String
否
不同类型的交易 普通交易：transaction 内部交易：internal 20代币：token_20 721代币：token_721 1155代币：token_1155 10代币：token_10 默认是transaction
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "635",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"blockList": [
{
"txid": "0x5a597e627d67a4e9daa9b710bf217c6690a2ac09521b45ffbb0b82b0f6d84245",
"methodId": "0x771d503f",
"blockHash": "0xadaed44b8d75332a8627a490cdd49e8aab227c901859f7918aea2b7f6d54e297",
"height": "18126560",
"transactionTime": "1694598095000",
"from": "0x104da4efb22a7e560e6df9c813e5eb54ca038737",
"isFromContract": false,
"isToContract": true,
"to": "0x51c72848c68a965f66fa7a88855f9f7784502a7f",
"amount": "0",
"transactionSymbol": "ETH",
"txfee": "0.004454715411444375",
"state": "success",
"tokenId": "",
"tokenContractAddress": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
blockList
Array
交易列表
> txid
String
交易哈希
> methodId
String
方法
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> isFromContract
Bol
From地址是否是合约地址
> isToContract
Bol
To地址是否是合约地址
> to
String
接收方地址
> amount
String
交易数量
> transactionSymbol
String
交易数量对应的币种
> txfee
String
手续费
> state
String
交易状态 success:成功 fail:失败 pending:等待确认
> tokenId
String
NFT的ID
> tokenContractAddress
String
代币合约地址
批量查询区块交易列表
批量获取公链下的某些区块的交易列表，最多返回最近10000笔交易，支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 3 点HTTP请求
GET /api/v5/explorer/block/transaction-list-multi
请求示例
GET /api/v5/explorer/block/transaction-list-multi?chainShortName=eth&startBlockHeight=18809970&endBlockHeight=18809972&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
startBlockHeight
String
是
开始查询的区块高度
endBlockHeight
String
是
结束查询的区块高度
protocolType
String
否
不同类型的交易 普通交易：transaction 内部交易：internal 20代币：token_20 721代币：token_721 1155代币：token_1155 默认是transaction
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "724",
"transactionList": [
{
"height": "18809972",
"txId": "0xb86c039478b97be1e4de569ffa227dd57c0aeb793955328d7d17674f9ec0cee1",
"blockHash": "0x5248621464bded6029e20a0b2da1e103bb31bc4048d8623619b82eb6c2da25ce",
"transactionTime": "1702867319000",
"from": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
"isFromContract": false,
"isToContract": false,
"to": "0x5c8d0eed35a9e632bb8c0abe4662b6ab3326850b",
"amount": "0.150851832900380503",
"transactionSymbol": "ETH",
"txFee": "0.000926296864164",
"state": "success",
"tokenId": "",
"tokenContractAddress": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
transactionList
Array
交易列表
> txId
String
交易哈希
> methodId
String
方法
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> isFromContract
Bol
From地址是否是合约地址
> isToContract
Bol
To地址是否是合约地址
> to
String
接收方地址
> amount
String
交易数量
> transactionSymbol
String
交易数量对应的币种
> txFee
String
手续费
> state
String
交易状态 success:成功 fail:失败 pending:等待确认
> tokenId
String
NFT的ID
> tokenContractAddress
String
代币合约地址
根据时间戳查询区块高度
查询特定时间出块的区块高度，支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, TRON, OKTC, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/block-height-by-time
请求示例
GET /api/v5/explorer/block/block-height-by-time?chainShortName=eth&time=1702366480000
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
time
String
是
查询的时间戳；Unix时间戳的毫秒数格式，如 1597026383085
closest
String
是
before：在该时间戳之前（包括该时间戳）出块的最近的区块 after：在该时间戳之后（包括该时间戳）出块的最近的区块 默认为before
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"height": "18768649",
"blockTime": "1702366475000"
}
]
}
返回参数
参数名
类型
描述
height
String
区块高度
blockTime
String
该区块实际出块时间，Unix时间戳的毫秒数格式，如 1597026383085
查询区块倒计时时间
查询某个区块验证完成的剩余预估时间，单位为秒；支持公链：ETH, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, GNOSIS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/block-count-down
请求示例
GET /api/v5/explorer/block/block-count-down?chainShortName=eth&countDownBlockHeight=18812000
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
countDownBlockHeight
String
是
要查询倒计时的区块高度
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"currentBlockHeight": "18810144",
"countDownBlockHeight": "18812000",
"remainingBlock": "1856",
"estimateTime": "22405.632"
}
]
}
返回参数
参数名
类型
描述
currentBlockHeight
String
当前最新的区块高度
countDownBlockHeight
String
要查询倒计时的区块高度
remainingBlock
String
剩余区块数量
estimateTime
String
区块验证完成预估剩余时间，单位为秒
查询地址验证的区块列表
查询特定地址验证的区块列表，最多返回最近10000条数据；支持公链：ETH, BSC, POLYGON
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/mined-block-list
请求示例
GET /api/v5/explorer/block/mined-block-list?chainShortName=eth&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
验证者地址
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"blockList": [
{
"height": "18811110",
"blockTime": "1702881083000",
"mineReward": "0.028655772120729006"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
blockList
Array
该地址验证的区块列表
> height
String
区块高度
> blockTime
String
出块时间；Unix时间戳的毫秒数格式，如 1597026383085
> blockReward
String
区块奖励，单位为本链币
地址数据模块
地址数据模块功能模块的接口，可以获取富豪地址排行榜、地址余额、地址基本信息、地址交易列表等相关数据
获取地址基本信息
获取某个地址余额信息，可以获取公链地址余额及所支持公链智能合约代币的余额等信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/address-summary
请求示例
GET /api/v5/explorer/address/address-summary?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"address": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
"contractAddress": "",
"balance": "0",
"balanceSymbol": "ETH",
"transactionCount": "3",
"verifying": "0",
"sendAmount": "0.00144563982877912",
"receiveAmount": "0.00144563982877912",
"tokenAmount": "0",
"totalTokenValue": "",
"createContractAddress": "",
"createContractTransactionHash": "",
"firstTransactionTime": "1649936533000",
"lastTransactionTime": "1673174795000",
"token": "",
"bandwidth": "",
"energy": "",
"votingRights": "",
"unclaimedVotingRewards": "",
"isAaAddress": false
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
address
String
普通地址
contractAddress
String
智能合约地址
balance
String
本链币余额
balanceSymbol
String
本链币余额币种
transactionCount
String
该地址交易次数
verifying
String
确认中金额
sendAmount
String
发送金额
receiveAmount
String
接收金额
tokenAmount
String
代币种类数量
totalTokenValue
String
代币总价值折算成公链原生币的数量
createContractAddress
String
创建该智能合约的地址
createContractTransactionHash
String
创建该智能合约的交易hash
firstTransactionTime
String
该地址发生第一笔交易时间
lastTransactionTime
String
该地址最近一次发生交易时间
token
String
该地址对应的代币
bandwidth
String
带宽和消耗的带宽（仅适用于TRON）
energy
String
能量和消耗的能量（仅适用于TRON），其他链返回“”
votingRights
String
投票全和已用投票权（仅适用于TRON）
unclaimedVotingRewards
String
待领取投票收益（仅适用于TRON）
isAaAddress
Bol
是否为AA地址true：是 false：不是
查询地址详细信息
获取某个地址详细信息，可获取地址余额、代币余额、合约调用次数、合约对应代币等信息，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/information-evm
请求示例
GET /api/v5/explorer/address/information-evm?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"balance": "0.000000000000000001",
"balanceSymbol": "ETH",
"transactionCount": "183337245",
"firstTransactionTime": "1511831234000",
"lastTransactionTime": "1697624363000",
"contractAddress": true,
"createContractAddress": "0x36928500bc1dcd7af6a2b4008875cc336b927d57",
"createContractTransactionHash": "0x2f1c5c2b44f771e942a8506148e256f94f1a464babc938ae0690c6e34cd79190",
"contractCorrespondingToken": "USDT",
"contractCalls": "5132287",
"contractCallingAddresses": "897673"
}
]
}
返回参数
参数名
类型
描述
address
String
普通地址
balance
String
本链币余额
balanceSymbol
String
本链币余额币种
transactionCount
String
该地址交易次数
firstTransactionTime
String
该地址发生第一笔交易时间
lastTransactionTime
String
该地址最近一次发生交易时间
contractAddress
Bol
是否为智能合约地址
createContractAddress
String
创建该智能合约的地址
createContractTransactionHash
String
创建该智能合约的交易hash
contractCorrespondingToken
String
该地址对应的代币，即通过该合约地址发行的代币
contractCalls
String
30天内合约被调用的次数
contractCallingAddresses
String
30天内调用合约的地址总数
查询地址活跃链
查询EVM系地址活跃的公链（即有交易），支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/address/address-active-chain
请求示例
GET /api/v5/explorer/address/address-active-chain?address=0xC098B2a3Aa256D2140208C3de6543aAEf5cd3A94
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Avalanche-C",
"chainShortName": "AVAXC",
"isContractAddress": true
},
{
"chainFullName": "BNB Chain",
"chainShortName": "BSC",
"isContractAddress": false
},
{
"chainFullName": "Polygon",
"chainShortName": "POLYGON",
"isContractAddress": false
},
{
"chainFullName": "EthereumPoW",
"chainShortName": "ETHW",
"isContractAddress": false
},
{
"chainFullName": "Fantom",
"chainShortName": "FTM",
"isContractAddress": false
},
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"isContractAddress": false
},
{
"chainFullName": "Gnosis",
"chainShortName": "GNOSIS",
"isContractAddress": false
},
{
"chainFullName": "DIS CHAIN",
"chainShortName": "DIS",
"isContractAddress": false
},
{
"chainFullName": "OP Mainnet",
"chainShortName": "OP",
"isContractAddress": false
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
isContractAddress
Bol
是否为智能合约地址
查询地址代币余额明细
获取某个地址代币余额明细，可以获取该地址上的所有代币余额信息，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/token-balance
请求示例
GET /api/v5/explorer/address/token-balance?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&protocolType=token_20&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
tokenContractAddress
String
否
代币合约地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "308",
"tokenList": [
{
"symbol": "FNK",
"tokenContractAddress": "0xb5fe099475d3030dde498c3bb6f3854f762a48ad",
"holdingAmount": "115.71687581",
"priceUsd": "",
"valueUsd": "34.25416242664877",
"tokenId": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> symbol
String
该地址对应的代币
> tokenContractAddress
String
该地址对应的代币合约地址
> holdingAmount
String
代币持仓数量
> priceUsd
String
代币美元价格
> valueUsd
String
代币总的美元价值
> tokenId
String
NFT 的ID
查询代币余额明细
获取某个地址余额明细，可以获取该地址上的代币余额信息，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
该接口为老接口，建议使用该模块下 查询地址代币余额明细
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/address-balance-fills
请求示例
GET /api/v5/explorer/address/address-balance-fills?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
否
不同的代币类型，20代币：token_20，721代币：token_721，1155代币：token_1155，默认为token_20
tokenContractAddress
String
否
代币合约地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "308",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"tokenList": [
{
"token": "USDT",
"tokenId": "",
"holdingAmount": "406275.909624",
"totalTokenValue": "257.29075982",
"change24h": "0.00010996",
"priceUsd": "1.00046",
"valueUsd": "406462.79654242704",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
tokenList
Array
代币列表
> token
String
该地址对应的代币
> tokenContractAddress
String
该地址对应的代币合约地址
> holdingAmount
String
代币持仓数量
> totalTokenValue
String
代币总价值折算成公链原生币的数量
> change24h
String
代币价格24小时涨跌幅
> priceUsd
String
代币美元价格
> valueUsd
String
代币总的美元价值
> tokenId
String
NFT 的ID
查询地址历史余额
通过该接口获取某条链指定区块高度下本链币或者代币的历史余额，该接口每小时更新可查询的区块高度，接口限速为5次/s，支持公链：BTC, ETH, POLYGON,POLYGON_ZKEVM, AVAXC, OP, ARBITRUM, TRON
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/address-balance-history
请求示例
GET /api/v5/explorer/block/address-balance-history?chainShortName=eth&height=18376634&address=0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
是
区块高度
address
String
是
查询余额的地址
tokenContractAddress
String
否
代币合约地址，如果不填写，查本链代币的余额；如果填写，查询指定代币的历史余额
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"address": "0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701",
"height": "18376634",
"balance": "5.895934930980364414",
"balanceSymbol": "ETH",
"tokenContractAddress": "",
"blockTime": "1697624735000"
}
]
}
返回参数
参数名
类型
描述
address
String
查询余额的地址
height
String
区块高度
balance
String
余额
blockTime
String
出块时间；Unix时间戳的毫秒数格式，如 1597026383085
tokenContractAddress
String
代币合约地址，如果是本链币的查询，该字段返回""
balanceSymbol
String
余额币种，如果是本链币的，为本链代币名称，如果是指定代币的，为代币的缩写名称
查询地址交易列表信息
获取OKLink目前所支持的公链的交易列表，仅返回近1万条交易数据，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/transaction-list
请求示例
GET /api/v5/explorer/address/transaction-list?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
否
不同类型的交易 交易：transaction 内部交易：internal 20代币：token_20 721代币：token_721 1155代币：token_1155 10代币：token_10 trx转账：trx 默认是transaction
tokenContractAddress
String
否
代币合约地址
page
String
否
页码,默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"transactionLists": [
{
"txId": "0x18714d659c9022eecd29bff3cd05cb78adc6c0b9522b04d713bfb2cc7a2f62f0",
"methodId": "",
"blockHash": "0xea0ee963034d87aeaccd6a0513725bec2a604b6a890e85d96289bfcd547154db",
"height": "16361564",
"transactionTime": "1673174795000",
"from": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
"to": "0xcffad3200574698b78f32232aa9d63eabd290703",
"isFromContract": false,
"isToContract": false,
"amount": "0.000567475798167289",
"transactionSymbol": "ETH",
"txFee": "0.000430211335176",
"state": "success",
"tokenId": "",
"tokenContractAddress": "",
"challengeStatus": "",
"l1OriginHash": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
transactionList
Array
交易列表
> txId
String
交易哈希
> methodId
String
方法
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间，pending交易返回广播时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> to
String
接收方地址
> isFromContract
Bol
From地址是否是合约地址
> isToContract
Bol
To地址是否是合约地址
> amount
String
交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动。
> transactionSymbol
String
交易数量对应的币种
> txFee
String
手续费
> state
String
交易状态 success 成功 fail 失败 pending 等待确认
> tokenId
String
NFT的ID
> tokenContractAddress
String
交易数量对应的币种的合约地址
> challengeStatus
String
挑战期状态
> l1OriginHash
String
L1执行交易哈希
查询地址普通交易列表信息
获取地址相关的普通交易列表，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/normal-transaction-list
请求示例
GET /api/v5/explorer/address/normal-transaction-list?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
startBlockHeight
String
否
开始区块高度
endBlockHeight
String
否
最终区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0xac39ce204486c83fa1aef285456a7e0d76f4a76976ab5ab65bcea98d97ee8508",
"methodId": "0xa9059cbb",
"nonce": "0",
"gasPrice": "8438956495",
"gasLimit": "94813",
"gasUsed": "63209",
"blockHash": "0x62a73bc006e481f6f6da53c3d71ea7a8f20c78de4b12a8eaa89d59d68501eefc",
"height": "18383240",
"transactionTime": "1697704715000",
"from": "0xf284512f225b350bf6e71d5a327891fcd26f640c",
"to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"isFromContract": false,
"isToContract": true,
"amount": "0",
"symbol": "ETH",
"txFee": "0.000533418001092455",
"state": "success",
"transactionType": "2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> methodId
String
方法
> nonce
String
发起者地址发起的第几笔交易
> gasPrice
String
gas价格
> gasLimit
String
gas限额
> gasUsed
String
gas消耗
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> to
String
接收方地址
> isFromContract
Bol
From地址是否是合约地址
> isToContract
Bol
To地址是否是合约地址
> amount
String
交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动
> symbol
String
交易数量对应的币种
> txFee
String
手续费
> state
String
交易状态 success 成功 fail 失败 pending 等待确认
> transactionType
String
交易类型 0：原始交易类型 1:EIP2930 2:EIP1559 同时支持查询Tron交易类型
查询地址内部交易列表信息
获取地址相关的内部交易列表，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/internal-transaction-list
请求示例
GET /api/v5/explorer/address/internal-transaction-list?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
startBlockHeight
String
否
开始区块高度
endBlockHeight
String
否
最终区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x34d5bd0c44da0864cfb8b9d7f3311d5eb598a4093b26dd5df5d25ec0e9df4942",
"operation": "call",
"blockHash": "0xee4e80ebc8a4b8071b07abd63906a4201bcf76d66100369a39148a0f529d098c",
"height": "18376673",
"transactionTime": "1697625227000",
"from": "0x3a5cc8689d1b0cef2c317bc5c0ad6ce88b27d597",
"to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"isFromContract": true,
"isToContract": true,
"amount": "0",
"symbol": "ETH"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> operation
String
操作类型
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> to
String
接收方地址
> isFromContract
Bol
From地址是否是合约地址
> isToContract
Bol
To地址是否是合约地址
> amount
String
交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动
> symbol
String
交易数量对应的币种
查询地址代币交易列表信息
获取地址相关的代币交易交易列表，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/token-transaction-list
请求示例
GET /api/v5/explorer/address/token-transaction-list?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&protocolType=token_20&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
代币类型，20代币：token_20，721代币：token_721，1155代币：token_1155，10代币：token_10，默认为token_20
tokenContractAddress
String
否
代币合约地址
startBlockHeight
String
否
开始区块高度
endBlockHeight
String
否
最终区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x66e4b648d6b82c5e2cfdd2121af896a11618c69a356c307e2403a885a8503c88",
"blockHash": "0x6199c61f711a797e7bc88b213a5ae71374898a413e5e20f9f8ad420189088e82",
"height": "18376245",
"transactionTime": "1697620043000",
"from": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"to": "0xce7a837e1717301cb30d668ec6fcc9f4d312f30f",
"tokenContractAddress": "0xd8daa146dc3d7f2e5a7df7074164b6ad99bed260",
"tokenId": "",
"amount": "1450000000",
"symbol": "",
"isFromContract": true,
"isToContract": false
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> to
String
接收方地址
> isFromContract
Bol
From地址是否是合约地址
> isToContract
Bol
To地址是否是合约地址
> tokenContractAddress
String
代币的合约地址
> amount
String
交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动
> symbol
String
交易数量对应的币种
> tokenId
String
NFT 的ID
批量查询地址实体标签
批量查询某条公链上最多20个地址的实体标签，仅返回有交易所大地址标签和项目标签的地址，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, STARKNET, BASE, SCROLL, OMEGA, OPBNB
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/address/entity-label
请求示例
GET /api/v5/explorer/address/entity-label?chainShortName=eth&address=0x539C92186f7C6CC4CbF443F26eF84C595baBBcA1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：btc、eth
address
String
是
地址，最多可以输入20个地址，以,分隔
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"label": "OKX.Cold Wallet",
"address": "0x539c92186f7c6cc4cbf443f26ef84c595babbca1"
}
]
}
返回参数
参数名
类型
描述
label
String
该地址实体标签，如Binance.Deposit；若地址有多个实体标签，以,分隔
address
String
地址
批量查询余额
可以批量查询最多50个地址的原生代币的余额，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/address/balance-multi
请求示例
GET /api/v5/explorer/address/balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址，最多可以输入50个地址，以,分隔
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"symbol": "ETH",
"balanceList": [
{
"address": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
"balance": "0"
},
{
"address": "0xb13a8883d5116b418066c379bc3b3f40d087b8d8",
"balance": "0.00019330554147975"
}
]
}
]
}
返回参数
参数名
类型
描述
symbol
String
公链原生代币
balanceList
Array
原生代币持仓列表
> address
String
地址
> balance
String
原生代币持仓余额
批量查询代币余额
可以批量查询最多50个地址的代币的余额，一个地址如果持有多个代币，则会有多条数据，每页最多返回2000条数据，支持公链：LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/address/token-balance-multi
请求示例
GET /api/v5/explorer/address/token-balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址，最多可以输入50个地址，以,分隔
protocolType
String
否
不同的代币类型，20代币：token_20，721代币：token_721，1155代币：token_1155，默认为token_20
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "686",
"balanceList": [
{
"address": "0xf977814e90da44bfa03b6295a0616a897441acec",
"holdingAmount": "400",
"tokenContractAddress": "0x7379cbce70bba5a9871f97d33b391afba377e885"
},
{
"address": "0xf977814e90da44bfa03b6295a0616a897441acec",
"holdingAmount": "123101078.45198849",
"tokenContractAddress": "0x5c885be435a9b5b55bcfc992d8c085e4e549661e"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
页码
limit
String
每页返回的数据条数，默认最小20条，最多2000条
totalPage
String
总共的页数
balanceList
Array
余额列表
> address
String
地址
> holdingAmount
String
代币的余额
> tokenContractAddress
String
代币的合约地址
批量查询普通交易
可以批量查询最多20个地址的普通交易，需要限制查询的开始区块高度以及结束的区块高度，两者差距不能超过10000个区块，支持公链：LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/address/normal-transaction-list-multi
请求示例
GET /api/v5/explorer/address/normal-transaction-list-multi?chainShortName=eth&address=00x533a7ae90fee4cafbc00e6a551cfb39a954cbf48,0xc0a3465b50a47848b7d04e145df61565d3e10566&endBlockHeight=18374343&startBlockHeight=18374341
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址，最多可以输入20个地址，以,分隔
startBlockHeight
String
是
开始搜索的区块号
endBlockHeight
String
是
结束搜索的区块号
page
String
否
页码
limit
String
否
每页返回的数据条数，默认最小20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "0x76e650150abadac6c781c9c90a0fcda69fce6e69f0fbbfb08d8cadc26076802a",
"methodId": "",
"blockHash": "0x58c6a91b0b5ff04bb7ea9b9f264c547472a96dafbdb069acc1e2e8d63792db16",
"height": "18374343",
"transactionTime": "1697597087000",
"from": "0x533a7ae90fee4cafbc00e6a551cfb39a954cbf48",
"to": "0xc0a3465b50a47848b7d04e145df61565d3e10566",
"isFromContract": false,
"isToContract": false,
"amount": "15296",
"symbol": "ETH",
"txFee": "0.000139810264818",
"gasLimit": "21000",
"gasUsed": "21000",
"gasPrice": "6657631658",
"nonce": "",
"transactionType": "2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
页码
limit
String
每页返回的数据条数，默认最小20条，最多100条
totalPage
String
总共的页数
transactionList
Array
交易列表
> txId
String
交易哈希
> methodId
String
标识智能合约函数的短哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易发生的时间；Unix时间戳的毫秒数格式，如1597026383085
> from
String
交易发送方的地址，多个地址，以,分隔
> to
String
交易接受方的地址，多个地址，以,分隔
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> amount
String
代币数量
> symbol
String
交易代币的符号
> txFee
String
交易的手续费（单位ETH）
> gasLimit
String
gas最大使用量
> gasUsed
String
实际的gas使用量（单位Wei）
> gasPrice
String
gas价格（单位Wei）
> nonce
String
发起者地址发起的第几笔交易
> transactionType
String
交易类型 0：原始交易类型 1：EIP2930 2：EIP1559 同时支持查询Tron交易类型
批量查询内部交易
可以批量查询最多20个地址的内部交易，需要限制查询的开始区块高度以及结束的区块高度，两者差距不能超过10000个区块，支持公链：LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/address/internal-transaction-list-multi
请求示例
GET /api/v5/explorer/address/internal-transaction-list-multi?chainShortName=eth&address=0xd501520326d41aead2a70d4b5bf0c4646c0c9bd8,0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701&endBlockHeight=18374470&startBlockHeight=18370000&limit=1
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址，最多可以输入20个地址，以,分隔
startBlockHeight
String
是
开始搜索的区块号
endBlockHeight
String
是
结束搜索的区块号
page
String
否
页码
limit
String
否
每页返回的数据条数，默认最小20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "7",
"transactionList": [
{
"txId": "0xfcc0b4d18791f5932ba7e3563012a176ef0d9f959e0beefc34f6956a0d0043b6",
"blockHash": "0x6eab9220138600d0cd66b73737aec77c016c18c91e13e93a938b7477e1e18865",
"height": "18373050",
"transactionTime": "1697581427000",
"operation": "call",
"from": "0x09fa0d3154363036ea406f254808c53f5f975518",
"to": "0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701",
"isFromContract": true,
"isToContract": false,
"amount": "2450"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
页码
limit
String
每页返回的数据条数，默认最小20条，最多100条
totalPage
String
总共的页数
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易发生的时间；Unix时间戳的毫秒数格式，如1597026383085
> operation
String
操作类型
> from
String
交易发送方的地址，多个地址，以,分隔
> to
String
交易接受方的地址，多个地址，以,分隔
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> amount
String
代币数量
批量查询代币交易
可以批量查询最多20个地址的代币交易，需要限制查询的开始区块高度以及结束的区块高度，两者差距不能超过10000个区块，支持公链：LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/address/token-transaction-list-multi
请求示例
GET /api/v5/explorer/address/token-transaction-list-multi?chainShortName=eth&address=0xd501520326d41aead2a70d4b5bf0c4646c0c9bd8,0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701&endBlockHeight=18374470&startBlockHeight=18370000&limit=1
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址，最多可以输入20个地址，以,分隔
startBlockHeight
String
是
开始搜索的区块号
endBlockHeight
String
是
结束搜索的区块号
page
String
否
页码
limit
String
否
每页返回的数据条数，默认最小20条，最多100条
protocolType
String
否
代币类型，20代币：token_20，721代币：token_721，1155代币：token_1155，10代币：token_10，默认为token_20
tokenContractAddress
String
否
代币的合约地址，最多可以输入20个地址，以,分隔
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "88",
"transactionList": [
{
"txId": "0x644fe2fbc53316c3146760ecdb1405fc2dcb4893ac19552ad0898ea669176300",
"blockHash": "0xd027f203664d2911cb2bf2f73134539e6f7b5ac20be6ca998b7ea3691acfcd3d",
"height": "18373112",
"transactionTime": "1697582183000",
"from": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"to": "0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701",
"isFromContract": true,
"isToContract": false,
"amount": "1",
"tokenId": "1",
"symbol": "Airdrop",
"tokenContractAddress": "0xf7b24c63fe941f2caadaee49f10e565d850be067"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
页码
limit
String
每页返回的数据条数，默认最小20条，最多100条
totalPage
String
总共的页数
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易发生的时间；Unix时间戳的毫秒数格式，如1597026383085
> from
String
交易发送方的地址，多个地址，以,分隔
> to
String
交易接受方的地址，多个地址，以,分隔
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> amount
String
代币数量
> tokenId
String
NFT代币ID，适用于721和1155代币
> symbol
String
交易代币的符号
> tokenContractAddress
String
交易代币的合约地址
富豪地址排行榜TOP100
获取某个公链或合约的地址余额排行前100名地址详情，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/rich-list
请求示例
GET /api/v5/explorer/address/rich-list?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
否
代币合约地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"rank": "1",
"address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
"amount": "248597.39163733",
"transactionCount": "842",
"holdRatio": "0.0118",
"netWork": ""
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
symbol
String
持仓币种
rank
String
地址余额排名
address
String
持仓地址
amount
String
持仓数量
transactionCount
String
该地址交易次数
holdRatio
String
该地址余额与总流通量的占比
netWork
String
所在网络，仅适用于USDT
主链币持仓地址排行榜
获取某个公链的主链币持仓地址列表，仅返回余额Top 10000的地址信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, AMOY_TESTNET, MUMBAI_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/native-token-position-list
请求示例
GET /api/v5/explorer/address/native-token-position-list?chainShortName=ETH
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
page
String
否
页码
limit
String
否
每页返回的数据条数，默认最小20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "3",
"totalPage": "3334",
"positionList": [
{
"rank": "1",
"symbol": "ETH",
"holderAddress": "0x00000000219ab540356cbb839cbe05303d7705fa",
"amount": "35312968.32606823"
},
{
"rank": "2",
"symbol": "ETH",
"holderAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"amount": "3234638.2256898033"
},
{
"rank": "3",
"symbol": "ETH",
"holderAddress": "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8",
"amount": "1996008.379796362"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
页码
limit
String
每页返回的数据条数，默认最小20条，最多100条
totalPage
String
总共的页数
positionList
Array
持仓列表
> rank
String
地址余额排名
> symbol
String
持仓币种
> address
String
持仓地址
> amount
String
持仓数量
矿工数据模块
矿工数据模块功能模块的接口，可获取公链矿池的算力排名、超级节点、验证人列表、矿池份额
查询矿池份额
获取各个矿池所占的预估份额，支持公链：BTC, BCH, LTC, DASH, ETH
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/pool/estimated-pool-share
请求示例
GET /api/v5/explorer/pool/estimated-pool-share?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
period
String
否
筛选日期1D；3D；1W；1M；3M；1Y；All默认为1D
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "1",
"poolName": "AntPool",
"hashrate": "0",
"ratio": "0.2933",
"blockCount": "44",
"emptyBlockCount": "0",
"ommerBlockCount": "0",
"avgBlockSize": "",
"avgFee": "0.12343160636363637",
"minerFeeRatio": "0.0197"
},
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "2",
"poolName": "Foundry USA",
"hashrate": "0",
"ratio": "0.28",
"blockCount": "42",
"emptyBlockCount": "0",
"ommerBlockCount": "0",
"avgBlockSize": "",
"avgFee": "0.14027478785714284",
"minerFeeRatio": "0.0224"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
rank
String
爆块数量排名
poolName
String
矿池名称
hashrate
String
算力
ratio
String
爆块份额占比，以小数展示，精确到小数点后4位
blockCount
String
区块数量
emptyBlockCount
String
空块数量
ommerBlockCount
String
叔块数量
avgBlockSize
String
平均区块大小，单位为：Bytes
avgFee
String
平均交易手续费
minerFeeRatio
String
矿工费占比，以小数展示，精确到小数点后4位
查询矿池算力排名
获取某个公链矿池算力排名，支持公链：BTC, BCH, LTC, DASH, ETH
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/pool/pool-hashrate-rank
请求示例
GET /api/v5/explorer/pool/pool-hashrate-rank?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
category
String
否
数据类别real：实时数据estimated：预估数据默认为 real
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "1",
"poolName": "Foundry USA",
"hashrate": "127637910960000010000",
"change24h": "0.0174",
"luckyRatio": "1.0347"
},
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "2",
"poolName": "AntPool",
"hashrate": "115000000000000000000",
"change24h": "0.0000",
"luckyRatio": "1.0785"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Ethereum
chainShortName
String
公链缩写符号，例如：ETH
rank
String
算力排名
poolName
String
矿池名称
hashrate
String
算力
change24h
String
算力24小时涨跌幅，以小数展示，精确到小数点后4位
luckyRatio
String
幸运比值，以小数展示，精确到小数点后4位
查询超级节点/验证人列表
获取OKLink目前所支持的公链的超级节点或者验证人列表，支持公链：OKTC, X1_TEST, BSC, TRON
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/pool/validator-list
请求示例
GET /api/v5/explorer/pool/validator-list?chainShortName=bsc&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
period
period
否
筛选日期：1D；1W；3M；1Y；All 默认为1D
validatorName
String
否
验证者名称
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "33",
"validatorList": [
{
"rank": "1",
"validatorName": "Fuji",
"validatorAddress": "0x7ae2f5b9e386cd1b50a4550696d957cb4900f03a",
"weightRatio": "0.05",
"weight": "",
"blocks": "1323",
"staked": "1118400.13217862",
"stakedSymbol": "BNB",
"reward": "-0.07670620656615305",
"rewardSymbol": "BNB",
"state": "-1",
"firstHeight": "48",
"latestHeight": "32710953",
"type": ""
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
validatorList
Array
验证者列表
> rank
String
排名
> validatorName
String
验证者名称
> validatorAddress
String
验证者地址
> weightRatio
String
权重占比
> weight
String
权重
> blocks
String
出块的个数
> staked
String
质押数量（预估值）
> stakedSymbol
String
质押的代币名称
> reward
String
奖励
> rewardSymbol
String
奖励的代币名称
> state
String
验证者状态
> firstHeight
String
第一个块高
> latestHeight
String
最后一个块高
> type
String
Tron节点类型 SUPER，超级代表 SUPERPARTNER，超级代表合伙人SUPERCANDIDATE，超级代表候选人
交易数据模块
交易数据模块功能模块的接口，可获取某个链的交易信息，交易列表。
查询交易列表信息
获取公链的交易列表，仅返回近1万条交易数据，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/transaction-list
请求示例
GET /api/v5/explorer/transaction/transaction-list?chainShortName=btc&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
blockHash
String
否
区块哈希
height
String
否
区块高度
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"transactionList": [
{
"txid": "8b09dcbc5604284aa88e171e75d717557d9668d4f5499a0db2a7522e478ac3dc",
"blockHash": "000000000000000000021a5bdbd89b086bf6932db2751cf7a01ca873317b3231",
"height": "812753",
"transactionTime": "1697632271000",
"input": "bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d",
"output": "bc1qlavjjmxghslxj6qrcjy2rs5mv7pugy3mzawt80,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d",
"isInputContract": false,
"isOutputContract": false,
"amount": "0.00499015",
"transactionSymbol": "BTC",
"txfee": "0.0007215",
"methodId": "",
"transactionType": "",
"state": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
transactionList
Array
交易列表
> txid
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> input
String
输入地址，如果存在多个地址，以英文逗号分隔
> output
String
输出地址 ，如果存在多个地址，以英文逗号分隔
> isFromContract
Bol
input地址是否是合约地址
> isToContract
Bol
output地址是否是合约地址
> amount
String
交易数量
> transactionSymbol
String
交易数量对应的币种
> txfee
String
手续费
> methodId
String
方法
> transactionType
String
交易类型0：原始交易类型 1：EIP2930 2：EIP1559
> state
String
交易状态 success 成功 fail 失败 pending 等待确认
查询大额交易列表
获取公链上的大额交易列表，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/large-transaction-list
请求示例
GET /api/v5/explorer/transaction/large-transaction-list?chainShortName=btc&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
type
String
否
查询交易数量大于该数量的交易，最低限额为100；若未填写，默认为100
blockHash
String
否
区块哈希
height
String
否
区块高度
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"transactionList": [
{
"txid": "bca066292115784d9e83263df6b520794d43b8a8ac8622b03fc7ef6803331710",
"blockHash": "000000000000000000003549b3b7fcdff3a6328021eeabdae70c57e0fd3776c5",
"height": "812747",
"transactionTime": "1697627155000",
"input": "3D68UNbZVkaxZHGeXZ553xudqGfGjcF5y2",
"output": "3MNZCAW6C8rGQKzS39tARXnKVUcRyFF379,3JFudoNxai4Mg9TTB97PZ1i5kZHZ1EzJPT",
"isInputContract": false,
"isOutputContract": false,
"amount": "5119.9088941",
"transactionSymbol": "BTC",
"txfee": "0.0000498",
"methodId": "",
"transactionType": "",
"state": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
transactionList
Array
交易列表
> txid
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> input
String
输入，如果存在多个地址，以,分隔
> output
String
输出，如果存在多个地址，以,分隔
> isInputContract
Bol
input地址是否是合约地址
> isOutputContract
Bol
output地址是否是合约地址
> amount
String
数量
> transactionSymbol
String
交易数量对应的币种
> txfee
String
手续费
> methodId
String
方法
> transactionType
String
交易类型0：原始交易类型 1：EIP2930 2：EIP1559
> state
String
交易状态 success 成功 fail 失败 pending 等待确认
查询未确认交易列表
获取公链上的未确认交易列表信息，仅返回近1万条交易数据，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/unconfirmed-transaction-list
请求示例
GET /api/v5/explorer/transaction/unconfirmed-transaction-list?chainShortName=btc&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"transactionList": [
{
"txid": "e41a58a47d2f9220c367780acd8fc9ee8461b964f1b6ffb3dd610302681b7656",
"height": "",
"transactionTime": "",
"input": "bc1qxx76udl8kjahmlvd8xktaflxgyg0gn664ucw00",
"output": "3GzPyo2eJJgjRB3C3e6w2SfX1heuiPnixo",
"isInputContract": false,
"isOutputContract": false,
"amount": "0.002321",
"transactionSymbol": "BTC",
"txfee": "2220",
"methodId": "",
"transactionType": "",
"randomNumber": "",
"status": "pending"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
transactionList
Array
交易列表
> txid
String
交易哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> isInputContract
Bol
input地址是否是合约地址
> isOutputContract
Bol
output地址是否是合约地址
> input
String
输入，如果存在多个地址，以,分隔
> output
String
输出，如果存在多个地址，以,分隔
> amount
String
交易数量
> transactionSymbol
String
交易数量对应的币种
> txfee
String
手续费
> methodId
String
方法
> transactionType
String
交易类型0：原始交易类型 1：EIP2930 2：EIP1559
> randomNumber
String
随机数
> state
String
交易状态 success 成功 fail 失败 pending 等待确认
查询内部交易
通过交易哈希获取内部交易，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/internal-transaction-detail
请求示例
GET /api/v5/explorer/transaction/internal-transaction-detail?chainShortName=eth&txId=0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易Hash
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10",
"internalTransactionDetails": [
{
"txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
"from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"height": "18076803",
"transactionTime": "1693995971000",
"isFromContract": true,
"isToContract": true,
"operation": "call",
"amount": "0.002",
"state": "success"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
internalTransactionDetails
Array
内部交易详情
> txId
String
交易哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式
> from
String
交易发送方的地址
> to
String
交易接受方的地址
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> operation
String
操作类型
> amount
String
交易数量
> state
String
交易状态
查询代币交易
通过交易哈希获取代币交易，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/token-transaction-detail
请求示例
GET /api/v5/explorer/transaction/token-transaction-detail?chainShortName=eth&txId=0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易哈希
protocolType
String
否
不同类型的交易
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"tokenTransferDetails": [
{
"txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
"from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"to": "0xf66369997ae562bc9eec2ab9541581252f9ca383",
"height": "18076803",
"transactionTime": "1693995971000",
"isFromContract": true,
"isToContract": true,
"tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "WETH",
"amount": "0.002"
},
{
"txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
"from": "0xf66369997ae562bc9eec2ab9541581252f9ca383",
"to": "0xb59ac29fadba6818628a6cb0060a4b57fc4a7126",
"height": "18076803",
"transactionTime": "1693995971000",
"isFromContract": true,
"isToContract": false,
"tokenContractAddress": "0xbc396689893d065f41bc2c6ecbee5e0085233447",
"symbol": "PERP",
"amount": "4.23951772020582"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenTransferDetails
Array
代币交易详情
> txId
String
交易哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式
> from
String
交易发送方的地址
> to
String
交易接受方的地址
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> tokenContractAddress
String
代币合约地址
> symbol
String
交易代币的符号
> amount
String
交易数量
查询交易明细
获取公链链上交易基础信息，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
该接口为老接口，建议使用该模块下其他接口查询交易详细信息
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/transaction-fills
请求示例
GET /api/v5/explorer/transaction/transaction-fills?chainShortName=eth&txid=0x3ae59abf714df29a15bb8ecadfbe3068aff20693bb91c7e7c9d34ce245d56def
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txid
String
是
交易哈希，最多可批量查询20笔交易，以英文逗号分隔
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"txid": "0x3ae59abf714df29a15bb8ecadfbe3068aff20693bb91c7e7c9d34ce245d56def",
"height": "18126676",
"transactionTime": "1694599499000",
"amount": "0.1",
"transactionSymbol": "ETH",
"txfee": "0.000491371954353",
"index": "576",
"confirm": "250634",
"inputDetails": [
{
"inputHash": "0xe61771cd810d82e6ef302f69c76fbaf0538818c7",
"isContract": false,
"amount": ""
}
],
"outputDetails": [
{
"outputHash": "0x095624a01088cca5aae036c128cc9ac8032b9a3c",
"isContract": false,
"amount": ""
}
],
"state": "success",
"gasLimit": "21000",
"gasUsed": "21000",
"gasPrice": "0.000000023398664493",
"totalTransactionSize": "",
"virtualSize": "0",
"weight": "",
"nonce": "1365",
"transactionType": "2",
"methodId": "",
"errorLog": "",
"inputData": "0x",
"isAaTransaction": false,
"tokenTransferDetails": [],
"contractDetails": []
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
txid
String
交易哈希
height
String
交易发生的区块
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
transactionType
String
交易类型 0：原始交易类型 1：EIP2930 2：EIP1559
amount
String
交易数量
transactionSymbol
String
交易数量对应的币种
methodId
String
方法
errorLog
String
交易失败日志
inputData
String
输入数据
txfee
String
手续费
index
String
交易在区块里的位置索引
confirm
String
已确认区块数
inputDetails
Array
输入地址列表
> inputHash
String
发起交易的hash地址
> isContract
Bol
发起交易的地址是否是合约地址 true:是 ；false：否
> amount
String
该地址的交易数量
outputDetails
Array
输出地址列表
> outputHash
String
接收交易的hash地址
> isContract
Bol
接收交易的地址是否是合约地址 true:是 ；false：否
> amount
String
该地址的交易数量
state
String
交易状态 success：成功 fail：失败 pending：等待确认
gasLimit
String
gas限额
gasUsed
String
gas消耗
gasPrice
String
gas价格
totalTransactionSize
String
总交易大小
virtualSize
String
虚拟交易大小
weight
String
交易重量
nonce
String
发起者地址发起的第几笔交易
isAaTransaction
Bol
是否为AA交易
tokenTransferDetails
Array
代币转账明细，最多返回20条，可通过新接口GET /api/v5/explorer/transaction/internal-transaction-detail和GET /api/v5/explorer/transaction/token-transaction-detail查询更多数据
> index
String
该交易在区块里的位置索引
> token
String
代币名称
> tokenContractAddress
String
代币合约地址
> symbol
String
代币符号
> from
String
转出代币地址
> to
String
接收代币地址
> isFromContract
Bol
转出代币地址是否是合约地址
> isToContract
Bol
接收代币地址是否是合约地址
> tokenId
String
NFT的ID
> amount
String
转账数量
contractDetails
Array
合约调用转账明细
> index
String
该交易在区块里的位置索引
> from
String
转出代币地址
> to
String
接收代币地址
> isFromContract
Bol
转出代币地址是否是合约地址
> isToContract
Bol
接收代币地址是否是合约地址
> amount
String
转账数量
> gasLimit
String
gas限额
批量查询交易明细
通过交易哈希获取交易明细信息，支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/transaction/transaction-multi
请求示例
GET /api/v5/explorer/transaction/transaction-multi?chainShortName=eth&txId=0x9a6eca1a9f4cc9b8d338bba2ad50d71be42ceb6aac50059cb8b1fac7e8a37d74
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易哈希，最多输入20笔，以','隔开
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"txId": "0x9a6eca1a9f4cc9b8d338bba2ad50d71be42ceb6aac50059cb8b1fac7e8a37d74",
"methodId": "",
"blockHash": "0x7b9f40bb135a93a9638d30aa6e4ad97deba89542a975468eede129fad9f5e8df",
"height": "18362555",
"transactionTime": "1697454719000",
"from": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
"to": "0xd87cba5b88ca8c937792a564a60afc0d0683e731",
"isFromContract": false,
"isToContract": false,
"amount": "0.030891615623385848",
"symbol": "ETH",
"nonce": "97806",
"txFee": "0.000194151615588",
"gasPrice": "9245315028",
"gasLimit": "21000",
"gasUsed": "21000",
"state": "success",
"transactionType": ""
}
]
}
返回参数
参数名
类型
描述
txId
String
交易哈希
methodId
String
方法
blockHash
String
区块哈希
height
String
交易发生的区块
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
from
String
发送方地址
to
String
接收方地址
isFromContract
Bol
From地址是否是合约地址
isToContract
Bol
To地址是否是合约地址
amount
String
交易数量
symbol
String
交易数量对应的币种
nonce
String
发起者地址发起的第几笔交易
gasLimit
String
gas限额
gasUsed
String
gas消耗
gasPrice
String
gas价格
txFee
String
手续费
state
String
交易状态： success 成功 fail 失败 pending 等待确认
transactionType
String
交易类型 0：原始交易类型 1：EIP2930 2：EIP1559
批量查询内部交易
通过交易哈希批量获取内部交易，支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/transaction/internal-transaction-multi
请求示例
GET /api/v5/explorer/transaction/internal-transaction-multi?chainShortName=eth&txId=0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易哈希，多个地址以,分隔
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b",
"blockHash": "0x469ae737291639f3137d3d4e9649c56489e5d19e272248781f8869220900f809",
"height": "18368538",
"transactionTime": "1697526923000",
"operation": "delegatecall",
"from": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"to": "0xa2327a938febf5fec13bacfb16ae10ecbc4cbdcf",
"isFromContract": true,
"isToContract": true,
"amount": "0"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
internalTransactionDetails
Array
内部交易详情
> txId
String
交易哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式
> operation
String
操作类型
> from
String
交易发送方的地址
> to
String
交易接受方的地址
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> amount
String
交易数量
批量查询代币交易
通过交易哈希批量获取代币交易，支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/transaction/token-transfer-multi
请求示例
GET /api/v5/explorer/transaction/token-transfer-multi?chainShortName=eth&txId=0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易哈希，多笔交易以,分隔
protocolType
String
否
不同类型的交易
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b",
"blockHash": "0x469ae737291639f3137d3d4e9649c56489e5d19e272248781f8869220900f809",
"height": "18368538",
"transactionTime": "1697526923000",
"from": "0xc94ebb328ac25b95db0e0aa968371885fa516215",
"to": "0x3275311fde369a68ef90bc25de9d462e1d5c8bb7",
"isFromContract": false,
"isToContract": false,
"amount": "554",
"tokenId": "",
"symbol": "USDC",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenTransferDetails
Array
代币交易详情
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式
> from
String
交易发送方的地址
> to
String
交易接受方的地址
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> tokenContractAddress
String
代币合约地址
> amount
String
交易数量
> symbol
String
交易代币的符号
> tokenId
String
NFT的ID
代币数据模块
代币数据模块功能模块接口，可以获取一条链上所有的代币列表和代表详情；此外，可以通过K线数据模块的接口查询 200+ 条公链的代币价格数据
查询代币列表信息
获取某条公链上某个代币的基本信息，支持筛选代币的发行时间，可查询最新发行的代币，代币发行时间的筛选跨度最长为1年。
支持公链：ETH, OKTC, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/token/token-list
请求示例
GET /api/v5/explorer/token/token-list?chainShortName=eth&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
protocolType
String
否
合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155 10代币：token_10 默认是token_20
tokenContractAddress
String
否
代币合约地址
startTime
String
否
查询发行时间晚于该时间的代币，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
endTime
String
否
查询发行时间早于该时间的代币，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
orderBy
String
否
按照不同指标降序返回，仅针对20代币 totalMarketCap：按代币总市值从高到低返回 transactionAmount24h ：按代币24h交易金额从高到低返回 默认按市值从高到低返回
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"tokenList": [
{
"tokenFullName": "Tether USD",
"token": "USDT",
"precision": "6",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"protocolType": "ERC20",
"addressCount": "4908191",
"totalSupply": "87625667476.7",
"circulatingSupply": "84605973812.99",
"price": "1.00026",
"website": "https://tether.to/",
"totalMarketCap": "84650814979.11",
"issueDate": "1511883490000",
"transactionAmount24h": "6781719762.427729",
"tvl": "293170014.5685352"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
tokenList
Array
代币列表
> tokenFullName
String
代币名字全称：USDCoin
> token
String
代币名字简称：USDC
> precision
String
精度
> tokenContractAddress
String
代币合约地址
> protocolType
String
代币合约协议类型
> addressCount
String
持币地址数
> totalSupply
String
最大供应量
> circulatingSupply
String
该代币在所有链上的总流通量
> price
String
价格，USD为单位
> website
String
官方网站
> totalMarketCap
String
该代币在所有链上的总市值
> issueDate
String
代币发行日期
> transactionAmount24h
String
代币24h交易金额，单位为美元，仅支持20代币
> tvl
String
代币的总锁仓市值
查询代币持仓列表详情
获取某条公链上某个代币的持仓列表，仅返回余额为top10000的地址，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/token/position-list
请求示例
GET /api/v5/explorer/token/position-list?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
代币合约地址
holderAddress
String
否
持仓地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"circulatingSupply": "977631.04",
"positionList": [
{
"holderAddress": "0x0a3f6849f78076aefadf113f5bed87720274ddc0",
"amount": "165544.6846010534",
"valueUsd": "231029494.33741083165440853217918",
"positionChange24h": "-0.000030241911044021",
"rank": "1"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
circulatingSupply
String
总流通量
positionList
Array
持仓列表
> holderAddress
String
持仓地址
> amount
String
持仓数量
> valueUsd
String
持仓价值，以美金为单位
> positionChange24h
String
24小时持仓量变化
> rank
String
持仓量排名
查询代币持仓地址统计数据
获取某条公链上某个代币的持仓地址，对于该代币在DEX上的总购买金额、购买数量、持仓成本和未实现盈亏，该接口仅统计在DEX上购买过某个代币、且当前仍然持有该代币的地址，数据每小时更新
支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, ETHW, FTM, OP, ARBITRUM, ZKSYNC, LINEA, POLYGON_ZKEVM, BASE, SCROLL, TRON
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/token/position-stats
请求示例
GET /api/v5/explorer/token/position-stats?chainShortName=eth&tokenContractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
代币合约地址
holderAddress
String
否
持仓地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "500",
"positionList": [
{
"holderAddress": "0xcee284f754e854890e311e3280b767f80797180d",
"amount": "1432683907.127544",
"totalTxnAmount": "949071.1488562819",
"totalTxnQuantity": "948975.819459",
"holdingCost": "1.000100455033023",
"unrealizedProfit": "-244208.182700946177592885512"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
positionList
Array
持仓列表
> amount
String
持仓数量
> holderAddress
String
持仓地址
> totalTxnAmount
String
地址在DEX上购买该代币的总交易金额，单位为USD
> totalTxnQuantity
String
地址在DEX上购买该代币的总数量
> holdingCost
String
地址对于该代币的持仓成本，地址购买该代币的总交易金额 / 地址购买该代币的数量；单位为USD
> unrealizedProfit
String
地址当前持有该代币的未实现盈亏，计算方法为（代币当前价格 - 持仓成本）* 持仓数量
查询代币转帐详情
获取某条公链上指定代币的转账详情，支持公链：ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/token/transaction-list
请求示例
GET /api/v5/explorer/token/transaction-list?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
代币合约地址
maxAmount
String
否
筛选交易数量区间，最大数量
minAmount
String
否
筛选交易数量区间，最小数量
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"totalTransfer": "2005176",
"transactionList": [
{
"txid": "0x784c42f0dee87a0e83ed29d69df6ab2af0a13792f2c266a4fe3f6f2b1f4c59ae",
"blockHash": "0x907077f5157ee31a5665f37f5589170fad2450857fea8d5d99a91ed02f908f1d",
"height": "18377320",
"transactionTime": "1697633099000",
"from": "0xaafb85ad4a412dd8adc49611496a7695a22f4aeb",
"to": "0x7913005b548839da13765020ddb9bf74a151b327",
"isToContract": false,
"isFromContract": true,
"amount": "0",
"transactionSymbol": "MKR",
"methodId": "0x8a179be4",
"tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"protocolType": "ERC20",
"state": "success",
"tokenId": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
totalTransfer
String
代币总转账次数
transactionList
Array
交易列表
> txid
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> to
String
接收方，多个地址，逗号分隔
> from
String
发送方，多个地址，逗号分隔
> isFromContract
Bol
input地址是否是合约地址
> isToContract
Bol
output地址是否是合约地址
> amount
String
交易数量
> transactionSymbol
String
交易数量对应的币种
> methodId
String
方法
> tokenContractAddress
String
代币合约地址
> protocolType
String
代币协议类型
> state
String
交易状态 成功：success 失败：fail等待确认：pending
> tokenId
String
NFT代币ID，适用于721和1155代币
批量查询代币交易
批量查询最多20合约的代币交易，最多查询10000个区块，支持公链：LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/token/token-transaction-list-multi
请求示例
GET /api/v5/explorer/token/token-transaction-list-multi?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2&endBlockHeight=17925814&startBlockHeight=17916100&limit=1
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
代币的合约地址，最多可以输入20个地址，以,分隔
startBlockHeight
String
是
开始搜索的区块号
endBlockHeight
String
是
结束搜索的区块号
page
String
否
页码
limit
String
否
每页返回的数据条数，默认最小20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "712",
"transactionList": [
{
"txId": "0x3512b39be2705de69c45b94d08068dd9ff8d932b8cf163650e97154136dca9b3",
"blockHash": "0x7a6dc63e2f04cc40013f4359771038fbaebe9895568c93df122eb0c1aa2f0b32",
"height": "17925812",
"transactionTime": "1692169811000",
"from": "0x2e52f794dec462be6a05c7291b5d80326f953668",
"to": "0x5bea21c54bbb549c1c5fc3e451955878ed152dac",
"isFromContract": false,
"isToContract": false,
"amount": "0.9971",
"tokenId": "",
"symbol": "MKR",
"tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
页码
limit
String
每页返回的数据条数，默认最小20条，最多100条
totalPage
String
总共的页数
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易发生的时间；Unix时间戳的毫秒数格式，如1597026383085
> from
String
交易发送方的地址，多个地址，以,分隔
> to
String
交易接受方的地址，多个地址，以,分隔
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> amount
String
代币数量
> tokenId
String
代币ID，适用于721和1155代币
> symbol
String
交易代币的符号
> tokenContractAddress
String
交易代币的合约地址
查询代币历史供应量
查询代币在指定区块高度的历史供应量；支持公链：ETH, POLYGON, POLYGON_ZKEVM
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/token/supply-history
请求示例
GET /api/v5/explorer/token/supply-history?chainShortName=polygon_zkevm&tokenContractAddress=0x1e4a5963abfd975d8c9021ce480b42188849d41d&height=946117
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
代币合约地址
height
String
是
区块高度
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"supply": "2495333.838249"
}
]
}
返回参数
参数名
类型
描述
supply
String
代币在该区块的供应量
日志数据模块
日志数据模块功能模块的接口，可根据区块和地址、地址和 topic、地址、交易不同维度查询事件日志数据。
根据区块和地址查询事件日志
根据区块高度和地址查询交易事件日志，仅返回近 1000 个结果；支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/log/by-block-and-address
请求示例
GET /api/v5/explorer/log/by-block-and-address?chainShortName=ETH&startBlockHeight=18827085&endBlockHeight=18827085&address=0xa2e3356610840701bdf5611a53974510ae27e2e1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
startBlockHeight
String
是
开始查询的区块高度
endBlockHeight
String
是
结束查询的区块高度
address
String
是
触发事件日志的智能合约的地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
返回参数
参数名
类型
描述
height
String
区块高度
address
String
触发事件日志的智能合约的地址
topics
Array
事件日志的topic
data
String
事件的非索引参数
blockHash
String
区块哈希
methodId
String
调用方法
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
logIndex
String
事件日志在区块中的位置索引
txId
String
交易哈希
根据地址和topic查询事件日志
根据地址和 topic0 查询交易事件日志，仅返回近 1000 个结果；支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/log/by-address-and-topic
请求示例
GET /api/v5/explorer/log/by-address-and-topic?chainShortName=ETH&address=0xa2e3356610840701bdf5611a53974510ae27e2e1&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
触发事件日志的智能合约的地址
topic0
String
是
事件日志的topic0
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"height": "18833017",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000028c6c06298d514db089934071355e5743bf21d60",
"0x000000000000000000000000dfd5293d8e347dfe59e90efd55b2956a1343963d"
],
"data": "0x0000000000000000000000000000000000000000000000bd2ef60c424bcf1800",
"methodId": "0xa9059cbb",
"blockHash": "0x0eb5945712b307f1c10634f05c4cb729ce9d1e8e7a7038d9344189fe809e7ba3",
"transactionTime": "1703146835000",
"logIndex": "47",
"txId": "0x3cb42772c569c05ed3b1a60d8a9a1ea8627f0f2d21705b98f4126c599b9249a2"
}
]
}
返回参数
参数名
类型
描述
height
String
区块高度
address
String
触发事件日志的智能合约的地址
topics
Array
事件日志的topic
data
String
事件的非索引参数
blockHash
String
区块哈希
methodId
String
调用方法
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
logIndex
String
事件日志在区块中的位置索引
txId
String
交易哈希
根据地址查询事件日志
根据地址查询交易事件日志，仅返回近 1000 个结果；支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/log/by-address
请求示例
GET /api/v5/explorer/log/by-address?chainShortName=ETH&address=0xa2e3356610840701bdf5611a53974510ae27e2e1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
触发事件日志的智能合约的地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
返回参数
参数名
类型
描述
height
String
区块高度
address
String
触发事件日志的智能合约的地址
topics
Array
事件日志的topic
data
String
事件的非索引参数
blockHash
String
区块哈希
methodId
String
调用方法
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
logIndex
String
事件日志在区块中的位置索引
txId
String
交易哈希
查询交易事件日志
根据交易哈希查询交易事件日志，仅返回近 1000 个结果；支持公链：ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/log/by-transaction
请求示例
GET /api/v5/explorer/log/by-transaction?chainShortName=ETH&txId=0x74e2d0404b073d043d5c9aac574fe6b354ca92c43bebfdb169e5136f4ff4393e
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易哈希
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
返回参数
参数名
类型
描述
height
String
区块高度
address
String
触发事件日志的智能合约的地址
topics
Array
事件日志的topic
data
String
事件的非索引参数
blockHash
String
区块哈希
methodId
String
调用方法
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
logIndex
String
事件日志在区块中的位置索引
txId
String
交易哈希
统计数据模块
支持查询不同公链的历史每日链上统计数据、区块统计数据、gas 统计数据
查询链上统计数据
可查询某条公链的每日新增地址数、总交易笔数、合约调用总数、交易手续费和网络利用率；支持公链：ETH, POLYGON, POLYGON_ZKEVM, BSC, AVAXC, FTM, ARBITRUM, OP, BASE, TRON, X1_TEST, BTC
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/blockchain/stats
请求示例
GET /api/v5/explorer/blockchain/stats?chainShortName=eth
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
startTime
String
否
查询晚于该日期的数据，Unix时间戳的毫秒数格式，如 1597026383085
endTime
String
否
查询早于该日期的数据，Unix时间戳的毫秒数格式，如 1597026383085
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3110",
"statsHistoryList": [
{
"time": "1706832000000",
"newAddressCount": "104106",
"totalTransactionCount": "1108185",
"totalContractCalls": "5065734",
"transactionFee": "2657.1239669484817",
"networkUtilization": "0.5048832665557917"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
每一页返回的最大条数
totalPage
String
总共多少页
statsHistoryList
Array
历史统计数据列表
> time
String
日期，以天为维度；Unix时间戳的毫秒数格式，如 1597026383085
> newAddressCount
String
每日新增地址数
> totalTransactionCount
String
每日总交易笔数
> totalContractCalls
String
每日链上所有智能合约被调用的次数总和
> transactionFee
String
每日支付给验证者的交易手续费总和，单位为本链币
> networkUtilization
String
每日网络利用率，为每日总gas消耗/每日总gas 限额
查询区块统计数据
可查询某条公链的每日出块数量、平均区块大小、出块奖励、平均出块时间；支持公链：ETH, POLYGON, POLYGON_ZKEVM, BSC, AVAXC, FTM, ARBITRUM, OP, BASE, TRON, X1_TEST, BTC
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/block/block-stats
请求示例
GET /api/v5/explorer/block/block-stats?chainShortName=eth
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
startTime
String
否
查询晚于该日期的数据，Unix时间戳的毫秒数格式，如 1597026383085
endTime
String
否
查询早于该日期的数据，Unix时间戳的毫秒数格式，如 1597026383085
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3110",
"blockHistoryList": [
{
"time": "1706832000000",
"blockCount": "7132",
"blockSize": "149949.05300056085",
"mineReward": "489.8858503788926",
"rewardSymbol": "ETH",
"avgBlockInterval": "12.114413909141895"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
每一页返回的最大条数
totalPage
String
总共多少页
blockHistoryList
Array
区块历史统计数据
> time
String
日期，以天为维度；Unix时间戳的毫秒数格式，如 1597026383085
> blockCount
String
每日总出块数量
> blockSize
String
每日平均区块大小，单位为bytes
> mineReward
String
每日总区块奖励
> rewardSymbol
String
每日总区块奖励的单位
> avgBlockInterval
String
每日平均出块时间，单位为s
查询gas统计数据
可查询某条公链的每日平均gas限额、消耗的gas总额、平均gas价格、最大gas价格、最小gas价格；支持公链：ETH, POLYGON, POLYGON_ZKEVM, BSC, AVAXC, FTM, ARBITRUM, OP, BASE, X1_TEST
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/gas/stats
请求示例
GET /api/v5/explorer/gas/stats?chainShortName=eth
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
startTime
String
否
查询晚于该日期的数据，Unix时间戳的毫秒数格式，如 1597026383085
endTime
String
否
查询早于该日期的数据，Unix时间戳的毫秒数格式，如 1597026383085
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3110",
"gasHistoryList": [
{
"time": "1706832000000",
"avgGasLimit": "29999675",
"totalGasUsed": "103886992668",
"avgGasPrice": "24498721911",
"maxGasPrice": "21010266430914",
"minGasPrice": "11688300977"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
每一页返回的最大条数
totalPage
String
总共多少页
gasHistoryList
Array
gas历史统计数据
> time
String
日期，以天为维度；Unix时间戳的毫秒数格式，如 1597026383085
> avgGasLimit
String
每日平均gas限额，为当日所有区块的gas limit平均值
> totalGasUsed
String
每日gas消耗总量
> avgGasPrice
String
每日平均gas价格，单位为wei
> maxGasPrice
String
每日最大gas价格，单位为wei
> minGasPrice
String
每日最小gas价格，单位为wei
UTXO数据模块
UTXO功能模块接口，支持查询UTXO链数据和BRC20数据，UTXO链包括BTC、BCH、LTC、DASH、DOGE。
查询地址UTXO交易
获取某个地址每笔交易的UTXO，支持UTXO模型的链，包括BTC, BCH, LTC, DASH, DOGE
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/unspent
请求示例
GET /api/v5/explorer/address/unspent?chainShortName=btc&address=bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"txId": "26270302d90b41ee6a7ac4521d520eb27ee7471cc946a229a07f2dd2c1a610dc",
"height": "812718",
"amount": "0.00011918",
"address": "bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2",
"confirm": "",
"index": "1831",
"transactionIndex": "",
"balance": "118300.20301158",
"symbol": "BTC",
"unspent": ""
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
txid
String
交易哈希
height
String
交易发生的区块
amount
String
UTXO里面的交易金额
address
String
地址
unspent
String
该笔交易未花费的交易输出（找零）
confirm
String
确认数
index
String
该笔交易在区块里的位置索引
transactionIndex
String
该笔UTXO在交易里的位置索引
balance
String
该地址余额
symbol
String
币种
查询地址剩余UTXO
获取地址剩余的每笔UTXO明细，支持UTXO模型的链，包括BTC, BCH, LTC, DASH, DOGE
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/utxo
请求示例
GET /api/v5/explorer/address/utxo?chainShortName=btc&address=bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的50条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "172",
"utxoList": [
{
"txid": "d11638ea2cf68c4b49c1d97ef681a9e7e4658ba6cb7290dd73d476db371b9037",
"height": "796599",
"blockTime": "1688150365",
"address": "bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2",
"unspentAmount": "0.0003",
"index": "0"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
utxoList
Array
剩余的UTXO列表
> txid
String
交易哈希
> height
String
交易发生的区块
> blockTime
String
出块时间，Unix时间戳的毫秒数格式
> address
String
地址
> unspentAmount
String
该笔交易未花费的交易输出（找零）
> index
String
该笔交易交易在区块里的位置索引
BRC20数据模块
BRC20数据模块支持BRC20代币余额查询，转账列表查询、代币详情信息、持币地址列表等查询服务，数据实时更新，为用户提供最全面，最实时的BRC20链上数据查询服务。
查询inscriptions列表
获取BTC链的 inscriptions 列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/inscriptions-list
请求示例
GET /api/v5/explorer/btc/inscriptions-list
请求参数
参数名
类型
是否必须
描述
token
String
否
代币名称，等于 tick
inscriptionId
String
否
inscription ID
inscriptionNumber
String
否
铭文编号
state
String
否
铭文状态：success、fail，默认返回success
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"totalInscription": "31126135",
"inscriptionsList": [
{
"inscriptionId": "92780ef845a5190a1027724c24b5adbe6713abdaa43c5f273ff8a87d41f6cc8ci0",
"inscriptionNumber": "9999999",
"location": "92780ef845a5190a1027724c24b5adbe6713abdaa43c5f273ff8a87d41f6cc8c:0:0",
"token": "10MM",
"state": "success",
"msg": "",
"tokenType": "BRC20",
"actionType": "mint",
"logoUrl": "",
"ownerAddress": "bc1p53rrfs7l3fdyd60wzsk9gphnjm6y9hr4vhfrp207tsltyxjatfqqj9ly8k",
"txId": "92780ef845a5190a1027724c24b5adbe6713abdaa43c5f273ff8a87d41f6cc8c",
"blockHeight": "792013",
"contentSize": "",
"time": "1685401405000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
totalInscription
String
inscription 总量
inscriptionsList
Array
inscription 列表
> inscriptionId
String
铭文的ID
> inscriptionNumber
String
铭文编号
> location
String
Location，格式为：txid:vout:offset
> token
String
代币名称，tick
> state
String
铭文状态：success、fail
> msg
String
交易提示，失败的时候为错误原因，其他为提示信息
> tokenType
String
铭文的类型，BRC20
> actionType
String
交易类型：deploy、mint、inscribeTransfer、transfer
> logoUrl
String
铭文的logo URL
> ownerAddress
String
铭文的所有者地址
> txId
String
与铭文相关的最新交易hash
> blockHeight
String
与铭文相关的最新交易区块高度
> contentSize
String
储存信息所占的大小，单位：Bytes
> time
String
铭文创建时间
查询BRC20代币列表
获取BTC链的BRC20代币列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/token-list
请求示例
GET /api/v5/explorer/btc/token-list
请求参数
参数名
类型
是否必须
描述
token
String
否
代币名称，等于 tick
orderBy
String
否
deployTimeAsc：按部署时间从远到近返回 deployTimeDesc：按部署时间从近到远返回默认为deployTimeAsc
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"tokenList": [
{
"token": "ordi",
"deployTime": "1678248991000",
"inscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"inscriptionNumber": "348020",
"totalSupply": "21000000",
"mintAmount": "21000000",
"transactionCount": "484169",
"holder": "13080",
"mintRate": "1"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> token
String
代币名称，等于tick
> deployTime
String
部署时间
> inscriptionId
String
铭文的ID
> inscriptionNumber
String
铭文编号
> totalSupply
String
总供应量
> mintAmount
String
已经铸造数量
> transactionCount
String
总交易次数
> holder
String
持有代币地址数
> mintRate
String
mint 比例，以小数展示，例如：0.9543 ；保留小数点后四位
获取代币详细信息
获取代币详细信息，包括持有人地址数、已铸造数量等。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/token-details
请求示例
GET /api/v5/explorer/btc/token-details?token=sats
请求参数
参数名
类型
是否必须
描述
token
String
是
代币名称，等于tick
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"token": "sats",
"precision": "18",
"totalSupply": "2100000000000000",
"mintAmount": "2100000000000000",
"limitPerMint": "100000000",
"holder": "35825",
"deployAddress": "bc1prtawdt82wfgrujx6d0heu0smxt4yykq440t447wan88csf3mc7csm3ulcn",
"logoUrl": "https://static.oklink.com/cdn/web3/currency/token/btc-sats-9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0.png/type=png_350_0",
"txId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333",
"inscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
"deployHeight": "779971",
"deployTime": "1678339934000",
"inscriptionNumber": "357097",
"state": "success",
"tokenType": "BRC20",
"msg": ""
}
]
}
返回参数
参数名
类型
描述
token
String
代币名称，等于tick
precision
String
数量的精度位
totalSupply
String
总铸造数量
mintAmount
String
已经铸造数量
limitPerMint
String
每次最大铸造数量
holder
String
持有代币地址数
deployAddress
String
铸造者地址
logoUrl
String
代币的logo
txId
String
铸造的交易哈希
inscriptionId
String
铭文的ID
deployHeight
String
部署区块高度
deployTime
String
部署时间
inscriptionNumber
String
铭文编号
state
String
铭文状态：success、fail
tokenType
String
铭文的类型，BRC20
msg
String
原因
代币持仓地址列表
获取代币持仓地址列表，查看代币分布详情。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/position-list
请求示例
GET /api/v5/explorer/btc/position-list?token=sats&limit=2
请求参数
参数名
类型
是否必须
描述
token
String
是
代币名称，tick
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "5000",
"positionList": [
{
"holderAddress": "bc1plff0sqm6ym55eak9vjljghd55h7hkheg22c84w55w646l857elqsfzmfdv",
"amount": "31740686608926",
"rank": "1"
},
{
"holderAddress": "bc1pun3whtlzac75f2vcznxmpfc09dnzyp0luw8tpfwc7wrruwav30pqsu6l9u",
"amount": "22651199774504",
"rank": "2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
positionList
Array
代币持仓的地址列表
> holderAddress
String
持仓地址
> amount
String
持仓数量
> rank
String
持仓量排名
查询代币转账列表
根据地址、交易hash、区块高度 查询转账列表。不提供pending交易的数据 。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/transaction-list
请求示例
GET /api/v5/explorer/btc/transaction-list
请求参数
参数名
类型
是否必须
描述
address
String
否
BTC 的地址
token
String
否
代币名称，等于tick
inscriptionNumber
String
否
铭文编号
actionType
String
否
交易类型：deploy、mint、inscribeTransfer、transfer
toAddress
String
否
接收方地址
fromAddress
String
否
发送方地址
txId
String
否
交易Hash
blockHeight
String
否
区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"totalTransaction": "31124061",
"inscriptionsList": [
{
"txId": "af6bb18c64c57296ae07b8f4b1857c655160402a8d332fdb523915d7887476e2",
"blockHeight": "812873",
"state": "fail",
"tokenType": "BRC20",
"actionType": "mint",
"fromAddress": "",
"toAddress": "bc1qx2l6pzt7aknazsgdnvf5vnhp8ezx38ykg2wvfz",
"amount": "",
"token": "$ORC",
"inscriptionId": "af6bb18c64c57296ae07b8f4b1857c655160402a8d332fdb523915d7887476e2i0",
"inscriptionNumber": "35346117",
"index": "0",
"location": "af6bb18c64c57296ae07b8f4b1857c655160402a8d332fdb523915d7887476e2:0:0",
"msg": "tick: $ORC has been minted",
"time": "1697695573000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
totalTransaction
String
总转账次数
transactionList
Array
交易列表
> txid
String
交易哈希
> blockHeight
String
区块高度
> state
String
铭文状态：success、fail
> tokenType
String
铭文的类型，BRC20
> actionType
String
交易类型：deploy、mint、inscribeTransfer、transfer
> fromAddress
String
发送方地址
> toAddress
String
接收方地址
> amount
String
转账数量
> index
String
vout的index；类型为coinbase时，该字段没有数值
> location
String
location，格式为txid:vout:offset ；类型为coinbase时，该字段没有数值
> token
String
代币名称，等于tick
> inscriptionId
String
铭文的ID
> inscriptionNumber
String
铭文编号
> msg
String
交易提示，失败的时候为错误原因，其他为提示信息
> time
String
交易时间
查询地址代币余额列表
查询指定地址持有的BRC20代币余额、可转余额、可用余额。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/address-balance-list
请求示例
GET /api/v5/explorer/btc/address-balance-list?address=bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2
请求参数
参数名
类型
是否必须
描述
address
String
是
BTC链地址
token
String
否
代币名称，等于 tick
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "12",
"balanceList": [
{
"token": "sats",
"tokenType": "BRC20",
"balance": "1350000000000",
"availableBalance": "1350000000000",
"transferBalance": "0"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
balanceList
Array
地址持有的代币余额列表
> token
String
代币名称，等于tick
> tokenType
String
铭文的类型。BRC20
> balance
String
余额
> availableBalance
String
可用余额；可用余额 = 钱包中的总额 - 可转让余额
> transferBalance
String
可转让余额
查询地址代币余额明细
查询某地址的某个代币可转余额明细列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/btc/address-balance-details
请求示例
GET /api/v5/explorer/btc/address-balance-details?address=bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2&token=meme
请求参数
参数名
类型
是否必须
描述
address
String
是
BTC链地址
token
String
是
代币名称，等于 tick
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "6",
"token": "meme",
"tokenType": "BRC20",
"balance": "18",
"availableBalance": "0",
"transferBalance": "18",
"transferBalanceList": [
{
"inscriptionId": "a1002519472f9a1d45db5a3df30ea521ecd5425e546a63a79f3a4a9ff4e6e582i0",
"inscriptionNumber": "4615101",
"amount": "3"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
token
String
代币名称，等于tick
tokenType
String
铭文的类型，BRC20
balance
String
余额
availableBalance
String
可用余额；可用余额 = 钱包中的总额 - 可转让余额
transferBalance
String
可转让余额
transferBalanceList
Array
可转让余额列表
> inscriptionId
String
inscription Id
> inscriptionNumber
String
inscription 编号
> amount
String
数量
EVM数据模块
EVM功能模块接口，可获取ETH通缩数据、信标链数据、StarkNet数据等。
ETH通缩数据模块
ETH通缩数据模块功能模块接口，提供ETH每日对供应与销毁的详情数据，以及ETH质押详情。
获取ETH通缩概览
查询ETH最新的通缩数据概览
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/deflation/supply
请求示例
GET /api/v5/explorer/deflation/supply
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"circulatingSupply": "120404650.2518",
"totalBurnt": "3640484.712",
"inflationRate": "0.004",
"stakingAmount": "30739208",
"stakingApy": "0.027"
}
]
}
返回参数
参数名
类型
描述
circulatingSupply
String
ETH总流通量
totalBurnt
String
ETH总销毁量
stakingApy
String
ETH质押年化收益率
stakingAmount
String
ETH总质押数量
inflationRate
String
ETH当前年化通胀率，以小数展示，示例：0.1=10%
获取ETH通缩详情
通过该接口ETH每日的供应量和销毁量的历史数据。
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/deflation/supply-burn
请求示例
GET /api/v5/explorer/deflation/supply-burn
请求参数
参数名
类型
是否必须
描述
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "2246",
"inflationHistoryList": [
{
"supply": "2328.5755",
"burnt": "992.0577",
"netInflation": "1336.5177",
"circulatingSupply": "120404650.2518",
"inflationRate": "0.004",
"time": "1697558400000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
inflationHistoryList
Array
通缩数据列表
> circulatingSupply
String
ETH总流通量
> burnt
String
每日销毁量
> netInflation
String
每日净新增ETH数量，正数表示表示新增数量，负数表示减少数量
> supply
String
每日供应量
> inflationRate
String
ETH当前年化通胀率，以小数展示，示例：0.1=10%
> time
String
数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085
获取ETH质押详情
获取ETH质押历史详情
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/deflation/pos-staking
请求示例
GET /api/v5/explorer/deflation/pos-staking
请求参数
参数名
类型
是否必须
描述
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "1052",
"stakingHistoryList": [
{
"time": "1697558400000",
"totalValidator": "979417",
"totalStaked": "30739208",
"stakingRatio": "0.2588",
"validatorDailyIncome": "2328.5755",
"apy": "0.027",
"nonEip1559Fee": "58.5716",
"baseRewards": "992.0577",
"priorityFee": "294.1105"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
stakingHistoryList
Array
质押列表
> apy
String
年化收益率
> baseRewards
String
基础奖励
> priorityFee
String
交易小费
> totalStaked
String
总质押量
> stakingRatio
String
质押率
> nonEip1559Fee
String
非eip1559交易手续费
> totalValidator
String
总验证者数量
> validatorDailyIncome
String
验证者每日收入（基础奖励）
> time
String
数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085
获取ETH的gas历史
通过该接口获取ETH的历史gas数据
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/deflation/gas
请求示例
GET /api/v5/explorer/deflation/gas
请求参数
参数名
类型
是否必须
描述
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "805",
"gasHistoryList": [
{
"nonEip1559Fee": "58.5716",
"eip1559BaseFee": "992.0577",
"eip1559Tip": "294.1105",
"totalTransactionCount": "994388",
"maxGasPrice": "101",
"minGasPrice": "4.7883",
"avgGasPrice": "9.9651",
"time": "1697558400000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
gasHistoryList
Array
gas 历史数据
> avgGasPrice
String
当天平均gas费
> maxGasPrice
String
当天最大值gas费
> minGasPrice
String
当天最小值gas费
> eip1559BaseFee
String
eip1559基础手续费
> eip1559Tip
String
eip1559小费
> totalTransactionCount
String
当天总交易次数
> nonEip1559Fee
String
非eip1559交易手续费
> time
String
数据更新时间，Unix时间戳的毫秒数格式，如 1597026383085
Beacon数据模块
Beacon数据模块支持查询信标链的提现和质押相关的数据
查询信标链基础信息
获取信标链的基础信息，包括验证者概览和质押概览数据
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-summary
请求示例
GET /api/v5/explorer/beacon/beacon-summary
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Beacon Chain",
"chainShortName": "BEACON",
"issueDate": "1606824023000",
"consensus": "PoS",
"finalizedEpoch": "236649",
"finalizedSlot": "7572768",
"lastCheckpoint": "7572833",
"validators": {
"totalValidators": "980088",
"newTotalValidators": "1808",
"activeValidators": "862463",
"newActiveValidators": "-1473",
"pendingValidators": "696",
"newPendingValidators": "620",
"exitedValidators": "3749",
"newExitedValidators": "1234",
"totalValidatorIncome": "1498841.462357212"
},
"staking": {
"totalDeposits": "31414348",
"newTotalDeposits": "37458",
"beaconDepositsReceived": "31433146",
"newBeaconDepositsReceived": "57143",
"depositAddresses": "981304",
"newDepositAddresses": "1157",
"beaconDepositsPubKeys": "980093",
"newBeaconDepositsPubKeys": "1808",
"votedStakes": "27538741",
"effectiveStakes": "27598587"
}
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Beacon Chain
chainShortName
String
公链缩写符号，例如：BEACON
issueDate
String
发行日期
consensus
String
共识算法，例如：Pos
finalizedEpoch
String
最终Epoch
finalizedSlot
String
最终Slot
lastCheckpoint
String
最新检查点Slot
validators
Array
验证者概览
> totalValidators
String
验证者总数量
> newTotalValidators
String
新增验证者数量，正数为新增，负数为减少
> activeValidators
String
活跃验证者数量
> newActiveValidators
String
新增活跃验证者数量，正数为新增，负数为减少
> pendingValidators
String
待审核验证者数量
> newPendingValidators
String
新增待审核验证者数量，正数为新增，负数为减少
> exitedValidators
String
已退出验证者数量
> newExitedValidators
String
新增已退出验证者数量，正数为新增，负数为减少
> totalValidatorIncome
String
验证者累计收入
staking
Array
质押概览
> totalDeposits
String
ETH1.0链质押ETH的数量
> newTotalDeposits
String
新增ETH1.0链质押ETH的数量，正数为新增，负数为减少
> beaconDepositsReceived
String
信标链接收总质押数量
> newBeaconDepositsReceived
String
新增信标链接收总质押数量，正数为新增，负数为减少
> depositAddresses
String
ETH1.0链质押ETH的地址数量
> newDepositAddresses
String
新增ETH1.0链质押ETH的地址数量，正数为新增，负数为减少
> beaconDepositsPubKeys
String
信标链质押公钥的数量
> newBeaconDepositsPubKeys
String
新增信标链质押公钥的数量，正数为新增，负数为减少
> votedStakes
String
活跃质押量，信标链上参与投票或出块的有效 ETH 质押量，每小时更新
> effectiveStakes
String
有效质押量，信标链节点可见的并被接受的 ETH 存款，每小时更新
查询信标链的出块列表
获取信标链的验证者详情
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-slot-list
请求示例
GET /api/v5/explorer/beacon/beacon-slot-list
请求参数
参数名
类型
是否必须
描述
slot
String
否
slot，如果都不填写，默认slot排序，最新在最上面
epoch
String
否
epoch
index
String
否
验证者编号
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"slotList": [
{
"epoch": "236651",
"slot": "7572839",
"state": "proposed",
"index": "960171",
"time": "1697698091000",
"slotIndex": "8",
"attestationCount": "128",
"parentRoot": "0xab67fff2294a6a76e1dda77d0cc65dd183bd3574ff58ea4ffede84e4fc81fabd",
"root": "0xf8a24b30de4f066fcca8a423c619cff5c3217501cbc8e82f68a5934674bcbed4",
"signature": "0x8e103c3f3c8c9453d7c1aa89eed7b20808f78097ac4607db0877fee91db39126ff10e07d4dacfa34fb5adc9764fa3027064d1377ada3055074b2f1dc26c5bb4fc40e63bd080bf5ae39278908fd9ece292339108dd619ecc2fbf440c1939983c2",
"randaoReveal": "0x904c3f03c7ca03750168d362f57f7ea58d32ee57d7d8a53a035dddd37cb3790c94d3a5f332823f069116386750b788d3133e6aedc92354db0d865b1b6d42bb9f4068407cbee4a0a6276c379ba5e561b720a5edd67b01fd7ef5e7f1b63371d041",
"graffiti": "0x0000000000000000000000000000000000000000000000000000000000000000",
"voluntaryExitsCount": "0",
"attesterSlashingCount": "0",
"l1BlockHash": "0xe06cf95360ff87f350b2681a93d7220239a218da2edff3dca4732d72cd856446",
"l1DepositCount": "1011590",
"l1DepositRoot": "0xcc10e96d2ef785919c78bd249ff0af6d93c83919595f63b57ac101c9352ea905",
"pubkey": "0x80b3fae29e4ea97d81f97578453f44b2a30b54eb1c8e176c3c0b933a797510f123a70457301cb967f070e2ef173d51d3"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
slotList
Array
slot列表
> epoch
String
slot所属的epoch
> slot
String
slot
> state
String
状态；proposed 、skipped 、forked
> index
String
对应的验证者编号
> pubkey
String
对应的验证者公钥
> time
String
该Slot的开始时间
> slotIndex
String
当前Slot在Epoch中的位置；slotIndex/32
> attestations
String
由指定的验证者委员会对Slot提供验证证明
> parentRoot
String
前一个slot的root
> root
String
root hash
> signature
String
签名
> randaoReveal
String
随机数
> graffiti
String
签名
> voluntaryExitsCount
String
退出验证者数量
> attestationCount
String
验证数量
> attesterSlashingCount
String
验证者被罚没的数量
> l1BlockHash
String
该笔提案ETH链区块高度hash
> l1DepositCount
String
质押ETH数量
> l1DepositRoot
String
ETH质押的root
查询信标链验证者列表
获取信标链的验证者列表，活跃的验证者和待审核的验证者和已经退出的验证者，每小时更新
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-validator-list
请求示例
GET /api/v5/explorer/beacon/beacon-validator-list
请求参数
参数名
类型
是否必须
描述
type
String
否
验证者类型活跃的验证者：active 待审核的验证者：pending 已退出的验证者：exited 所有的验证者：all 如果不填写，默认为all
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"validatorList": [
{
"index": "21958",
"pubkey": "0x91104f28e17de8c6bec26c5a8e64a149ba3ed2a35273197c33ed2f2bc74b8dbda96f9098517a6e946247c169c89deb34",
"holdingAmount": "68.7918",
"state": "online",
"totalIncome": "4.7918",
"proposals": "27",
"activationEpoch": "268",
"exitEpoch": "",
"withdrawalAmountEpoch": "",
"isSlashed": false
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
validatorList
Array
验证者列表
> index
String
验证着编号
> pubkey
String
验证者公钥
> state
String
验证者状态online：近2个Epoch是否有投票或者出块的行为offline：近2个Epoch没有投票或者出块的行为
> holdingAmount
String
验证者余额，单位是ETH
> totalIncome
String
验证者总收入
> proposals
String
出块个数
> activationEpoch
String
激活验证者身份的Epoch；创世块返回“0”，未激活返回""
> exitEpoch
String
退出验证者身份的Epoch
> withdrawalAmountEpoch
String
提取余额的Epoch
> isSlashed
Bol
是否被罚没收；是：true；否：false
查询信标链验证者详情
获取信标链的验证者详情
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-validator-details
请求示例
GET /api/v5/explorer/beacon/beacon-validator-details?index=21958
请求参数
参数名
类型
是否必须
描述
index
String
二选一
验证者编号
pubkey
String
二选一
验证者公钥
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"index": "21958",
"pubkey": "0x91104f28e17de8c6bec26c5a8e64a149ba3ed2a35273197c33ed2f2bc74b8dbda96f9098517a6e946247c169c89deb34",
"type": "active",
"beaconDepositsReceived": "64",
"holdingAmount": "68.79185725",
"totalIncome": "4.79185725",
"effectiveStakes": "32",
"address": "0x6282085170b2f3396fdccc2b5164fa70ee7c5192",
"deposits": "64",
"activationEpoch": "268",
"exitEpoch": "",
"eligibleEpoch": "41"
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
validatorList
Array
验证者列表
> index
String
验证者编号
> pubkey
String
验证者公钥
> type
String
验证者类型活跃的验证者：active 待审核的验证者：pending 已退出的验证者：exited 所有的验证者：all
> beaconDepositsReceived
String
信标链接收质押量
> holdingAmount
String
验证者余额，单位是ETH
> totalIncome
String
验证者总收入
> effectiveStakes
String
有效质押量，信标链节点可见的并被接受的 ETH 存款，每小时更新
> address
String
验证者地址
> deposits
String
发起质押量
> activationEpoch
String
激活验证者身份的Epoch；创世块返回“0”，未激活返回""
> exitEpoch
String
退出验证者身份的Epoch
> eligibleEpoch
String
准入验证者身份的Epoch
查询信标链的质押记录列表
获取信标链的质押记录数据
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-deposit-list
请求示例
GET /api/v5/explorer/beacon/beacon-deposit-list?index=21958&limit=1
请求参数
参数名
类型
是否必须
描述
index
String
否
对应的验证者编号
pubkey
String
否
对应的验证者公钥
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "2",
"depositList": [
{
"epoch": "40",
"slot": "1293",
"state": "active",
"index": "21958",
"pubkey": "0x91104f28e17de8c6bec26c5a8e64a149ba3ed2a35273197c33ed2f2bc74b8dbda96f9098517a6e946247c169c89deb34",
"time": "1606839539000",
"beaconDepositsReceived": "32",
"withdrawalCredential": "0x00f2c769bafa58cd7e973c597e69d73f9cc6624296f5ff6bb3aa359cb3db5a04"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
depositList
Array
质押记录列表
> epoch
String
slot所属的epoch
> slot
String
Slot
> state
String
验证者状态 deposited：质押中，用户在ETH1.0的staking合约中质押32以上ETHpending：待确认，Beacon收到deposit后，根据总deposit数量用户需在队列中等待通过审核，每个epoch通过6个验证人active：该用户已激活，并可作为validator在Beacon网络中验证Slotexited：已退出 该用户由于曾违规或主动退出(exit)，无法在Beacon网络中继续验证Slot
> index
String
对应的验证者编号
> pubkey
String
对应的验证者公钥
> time
String
质押时间
> beaconDepositsReceived
String
信标链接收质押量
> withdrawalCredential
String
提款凭证
查询信标链的赎回记录列表
获取信标链的赎回记录数据
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-withdrawal-list
请求示例
GET /api/v5/explorer/beacon/beacon-withdrawal-list?index=535309&limit=1
请求参数
参数名
类型
是否必须
描述
index
String
否
对应的验证者编号
pubkey
String
否
对应的验证者公钥
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "35",
"withdrawalList": [
{
"epoch": "236653",
"slot": "7572896",
"state": "active",
"index": "535309",
"pubkey": "0xb54d8183c989e51259ba93695a0b4584fec1b839b8ffbbc9e1925c8aa68221fbbe036657a2b409d03b2f4df85bb1afa9",
"time": "1697698775000",
"beaconWithdrawalReceived": "0.01681278",
"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
"withdrawalCredential": "0x010000000000000000000000b9d7934878b5fb9610b3fe8a5e441e8fad7e293f"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
withdrawalList
Array
赎回记录列表
> epoch
String
slot所属的epoch
> slot
String
Slot
> state
String
验证者状态 deposited：质押中，用户在ETH1.0的staking合约中质押32以上ETHpending：待确认，Beacon收到deposit后，根据总deposit数量用户需在队列中等待通过审核，每个epoch通过6个验证人active：该用户已激活，并可作为validator在Beacon网络中验证Slotexited：已退出 该用户由于曾违规或主动退出(exit)，无法在Beacon网络中继续验证Slot
> index
String
对应的验证者编号
> pubkey
String
对应的验证者公钥
> time
String
赎回时间
> beaconWithdrawalReceived
String
赎回ETH数量
> address
String
验证者地址
> withdrawalCredential
String
提款凭证
查询提款凭证对应验证者详情
根据提款凭证获取信标链的验证者基本信息。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/beacon/beacon-withdrawal-credentials
请求示例
GET /api/v5/explorer/beacon/beacon-withdrawal-credentials?withdrawalCredential=0x0100000000000000000000004f13d70f72292e699fbb420003caff2778c18f70
请求参数
参数名
类型
是否必须
描述
withdrawalCredentials
String
是
提款凭证
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "2324",
"validatorList": [
{
"index": "19782",
"pubkey": "0x8313ce1237ff07c6afed630608e339034e76a9a396ab146401ed34abb957a30079d5f2b4d126e8a8e3f1c5c415361ec3",
"activationEpoch": "0",
"balance": "32.00239377",
"effectiveBalance": "32.00239377",
"voteEpoch": "237771",
"exitEpoch": "",
"slashed": "false",
"proposal": "38",
"status": "active_ongoing",
"withdrawalCredential": "0x010000000000000000000000347a70cb4ff0297102dc549b044c41bd61e22718"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
validatorList
Array
验证者列表
> index
String
验证者编号
> pubkey
String
验证者公钥
> withdrawalCredential
String
提款凭证
> activationEpoch
String
成为活跃验证的epoch
> balance
String
余额
> effectiveBalance
String
有效余额
> voteEpoch
String
最新投票的epoch
> exitEpoch
String
退出验证者身份的Epoch
> slashed
Bol
是否被罚没
> status
String
状态
StarkNet数据模块
StarkNet功能模块接口，可获取StarkNet链的交易数据、代币数据等。
查询StarkNet区块头明细
获取StarkNet链的区块明细
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/detail-starknet
请求示例
GET /api/v5/explorer/block/detail-starknet?chainShortName=starknet&height=305653
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
是
区块高度
返回结果
{
"code": "0",
"msg": "",
"data": {
"blockHash": "0x0077befc73fba1983eeb0cc421266af52c63cdaece8a49c2e5c91cb4942ec16f",
"height": "305653",
"status": "ACCEPTED_ON_L1",
"parentBlockHash": "0x0714623a72e27a1631ec9acac8f46e31409327913388c9a46b6fb88e95f040c1",
"blockTime": "1696831933",
"stateRoot": "0x372db6f7b7bd72396215035b7ff7f6eb7589a4f9cb249b5ae4fedd0ab1fbf5e",
"sequencerAddress": "0x01176a1bd84444c89232ec27754698e5d2e7e1a7f1539f12027f28b23ec9f3d8",
"l1TransactionHash": "0x98c5cf7d0c457ecc238a9e75a688e715c11be3bdbf0b0d89bc216d7a5e91aae3",
"transactionAmount": "156",
"messageAmount": "3",
"eventAmount": "792"
}
}
返回参数
参数名
类型
描述
blockHash
String
区块哈希
height
String
区块高度
status
String
状态
blockTime
String
出块时间；Unix时间戳的毫秒数格式，如 1597026383085
parentBlockHash
String
父区块哈希
transactionAmount
String
该区块包含的交易个数
messageAmount
String
该区块包含的消息个数
eventAmount
String
该区块包含的事件个数
stateRoot
String
状态根哈希
sequencerAddress
String
定序器地址
l1TransactionHash
String
L1交易哈希
查询StarkNet区块交易列表
获取StarkNet链下的某一区块里的交易列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/block/transaction-list-starknet
请求示例
GET /api/v5/explorer/block/transaction-list-starknet?chainShortName=starknet&height=305653&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
是
区块高度
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "156",
"transactionList": [
{
"txId": "0x04e055fb82640d74576b107135e69535aa26ca17f1d1071c77281b5121bee531",
"blockHash": "0x0077befc73fba1983eeb0cc421266af52c63cdaece8a49c2e5c91cb4942ec16f",
"height": "305653",
"transactionTime": "1696831933",
"transactionType": "INVOKE",
"transactionStatus": "ACCEPTED_ON_L1",
"address": "0x05dd2e71e9f4627b79e115e2c2267c1d528735faf870fe5e8e3a584577b40707"
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块
> address
String
交易涉及到的地址
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> transactionType
String
交易类型
> transactionStatus
String
交易状态
查询StarkNet链地址代币余额明细
获取StarkNet链某个地址代币余额明细，可以获取该地址上的所有代币余额信息。(目前仅支持获取20代币)
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/token-balance-starknet
请求示例
GET /api/v5/explorer/address/token-balance-starknet?address=0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0&chainShortName=starknet&protocolType=token_20
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
合约协议类型 20代币：token_20
tokenContractAddress
String
否
代币合约地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "20",
"totalPage": "1",
"tokenList": [
{
"symbol": "ETH",
"holdingAmount": "0.09338760014159263",
"tokenContractAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7"
},
{
"symbol": "zETH",
"holdingAmount": "0.01200306543397489",
"tokenContractAddress": "0x01b5bd713e72fdc5d63ffd83762f81297f6175a5e0a4771cdadbc1dd5fe72cb1"
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> symbol
String
该地址对应的代币
> tokenContractAddress
String
该地址对应的代币合约地址
> holdingAmount
String
代币持仓数量
查询StarkNet地址普通交易列表信息
获取StarkNet链地址相关的普通交易列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/normal-transaction-list-starknet
请求示例
GET /api/v5/explorer/address/normal-transaction-list-starknet?limit=1&address=0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0&chainShortName=starknet
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
startBlockHeight
String
否
开始区块高度
endBlockHeight
String
否
最终区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "23",
"transactionList": [
{
"txId": "0x008f40e4973d54ce0be584a851bd8dc9855c9b17277ea2cd3345ae73590af1ba",
"blockHash": "0x0394c76b5148ef928302baadf1ad981126a8c7861ba6cc0d7a245aa0041a9d24",
"height": "305222",
"transactionTime": "1696820202",
"transactionType": "INVOKE",
"transactionStatus": "ACCEPTED_ON_L2"
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> transactionType
String
交易类型
> transactionStatus
String
交易状态
查询StarkNet地址代币交易列表信息
获取StarkNet链地址相关的代币交易交易列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/token-transaction-list-starknet
请求示例
GET /api/v5/explorer/address/token-transaction-list-starknet?limit=1&address=0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0&chainShortName=starknet&protocolType=token_20
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
tokenContractAddress
String
否
代币合约地址
startBlockHeight
String
否
开始区块高度
endBlockHeight
String
否
最终区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "66",
"transactionList": [
{
"txId": "0x008f40e4973d54ce0be584a851bd8dc9855c9b17277ea2cd3345ae73590af1ba",
"blockHash": "0x0394c76b5148ef928302baadf1ad981126a8c7861ba6cc0d7a245aa0041a9d24",
"height": "305222",
"transactionTime": "1696820202",
"from": "0x04270219d365d6b017231b52e92b3fb5d7c8378b05e9abc97724537a80e93b0f",
"to": "0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0",
"amount": "0.03156615266324224",
"symbol": "ETH"
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址
> to
String
接收方地址
> amount
String
交易数量，对于UTXO系列的区块链，返回的是这个地址下这笔交易所导致的余额变动。
> symbol
String
交易数量对应的币种
Cosmos数据模块
Cosmos功能模块接口，可获取 Cosmos 链、Kava 链、Evmos 链的公链信息、区块信息、地址信息、交易信息、代币信息等。
查询公链信息
获取 Cosmos 系公链的基本信息，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/blockchain
请求示例
GET /api/v5/explorer/cosmos/blockchain?chainShortName=COSMOS
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"symbol": "ATOM",
"chainCosmosId": "cosmoshub-4",
"consensus": "POS",
"marketCap": "2964931888.81",
"tps": "0.88",
"lastBlockTime": "1703587500000",
"lastBlockHeight": "18446784",
"totalTransactionCount": "47637956",
"totalTransactionValue": "5134936965.921793",
"transactionValue24h": "124615822260.29991",
"totalAddresses": "2070187",
"activeValidators": "180",
"totalSupply": "380237029.903674",
"totalStaked": "242415216.719547",
"totalAsset": "13108",
"ibcTokens": "954"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：COSMOS HUB
chainShortName
String
公链缩写符号，例如：COSMOS
symbol
String
公链原生代币，例如：ATOM
chainCosmosId
String
Cosmos 生态中该区块链网络的 ID
consensus
String
共识算法，例如：PoS
marketCap
String
公链市值
tps
String
否
lastBlockTime
String
最新区块时间；Unix时间戳的毫秒数格式，如 1597026383085
lastBlockHeight
String
最新区块高度
totalTransactionCount
String
链上交易总数
totalTransactionValue
String
链上总交易量，单位为该链原生代币
transactionValue24h
String
24 小时的链上交易量，单位为该链原生代币
totalAddresses
String
该链所有的地址数
activeValidators
String
该链的活跃验证者数
totalSupply
String
公链原生代币总供应量
totalStaked
String
公链原生代币总质押数
totalAsset
String
该链的资产总数，包含原生代币在内的全部币种数量
ibcTokens
String
IBC跨链至该链的资产币种数量
查询区块头明细
获取 Cosmos 系公链的区块头明细，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/block-fills
请求示例
GET /api/v5/explorer/cosmos/block-fills?chainShortName=COSMOS&height=17872234
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
height
String
是
区块高度
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"hash": "81788E1AD853DB23EF1650A8EC270D6FEFE87B47116B75870214C53F3B8DA3AA",
"height": "17872234",
"validator": "cosmosvaloper14k4pzckkre6uxxyd2lnhnpp8sngys9m6hl6ml7",
"blockTime": "1700102295000",
"txnCount": "2",
"round": "0",
"mineReward": "12.274384",
"gasUsed": "615684",
"gasLimit": "666684",
"totalFee": "0.0028330000000000004"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：COSMOS HUB
chainShortName
String
公链缩写符号，例如：COSMOS
hash
String
区块哈希
height
String
区块高度
validator
String
出块者/验证者
blockTime
String
出块时间；Unix时间戳的毫秒数格式，如 1597026383085
txnCount
String
该区块包含的交易数量
round
String
投票轮数
mineReward
String
区块奖励
gasUsed
String
gas消耗
gasLimit
String
gas限额
totalFee
String
该区块所有手续费总和，单位为该链的原生代币
查询区块交易列表
获取 Cosmos 系公链的区块交易列表，最多返回近 10000 条数据，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/block-transaction-list
请求示例
GET /api/v5/explorer/cosmos/block-transaction-list?chainShortName=COSMOS&height=17872234
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
height
String
是
区块高度
transactionListType
String
否
想要查询的交易列表类型 cosmos：返回该区块 Cosmos 交易列表evm：返回该区块 EVM 交易列表默认为cosmos
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"cosmosTransactionList": [
{
"txId": "617533FA5F0BE0773E3AD2CA5665C90203DC5279D64FF879F2A68CFC335A268A",
"txType": "ibc.core.client.v1.MsgUpdateClient,ibc.core.channel.v1.MsgRecvPacket",
"state": "success",
"txFee": "0.000577"
},
{
"txId": "D7FD67D5CD73CC53F980122085AB859B27F26B1ADA2653777AA5D782A4945FB4",
"txType": "cosmos.gov.v1beta1.MsgVote",
"state": "success",
"txFee": "0.002256"
}
],
"evmTransactionList": []
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：COSMOS HUB
chainShortName
String
公链缩写符号，例如：COSMOS
cosmosTransactionList
Array
该区块打包的 Cosmos 交易列表
> txId
String
交易哈希
> txType
String
交易类型，多个交易类型以,分隔
> state
String
交易状态success：成功fail：失败
> txFee
String
手续费，单位为该链的原生代币
evmTransactionList
Array
该区块打包的 EVM 交易列表，仅适用于 Kava 链和 Evmos 链
> txId
String
交易哈希
> methodId
String
方法
> state
String
交易状态success：成功fail：失败
> from
String
发送方地址
> isFromContract
Bol
from 地址是否是合约地址
> to
String
接收方地址
> isToContract
Bol
to 地址是否是合约地址
> amount
String
EVM 外层交易的该链原生代币数量
> txFee
String
手续费，单位为该链的原生代币
查询验证者信息
获取 Cosmos 系公链的验证者列表，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/validator-list
请求示例
GET /api/v5/explorer/cosmos/validator-list?chainShortName=COSMOS&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
validatorAddress
String
是
验证者操作地址
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "573",
"validatorList": [
{
"rank": "1",
"validatorName": "Coinbase Custody",
"validatorAddress": "cosmosvaloper1c4k24jzduc365kywrsvf5ujz4ya6mwympnc4en",
"votingPower": "0.0923",
"weight": "22371898.089718",
"blocks": "500896",
"participateProposals": "0",
"proposals": "152",
"uptime": "1",
"commission": "0.2",
"ownerAddress": "cosmos1c4k24jzduc365kywrsvf5ujz4ya6mwymy8vq4q",
"state": "active",
"bondedHeight": "0",
"website": "custody.coinbase.com",
"descriptions": "Coinbase Custody Cosmos Validator"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
validatorList
Array
验证者列表
> rank
String
验证者投票权排名
> validatorName
String
验证者名称
> validatorAddress
String
验证者操作地址
> votingPower
String
投票权，该验证者质押的原生代币总量占全部验证者质押的原生代币总量的占比
> weight
String
该验证者质押的原生代币总量
> blocks
String
出块的个数
> participateProposals
String
该验证者参与投票的提案数
> proposals
String
总提案数
> uptime
String
在线率，即该验证者在最近 100 个区块的签名情况
> commission
String
佣金比例
> ownerAddress
String
验证者的持有者地址
> state
String
验证者状态active，活跃；jailed，禁用；inactive，非活跃
> bondedHeight
String
质押生效高度
> website
String
质押者官网
> descriptions
String
质押者介绍
查询地址原生代币余额
查询 Cosmos 系公链上地址的原生代币余额信息；支持公链：COSMOS、KAVA、EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/balance-cosmos
请求示例
GET /api/v5/explorer/address/balance-cosmos?chainShortName=cosmos&address=cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8
请求参数
参数名
类型
必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
address
String
是
地址
返回结果
{
"code": "0",
"msg": "",
"data": {
"address": "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8",
"availableBalance": "0.571788",
"delegated": "0",
"delegatedReward": "0",
"rewardRecipientAddress": "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8",
"unbonding": "0",
"symbol": "ATOM",
"commission": "0",
"incentive": "",
"ethereumCoChainAddress": ""
}
}
返回参数
参数名
类型
描述
address
String
地址
availableBalance
String
可用余额
delegated
String
委托中（质押中）数量
delegatedReward
String
质押奖励
rewardRecipientAddress
String
奖励提取地址
unbonding
String
解押中数量
symbol
String
本链币余额币种
commission
String
验证者佣金
incentive
String
激励代币数量，仅适用于Kava、Evmos
ethereumCoChainAddress
String
与Ethereum主链进行交互的合约地址，仅适用于Kava、Evmos
查询地址代币余额明细
获取 Cosmos 系公链某个地址的所有代币余额明细；支持公链：COSMOS、KAVA、EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/token-balance-detail-cosmos
请求示例
GET /api/v5/explorer/address/token-balance-detail-cosmos?chainShortName=kava&address=kava1wq9ts6l7atfn45ryxrtg4a2gwegsh3xha9e6rp&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
address
String
是
地址
tokenType
String
否
代币的类型，默认返回全部 Cosmos 代币（即原生代币、LP 代币、IBC 代币、BEP-3 跨链代币），同时支持筛选不同代币： nativeToken：原生代币 lp：LP 代币 ibc：IBC 代币 bep：BEP-3 跨链代币token_20：ERC-20 代币，仅适用于Kava、Evmostoken_721：ERC-721 代币，仅适用于 Kava、Evmostoken_1155：ERC-1155 代币，仅适用于 Kava、Evmos
ibcDenom
String
否
跨链代币标识，仅适用于 IBC 代币
denom
String
否
代币最小面值，适用于 Cosmos 代币
tokenContractAddress
String
否
代币合约地址，仅适用于 ERC-20、ERC-721、ERC-1155 代币
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "8",
"tokenList": [
{
"token": "debt",
"tokenType": "nativeToken",
"holdingAmount": "21618717436640",
"denom": "debt",
"ibcDenom": ""
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> token
String
该地址对应的代币
> tokenType
String
代币类型 nativeToken：原生代币 lp：LP 代币 ibc：IBC 代币 bep：BEP-3 跨链代币token_20：ERC-20 代币，仅适用于Kava、Evmostoken_721：ERC-721 代币，仅适用于 Kava、Evmostoken_1155：ERC-1155 代币，仅适用于 Kava、Evmos
> holdingAmount
String
代币持仓数量
> denom
String
代币最小面值，适用于 Cosmos 代币
> ibcDenom
String
跨链代币标识，仅适用于 IBC 代币
查询地址普通交易列表信息
获取 Cosmos 系公链地址的 Cosmos 交易列表，最多展示最近 10000 条交易；支持公链：COSMOS、KAVA、EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/address/normal-transaction-cosmos
请求示例
GET /api/v5/explorer/address/normal-transaction-cosmos?chainShortName=cosmos&address=cosmos1nvcgd368m4pm5mm3ppzawhsq6grra4ejnppplx&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
address
String
是
地址
startBlockHeight
String
否
开始查询的区块高度
endBlockHeight
String
否
结束查询的区块高度
page
String
否
页码，默认返回第一页
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"symbol": "ATOM",
"txId": "779D81F33632B91EC2A58CDF79221FAAF357B89EFFA14300D1102DE8A7445DF6",
"blockHash": "1C1672F41EDAA2E1A8E816E885162658D178E0B28691715B97CA927EFF7E3F46",
"height": "18461766",
"transactionTime": "1703678689",
"from": [
"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl",
"cosmos1nvcgd368m4pm5mm3ppzawhsq6grra4ejnppplx"
],
"to": [
"cosmos1nvcgd368m4pm5mm3ppzawhsq6grra4ejnppplx"
],
"txFee": "0.004",
"gasLimit": "700000",
"gasUsed": "644948",
"type": [
"cosmos.staking.v1beta1.MsgDelegate"
],
"value": "0",
"state": "0"
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> symbol
String
交易数量对应的币种
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块
> transactionTime
String
交易时间
> from
Array
发送方地址
> to
Array
接收方地址
> txFee
String
手续费
> gasLimit
String
gas限额
> gasUsed
String
gas消耗
> type
String
交易类型
> value
String
数量
> state
String
交易状态，0表示交易成功，其他表示交易失败
查询交易列表信息
获取 Cosmos 系公链的交易列表信息，最多返回近 10000 条数据，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/transaction-list
请求示例
GET /api/v5/explorer/cosmos/transaction-list?chainShortName=cosmos&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
height
String
否
区块高度
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"transactionList": [
{
"txId": "8169A9D244F5D2478FA8C2D3496BB5BCE5B0D728A6BAA1E33DED085117569CF5",
"blockHash": "86177ABDBC145BFD4C4B3E71DF194866ADB95F716F3549655AAD9E6C8162A3A7",
"height": "18470022",
"transactionTime": "1703729095000",
"from": "cosmos13rsacl9a3r272fqhtw59zeawdpuxkj64cw9myq",
"to": "cosmos1j8pp7zvcu9z8vd882m284j29fn2dszh05cqvf9",
"isFromContract": false,
"isToContract": false,
"amount": "266.85",
"transactionSymbol": "ATOM",
"txFee": "0.002",
"transactionType": "cosmos.bank.v1beta1.MsgSend",
"state": "success"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：COSMOS HUB
chainShortName
String
公链缩写符号，例如：COSMOS
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方地址，如果存在多个地址，以英文逗号分隔
> to
String
接收方地址，如果存在多个地址，以英文逗号分隔
> isFromContract
Bol
from地址是否是合约地址
> isToContract
Bol
to地址是否是合约地址
> amount
String
交易数量
> transactionSymbol
String
交易数量对应的币种
> txFee
String
手续费
> transactionType
String
交易类型
> state
String
交易状态success: 成功fail: 失败
查询代币列表信息
获取 Cosmos 系公链的代币列表信息，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/token-list
请求示例
GET /api/v5/explorer/cosmos/token-list?chainShortName=cosmos&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
protocolType
String
否
代币协议类型，默认返回全部 Cosmos 代币（即原生代币、LP 代币、IBC 代币、BEP-3 跨链代币），同时支持筛选不同代币： 对于 COSMOS 链，支持： nativeToken：原生代币 lp：LP 代币 ibc：IBC 代币 对于 KAVA 和 EVMOS 链，支持：nativeToken：原生代币ibc：IBC 代币 bep：BEP-3 跨链代币token_20：ERC-20 代币 token_721：ERC-721 代币token_1155：ERC-1155 代币
denom
String
否
对于 IBC 代币，输入跨链代币标识；对于其他 Cosmos 代币，输入代币最小面值
tokenContractAddress
String
否
代币合约地址，仅适用于 ERC-20、ERC-721、ERC-1155 代币 需要同时填写 protocolType 为 token_20、token_721 或 token_1155
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"tokenList": [
{
"tokenFullName": "ATOM",
"token": "ATOM",
"precision": "6",
"tokenContractAddress": "",
"protocolType": "nativeToken",
"addressCount": "1139570",
"totalSupply": "351129538.440699",
"circulatingSupply": "372198329",
"price": "12.064",
"website": "",
"totalMarketCap": "4597411775.6",
"transactionAmount24h": "7865935.1198792",
"denom": "uatom"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：COSMOS HUB
chainShortName
String
公链缩写符号，例如：COSMOS
tokenList
Array
代币列表
> tokenFullName
String
代币名字全称
> token
String
代币名字简称
> precision
String
精度
> tokenContractAddress
String
代币合约地址
> protocolType
String
代币协议类型
> addressCount
String
持币地址数
> totalSupply
String
最大供应量
> circulatingSupply
String
流通量
> price
String
价格，单位为 USD
> website
String
官方网站
> totalMarketCap
String
总市值
> transactionAmount24h
String
代币24h交易金额，单位为美元，仅支持20代币和IBC代币
> denom
String
IBC代币：跨链代币标识；其他Cosmos代币：代币最小面值
查询代币持仓列表信息
获取 Cosmos 系公链上某个代币的持仓列表，仅返回余额为 Top 10000 的地址，支持公链：COSMOS, KAVA, EVMOS
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/token-position-list
请求示例
GET /api/v5/explorer/cosmos/token-position-list?chainShortName=cosmos&denom=uatom&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA、EVMOS
denom
String
denom 和 tokenContractAddress 二选一
对于 IBC 代币，输入跨链代币标识；对于其他 Cosmos 代币，输入代币最小面值
tokenContractAddress
String
denom 和 tokenContractAddress 二选一
代币合约地址，仅适用于 ERC-20、ERC-721、ERC-1155 代币
limit
String
否
返回条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"circulatingSupply": "",
"positionList": [
{
"holderAddress": "cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh",
"amount": "241846712.302262",
"valueUsd": "2892970372.559658",
"positionChange24h": "-167045.82778599858",
"rank": "1"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：COSMOS HUB
chainShortName
String
公链缩写符号，例如：COSMOS
circulatingSupply
String
总流通量
positionList
Array
持仓列表
> holderAddress
String
持仓地址
> amount
String
持仓数量
> valueUsd
String
持仓价值，以美金为单位
> positionChange24h
String
24小时持仓量变化
> rank
String
持仓量排名
批量查询代币价格
可以批量查询最多100个代币的价格，价格经过多个CEX和DEX的价格的综合计算，支持公链：COSMOS, KAVA
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/cosmos/token-price-multi
请求示例
GET /api/v5/explorer/cosmos/token-price-multi?chainShortName=cosmos&denom=uatom
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：COSMOS、KAVA
denom
String
denom 和 tokenContractAddress 二选一
对于 IBC 代币，输入跨链代币标识；对于其他 Cosmos 代币，输入代币最小面值
tokenContractAddress
String
denom 和 tokenContractAddress 二选一
代币合约地址，仅适用于 ERC-20、ERC-721、ERC-1155 代币
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"lastPrice": "11.92",
"tokenContractAddress": "",
"denom": "uatom",
"priceAbnormal": []
}
]
}
返回参数
参数名
类型
描述
lastPrice
String
代币的最新价格，价格每1分钟更新1次，单位为USD
tokenContractAddress
String
代币的合约地址，适用于 ERC 代币
denom
String
IBC 代币：跨链代币标识；其他 Cosmos 代币：代币最小面值
priceAbnormal
String
异常币价类型Low Liquidity：低流动性Disparity Between Sources：多价格源差异大Abnormal Fluctuation：价格异常波动
铭文数据模块
铭文功能模块接口，支持查询 BTC 链的 BRC-20、SRC-20、ARC-20 铭文代币数据、地址持仓数据、铭文交易明细，后续会支持更多公链和铭文代币协议
查询铭文代币列表
查询铭文代币列表，最多返回10000条数据，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/token-list
请求示例
GET api/v5/explorer/inscription/token-list?chainShortName=btc&protocolType=brc20&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
tokenInscriptionId
String
否
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID对于ARC-20代币，填写代币的Atomical ID其他铭文代币无需填写该字段
symbol
String
否
对于SRC-20代币，填写代币名称
startTime
String
否
查询发行时间晚于该时间的代币，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
endTime
String
否
查询发行时间早于该时间的代币，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
orderBy
String
否
deployTimeAsc：按部署时间从远到近返回deployTimeDesc ：按部署时间从近到远返回默认为deployTimeAsc
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"tokenList": [
{
"symbol": "XTML",
"tokenInscriptionId": "e28210f430a66e68f1ac5a87a11701cd7062f191dcd67ca79b924d72413101f1i0",
"protocolType": "BRC20",
"totalSupply": "900000000",
"mintAmount": "18000",
"deployTime": "1708751674000",
"holder": "1",
"transactionCount": "3",
"circulatingSupply": "",
"mintBitwork": ""
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> symbol
String
代币名称
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID对于ARC-20代币，返回代币的Atomical ID其他铭文代币该字段返回空
> protocolType
String
铭文代币协议类型
> totalSupply
String
最大供应量
> mintAmount
String
已经铸造数量
> deployTime
String
代币部署日期
> holder
String
持有代币地址数
> transactionCount
String
总交易次数
> circulatingSupply
String
流通量，仅适用于ARC-20代币
> mintBitwork
String
Bitwork挖矿难度，仅适用于部分ARC-20代币
查询铭文代币持仓地址列表
查询铭文代币的持仓地址列表，默认按照持仓数量由多到少返回，最多返回10000条数据，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/token-position-list
请求示例
GET api/v5/explorer/inscription/token-position-list?chainShortName=btc&protocolType=brc20&tokenInscriptionId=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0&limit=3
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
tokenInscriptionId
String
protocolType为BRC20、ARC20时必填
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID对于ARC-20代币，填写代币的Atomical ID其他铭文代币无需填写该字段
symbol
String
protocolType为SRC20时必填
对于SRC-20代币，填写代币名称
holderAddress
String
否
持仓地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "3",
"totalPage": "3334",
"positionList": [
{
"holderAddress": "bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d",
"amount": "8704276.68038247",
"rank": "1"
},
{
"holderAddress": "bc1qggf48ykykz996uv5vsp5p9m9zwetzq9run6s64hm6uqfn33nhq0ql9t85q",
"amount": "1675781.3938851",
"rank": "2"
},
{
"holderAddress": "bc1qm64dsdz853ntzwleqsrdt5p53w75zfrtnmyzcx",
"amount": "1121981.97971559",
"rank": "3"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
positionList
Array
持仓列表
> holderAddress
String
持仓地址
> amount
String
持仓数量
> rank
String
持仓量排名
查询铭文代币转账列表
查询铭文代币转账列表，按照交易时间由近到远返回，最多返回10000条数据，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/token-transaction-list
请求示例
GET api/v5/explorer/inscription/token-transaction-list?chainShortName=btc&protocolType=brc20&tokenInscriptionId=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
tokenInscriptionId
String
protocolType为BRC20、ARC20时必填
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID对于ARC-20代币，填写代币的Atomical ID其他铭文代币无需填写该字段
symbol
String
protocolType为SRC20时必填
对于SRC-20代币，填写代币名称
startTime
String
否
查询交易时间晚于该时间的代币交易，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
endTime
String
否
查询交易时早于该时间的代币交易，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"totalTransfer": "269839",
"transactionList": [
{
"txId": "0cf990907ef51eb0607f7fc6bb81809137d5750f4b64de9a8fc7917770bd1ad5",
"blockHash": "00000000000000000000256813d252f532a57f5473f2e723d8c7483a7df4d42f",
"height": "832486",
"transactionTime": "1709177741000",
"from": "",
"to": "bc1pqjwg8673seyk0t8jtz9j9g78uddps3cppd6nmnvjpp42sn22fqkqy8h700",
"amount": "141",
"symbol": "ordi",
"action": "inscribeTransfer",
"tokenInscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "0cf990907ef51eb0607f7fc6bb81809137d5750f4b64de9a8fc7917770bd1ad5i0",
"inscriptionNumber": "62753536"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
totalTransfer
String
代币总转账次数
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方，多个地址，逗号分隔
> to
String
接收方，多个地址，逗号分隔
> amount
String
交易数量
> symbol
String
对于SRC-20代币，返回代币名称
> action
String
交易类型：deploy、mint、inscribeTransfer、transfer
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID对于ARC-20代币，返回代币的Atomical ID其他铭文代币该字段返回空
> protocolType
String
铭文代币协议类型
> state
String
交易状态成功：success失败：fail
> inscriptionId
String
交易中涉及到的铭文的ID
> inscriptionNumber
String
交易中涉及到的铭文编号
查询铭文列表
查询铭文列表，按照InscriptionNumber倒序排列，最多返回10000条数据，支持BTC链的BRC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/inscription-list
请求示例
GET api/v5/explorer/inscription/inscription-list?chainShortName=btc&protocolType=brc20&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20
tokenInscriptionId
String
否
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID其他铭文代币无需填写该字段
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"inscriptionList": [
{
"inscriptionId": "03fbeb834260fed03f87f0a09e06339379efc5fd3d6d08cc0a87451e509c32f1i0",
"inscriptionNumber": "62752328",
"tokenInscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"symbol": "ordi",
"state": "success",
"protocolType": "BRC20",
"action": "inscribeTransfer",
"ownerAddress": "bc1q6fh6ll49efsjrgcdwh7hp3cswt8faw85agghkk"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
inscriptionList
Array
inscription 列表
> inscriptionId
String
铭文的ID
> inscriptionNumber
String
铭文编号
> symbol
String
代币名称
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID其他铭文代币该字段返回空
> state
String
铭文状态：success、fail
> protocolType
String
铭文代币协议类型
> action
String
交易类型：deploy、mint、inscribeTransfer、transfer
> ownerAddress
String
铭文的所有者地址
查询地址持仓铭文代币列表
查询某个地址持有的铭文代币列表，最多返回10000条数据，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/address-token-list
请求示例
GET api/v5/explorer/inscription/address-token-list?chainShortName=btc&protocolType=brc20&address=bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d&limit=2
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
tokenInscriptionId
String
否
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID对于ARC-20代币，填写代币的Atomical ID其他铭文代币无需填写该字段
symbol
String
否
对于SRC-20代币，填写代币名称
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "48",
"tokenList": [
{
"symbol": "GPTu",
"tokenInscriptionId": "b7456b7e688edea8fb814df146a83a062260b596616bfceff3ae2b9ceb8dbab2i0",
"holdingAmount": "8188888888888889300",
"inscriptionAmount": "2",
"availableAmount": "8188888888888889300",
"transferableAmount": "0"
},
{
"symbol": "arkg",
"tokenInscriptionId": "25e7f4ca11734aa1d1d8c9d9be262b8ea8b09a660a93a826084f7b21b3b41518i0",
"holdingAmount": "8000000000000000000",
"inscriptionAmount": "2",
"availableAmount": "8000000000000000000",
"transferableAmount": "0"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> symbol
String
代币名称
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID对于ARC-20代币，返回代币的Atomical ID其他铭文代币该字段返回空
> holdingAmount
String
代币持仓数量=可转余额+可用余额
> availableAmount
String
可用余额；Mint 类型代币的余额为可用余额，无法直接用于转账。可通过 inscribeTransfer 将可用余额变为可转余额；仅适用于BRC-20
> transferableAmount
String
可转余额；Transfer 类型代币的余额可直接用于转账；仅适用于BRC-20
> inscriptionAmount
String
代币inscription数量
查询地址持仓铭文列表
查询某地址持有的铭文列表，按照inscriptionNumber倒序返回，最多返回10000条数据，支持BTC链的BRC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/address-inscription-list
请求示例
GET api/v5/explorer/inscription/address-inscription-list?chainShortName=btc&protocolType=brc20&address=bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d&limit=2
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20
tokenInscriptionId
String
否
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID其他铭文代币无需填写该字段
symbol
String
否
代币名称
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "2205",
"totalInscription": "4409",
"inscriptionList": [
{
"inscriptionId": "bca21f193e5f16a3fa1207df8021a5923539175e7bab92235c8a7e6ef9cf8db7i0",
"tokenInscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"inscriptionNumber": "62748365",
"symbol": "ordi",
"state": "success",
"protocolType": "BRC20",
"action": "inscribeTransfer"
},
{
"inscriptionId": "e5bc024b23d6e3a2cb499300b34234a625ff2c1d70fa43a28d50250efba5c7d1i0",
"tokenInscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
"inscriptionNumber": "62748359",
"symbol": "sats",
"state": "success",
"protocolType": "BRC20",
"action": "inscribeTransfer"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
totalInscription
String
inscription 总量
inscriptionList
Array
inscription 列表
> inscriptionId
String
铭文的ID
> inscriptionNumber
String
铭文编号
> symbol
String
代币名称
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID其他铭文代币该字段返回空
> state
String
铭文状态：success、fail
> protocolType
String
铭文代币协议类型
> action
String
交易类型：deploy、mint、inscribeTransfer、transfer
查询地址铭文代币转账
查询地址的铭文代币转账，按照交易时间倒序返回，最多返回10000条数据，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/address-token-transaction-list
请求示例
GET api/v5/explorer/inscription/address-token-transaction-list?chainShortName=btc&protocolType=brc20&address=bc1qvwqt8vtn2k7vrjqrsct63pkfw9ufqjldmjm439&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
tokenInscriptionId
String
否
铭文代币的铭文ID对于BRC-20代币，填写代币的Inscription ID对于ARC-20代币，填写代币的Atomical ID其他铭文代币无需填写该字段
symbol
String
否
对于SRC-20代币，填写代币名称
startTime
String
否
查询交易时间晚于该时间的代币交易，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
endTime
String
否
查询交易时间早于该时间的代币交易，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "71",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"totalTransfer": "71",
"transactionList": [
{
"txId": "4cf9aefbc9febf80b68376fa773849aabfdd8e3f7a5254ad11fd7ec6c32d3e89",
"blockHash": "000000000000000000001765a54bc80e84b856d70a77884544839256b42e9a4e",
"height": "832015",
"transactionTime": "1708885500000",
"from": "",
"to": "bc1qvwqt8vtn2k7vrjqrsct63pkfw9ufqjldmjm439",
"amount": "5000",
"symbol": "SHNT",
"action": "inscribeTransfer",
"tokenInscriptionId": "4f54d82160bf08bab83bbe89276b2fd9bed514ce843c91a796daa07bafb85239i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "4cf9aefbc9febf80b68376fa773849aabfdd8e3f7a5254ad11fd7ec6c32d3e89i0",
"inscriptionNumber": "62377691"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
totalTransfer
String
该地址对于代币的总转账次数
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方，多个地址，逗号分隔
> to
String
接收方，多个地址，逗号分隔
> amount
String
交易数量
> symbol
String
代币名称
> action
String
交易类型：deploy、mint、inscribeTransfer、transfer
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID对于ARC-20代币，返回代币的Atomical ID其他铭文代币该字段返回空
> protocolType
String
铭文代币协议类型
> state
String
交易状态成功：success失败：fail
> inscriptionId
String
交易中涉及到的铭文的ID
> inscriptionNumber
String
交易中涉及到的铭文编号
根据交易哈希查询铭文代币交易明细
根据交易哈希查询代币铭文交易明细，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/transaction-detail
请求示例
GET api/v5/explorer/inscription/transaction-detail?chainShortName=btc&protocolType=brc20&txId=c29fc5f33756c572fc55152435d9314059f8639797708b39471330536b94ed0c
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
txId
String
是
交易哈希
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "c29fc5f33756c572fc55152435d9314059f8639797708b39471330536b94ed0c",
"blockHash": "0000000000000000000159cea4e78229ccffab8ecfa94354729ee2b0c52b7a3f",
"height": "831823",
"transactionTime": "1708779611000",
"from": "",
"to": "bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d",
"amount": "2198220440",
"action": "inscribeTransfer",
"tokenInscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "c29fc5f33756c572fc55152435d9314059f8639797708b39471330536b94ed0ci0",
"inscriptionNumber": "62184839",
"symbol": "sats"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方，多个地址，逗号分隔
> to
String
接收方，多个地址，逗号分隔
> amount
String
交易数量
> symbol
String
代币名称
> action
String
交易类型：deploy、mint、inscribeTransfer、transfer
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID对于ARC-20代币，返回代币的Atomical ID其他铭文代币该字段返回空
> protocolType
String
铭文代币协议类型
> state
String
交易状态成功：success失败：fail
> inscriptionId
String
交易中涉及到的铭文的ID
> inscriptionNumber
String
交易中涉及到的铭文编号
根据区块查询铭文代币交易明细
根据区块高度查询代币铭文交易明细，最多返回10000条数据，支持BTC链的BRC-20、SRC-20、ARC-20
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/inscription/block-token-transaction
请求示例
GET api/v5/explorer/inscription/block-token-transaction?chainShortName=btc&protocolType=brc20&height=831823&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
height
String
是
区块高度
protocolType
String
是
铭文代币协议类型BRC-20代币：brc20SRC-20代币：src20ARC-20代币：arc20
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "559",
"totalTransfer": "559",
"transactionList": [
{
"txId": "5ac740cad1c29266bf3615fc4f108c082431c7c0be74944e352edd75eed471ff",
"blockHash": "0000000000000000000159cea4e78229ccffab8ecfa94354729ee2b0c52b7a3f",
"height": "831823",
"from": "",
"to": "bc1pnad2fk3fw6q3d20mhyacdekl7wf96rpg5yqxhtchzvpwet989lpsmvuc9n",
"amount": "1000",
"action": "mint",
"tokenInscriptionId": "4865f05b9132f12bb09d6215f13da5a304a502a95315d0a49463d6f8c0bb7740i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "5ac740cad1c29266bf3615fc4f108c082431c7c0be74944e352edd75eed471ffi0",
"inscriptionNumber": "62196529",
"symbol": "LABS",
"transactionTime": "1708779611000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
totalTransfer
String
代币总转账次数
transactionList
Array
交易列表
> txId
String
交易哈希
> blockHash
String
区块哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> from
String
发送方，多个地址，逗号分隔
> to
String
接收方，多个地址，逗号分隔
> amount
String
交易数量
> symbol
String
代币名称
> action
String
交易类型：deploy、mint、inscribeTransfer、transfer
> tokenInscriptionId
String
铭文代币的铭文ID对于BRC-20代币，返回代币的Inscription ID对于ARC-20代币，返回代币的Atomical ID其他铭文代币该字段返回空
> protocolType
String
铭文代币协议类型
> state
String
交易状态成功：success失败：fail
> inscriptionId
String
交易中涉及到的铭文的ID
> inscriptionNumber
String
交易中涉及到的铭文编号
稳定币数据模块
稳定币数据模块功能模块的接口，可获取USDT发行和销毁记录
查询USDT印钞/销毁记录
获取USDT在TRX、BTC、ETH公链网络上的印钞记录
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/stablecoin/printing-record
请求示例
GET /api/v5/explorer/stablecoin/printing-record?stablecoinName=USDT&network=btc&type=printing&limit=1
请求参数
参数名
类型
是否必须
描述
stablecoinName
String
是
稳定币名称
network
String
是
区块链网络 all：全部 TRX：TRX网络 ETH：ETH网络 BTC：BTC网络 USDT：Omni网络
type
String
是
类型 printing：发行 destruction：销毁
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "83",
"recordList": [
{
"stablecoinName": "USDT",
"txid": "0c8c22ee5cd69649ff36c0396bb9ce951425614a32129d8d54c0144895ef4e7a",
"network": "BTC",
"height": "573063",
"amount": "300000000",
"sendAddress": "32TLn1WLcu8LtfvweLzYUYU6ubc2YV9eZs",
"receiveAddress": "1NTMakcgVwQpMdGxRQnFKyb3G1FAJysSfz",
"transactionTime": "1556131281000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
recordList
String
销毁/发行列表
> stablecoinName
String
稳定币名称
> txid
String
交易哈希
> network
String
所在网络
> height
String
交易发生的区块
> amount
String
数量
> sendAddress
String
发送地址
> receiveAddress
String
接收地址
> transactionTime
String
交易时间
POR数据模块
POR数据模块功能模块接口，提供公开、透明的中心化交易所链上资产概览信息，为用户披露各交易所的链上储备金。
支持查询的交易所：Binance，OKX，Huobi，Bitget，KuCoin，Crypto.com，Bybit，Deribit，Bitfinex
获取交易所储备金
通过该接口获取中心化交易所最新的储备金数据
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/por/proof-of-reserves
请求示例
GET /api/v5/explorer/por/proof-of-reserves
请求参数
参数名
类型
是否必须
描述
institutionName
String
否
中心化机构名称
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"institutionName": "OKX",
"totalBalance": "6502554504.391312",
"balanceDetails": [
{
"symbol": "ETH",
"balance": "1077119.4731584482",
"balanceUsd": "1354434652.7178226",
"change": "1"
},
{
"symbol": "USDT",
"balance": "3006224032.2949777",
"balanceUsd": "3006930041.122987",
"change": "1"
},
{
"symbol": "BTC",
"balance": "102951",
"balanceUsd": "1745781287.4",
"change": "1"
},
{
"symbol": "USDC",
"balance": "395343687.173071",
"balanceUsd": "395391628.917477",
"change": "1"
},
{
"symbol": "BUSD",
"balance": "16889.72009695",
"balanceUsd": "16894.233026629954",
"change": "1"
}
]
}
]
}
返回参数
参数名
类型
描述
institutionName
String
实体名称
totalBalance
String
交易所资产总额，以USDT为单位
balanceDetails
Array
资产明细列表
> symbol
String
代币
> balance
String
代币余额
> change
String
最近7天资金变动涨跌幅，0.1表示10%
> balanceUsd
String
折算成USDT后的金额
获取交易所历史储备金
获取交易所历史储备金记录
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/por/institution-history-asset
请求示例
GET /api/v5/explorer/por/institution-history-asset?institutionName=Huobi
请求参数
参数名
类型
是否必须
描述
institutionName
String
是
中心化机构名称
time
String
否
时间，必须填写utc格式0点0分时间。例如：1670601600000
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"institutionName": "Huobi",
"balanceList": [
{
"chainShortName": "ETH",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"symbol": "USDT",
"balance": "583066271.058834",
"balanceUsd": "583066271.058834",
"time": "1670601600000"
},
{
"chainShortName": "ETH",
"tokenContractAddress": "0xb8c77482e45f1f44de1745f52c74426c631bdd52",
"symbol": "BNB",
"balance": "0.3",
"balanceUsd": "86.51097014666489",
"time": "1670601600000"
}
]
}
]
}
返回参数
参数名
类型
描述
institutionName
String
实体名称
balanceList
Array
资产列表
> chainShortName
String
公链缩写符号
> tokenContractAddress
String
代币合约地址
> symbol
String
代币名称
> balance
String
代币余额
> balanceUsd
String
代币余额（usd）单位
> time
String
历史时间
获取交易所POR地址列表
查询特定交易所公开披露的不同链上的POR地址列表，按照资产金额由高到低最多返回1000个；支持公链：BTC, ETH, BSC, POLYGON, AVAXC, OP, ARBITRUM, BEACON, TRON
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/por/address-list
请求示例
GET /api/v5/explorer/por/address-list?institutionName=Binance
请求参数
参数名
类型
是否必须
描述
institutionName
String
是
中心化机构名称
chainShortName
String
否
公链缩写符号，例如：BTC
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainShortName": "BTC",
"address": "3Jxc4zsvEruEVAFpvwj818TfZXq5y2DLyF"
}
]
}
返回参数
参数名
类型
描述
chainShortName
String
公链缩写符号
address
String
地址
获取交易所TOP50地址资产详情
查询特定交易所的资金量排名前50的地址的资产详情
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/por/address-balance-details
请求示例
GET /api/v5/explorer/por/address-balance-details?institutionName=Huobi
请求参数
参数名
类型
是否必须
描述
institutionName
String
是
中心化机构名称
page
String
否
页码
limit
String
否
返回的数据个数，默认10条，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "50",
"addressDetails": [
{
"balance": "248597.39260212",
"balanceUsd": "7658614453.111291",
"chainShortName": "BTC",
"symbol": "BTC",
"address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
"updateTime": "1698037200000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
addressDetails
Array
地址资产详情
> chainShortName
String
公链缩写符号
> symbol
String
代币
> balance
String
代币余额
> balanceUsd
String
代币余额（usd）单位
> address
String
地址
> updateTime
String
数据更新时间
获取交易所资产流动数据
通过该接口获取中心化交易所近30天的资产流动数据
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/por/asset-flow
请求示例
GET /api/v5/explorer/por/asset-flow?institutionName=Binance
请求参数
参数名
类型
是否必须
描述
institutionName
String
否
中心化机构名称
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"institutionName": "Binance",
"startTime": "1698163200000",
"endTime": "1700755200000",
"symbol": "BTC,USDT,ETH,USDC",
"inFlow": [
{
"entities": "Binance",
"totalValue": 4895055579.856456080721,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 105218.90925652136260,
"usdValue": 6826324.548780690122
},
{
"symbol": "ETH",
"value": 230384927.744176925,
"usdValue": 455318082.704016072
},
{
"symbol": "USDT",
"value": 4124675775.9757988826,
"usdValue": 4126567904.5649451159
},
{
"symbol": "USDC",
"value": 306337238.601268376465,
"usdValue": 306343268.038714202699
}
]
},
{
"entities": "Kraken",
"totalValue": 2894665874.143568113741,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 52334363.306053193576688,
"usdValue": 2894665874.143568113741
}
]
},
{
"entities": "Coinbase",
"totalValue": 1944412213.245690277,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 33499351.06362882384,
"usdValue": 1944412213.245690277
}
]
},
{
"entities": "Non institutional",
"totalValue": 61097057433.775659899517,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 378177025.504197862,
"usdValue": 22381646937.37760093
},
{
"symbol": "ETH",
"value": 420463853.748517634609,
"usdValue": 6353422752.5202973257
},
{
"symbol": "USDT",
"value": 26476640510.29366205403,
"usdValue": 26486442857.38710407426
},
{
"symbol": "USDC",
"value": 5875372621.385650664061,
"usdValue": 5875544886.490657569557
}
]
},
{
"entities": "OTHER",
"totalValue": 5925062015.982478217526750,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 96695995.98055366673561927,
"usdValue": 5629851813.752190546446854
},
{
"symbol": "ETH",
"value": 4235.11820857,
"usdValue": 1888578.92583743166001
},
{
"symbol": "USDT",
"value": 253435373.5741789998,
"usdValue": 253514589.37770223841989
},
{
"symbol": "USDC",
"value": 39806633.34,
"usdValue": 39807033.926748000999996
}
]
}
],
"outflow": [
{
"entities": "Binance",
"totalValue": 25880519279.34233794684659,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 446979843.069527148,
"usdValue": 25758813304.31752274
},
{
"symbol": "ETH",
"value": 241651.542300100004,
"usdValue": 102488438.639715334575
},
{
"symbol": "USDT",
"value": 9683786.116047718969,
"usdValue": 9687369.62429497364399
},
{
"symbol": "USDC",
"value": 9529232.797039480002,
"usdValue": 9530166.7608048986276
}
]
},
{
"entities": "OKX",
"totalValue": 1778131903.198936031468086,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 27229581.83959817462,
"usdValue": 1625828865.799360377
},
{
"symbol": "ETH",
"value": 27502583.2804187682,
"usdValue": 40166453.3014638396
},
{
"symbol": "USDT",
"value": 109012875.6836676494974,
"usdValue": 109066623.358723094326326
},
{
"symbol": "USDC",
"value": 3069684.019895000061435,
"usdValue": 3069960.73938872054176
}
]
},
{
"entities": "Bybit",
"totalValue": 165499102.316852054127908,
"tokenFlowDetailList": [
{
"symbol": "ETH",
"value": 1154670.49264628987,
"usdValue": 5261706.95908915983
},
{
"symbol": "USDT",
"value": 125986732.81877199220003,
"usdValue": 126032425.899575876057908
},
{
"symbol": "USDC",
"value": 34203788.99158674844,
"usdValue": 34204969.45818701824
}
]
},
{
"entities": "Non institutional",
"totalValue": 43553300007.536882798703,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 32883243.02858405587,
"usdValue": 1876226041.101757367
},
{
"symbol": "ETH",
"value": 380488212.12212643767,
"usdValue": 6943686548.344351922
},
{
"symbol": "USDT",
"value": 28554661639.94832429986,
"usdValue": 28565426281.90919205095
},
{
"symbol": "USDC",
"value": 6167752794.3580837402978,
"usdValue": 6167961136.181581458753
}
]
},
{
"entities": "OTHER",
"totalValue": 505335352.4121178055108002,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 10008.386152673052149,
"usdValue": 561052.14232849779361
},
{
"symbol": "ETH",
"value": 5476601.371627149954682053,
"usdValue": 26217318.248646359432310
},
{
"symbol": "USDT",
"value": 460278302.522870445258762,
"usdValue": 460468089.9823136189277595
},
{
"symbol": "USDC",
"value": 18087770.97845448987203,
"usdValue": 18088892.0388293293571207
}
]
}
]
}
]
}
返回参数
参数名
类型
描述
institutionName
String
实体名称
startTime
String
开始时间
endTime
String
结束时间
symbol
String
参与计算的代币
inFlow
Array
流入
> entities
String
交易所实体名称
> totalValue
String
总美元价值
> tokenFlowDetailList
Array
代币流向明细
>> symbol
String
代币名称
>> value
String
代币总数量
>> usdValue
String
代币美元价值
NFT数据模块
NFT数据模块功能模块接口，提供NFT相关数据，包括项目合集数据、NFT的属性、NFT稀有度、地板价等相关数据。
所支持的链列表
获取NFT模块的API接口所支持的公链列表
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/chain-list
请求示例
GET /api/v5/explorer/nft/chain-list
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH"
},
{
"chainFullName": "Polygon",
"chainShortName": "POLYGON"
},
{
"chainFullName": "Optimism",
"chainShortName": "OPTIMISM"
},
{
"chainFullName": "OKT Chain",
"chainShortName": "OKTC"
},
{
"chainFullName": "Avalanche-C",
"chainShortName": "AVAXC"
},
{
"chainFullName": "ARBITRUM",
"chainShortName": "ARBITRUM"
},
{
"chainFullName": "BNB Chain",
"chainShortName": "BSC"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
NFT市场概览
获取全链NFT市场数据总览数据。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/nft-stats-overview
请求示例
GET /api/v5/explorer/nft/nft-stats-overview
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"totalMarketCap": "25854298568.561043",
"totalHolder": "14315586",
"dailyTradingVolume": "8816152.74027341",
"dailyTransaction": "30656"
}
]
}
返回参数
参数名
类型
描述
totalMarketCap
String
全网NFT总市值，单位USD
totalHolder
String
全网持有NFT总地址数
dailyTradingVolume
String
全网日总交易额，单位USD
dailyTransaction
String
全网NFT日交易数
获取集合的概览
获取集合的概览信息，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/collection-info
请求示例
GET /api/v5/explorer/nft/collection-info?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"collectionName": "BoredApeYachtClub",
"token": "BAYC",
"protocolType": "token_721",
"website": "",
"createContractAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
"collectionType": "top_collectibles",
"totalSupply": "10000",
"collectionLogoUrl": "https://static.coinall.ltd/cdn/nft/files/collection/205-logo.webp"
}
]
}
返回参数
参数名
类型
描述
collectionName
String
项目名称（全称）
collectionLogoUrl
String
项目Logo
tokenContractAddress
String
项目合约地址
token
String
代币名称
protocolType
String
合约类型 token_721 token_1155
website
String
官网链接
creatContractAddress
String
创建合约的地址
collectionType
String
项目类别： art sports music domain_names virtual_places trading_cards top_collectibles utility_nfts
totalSupply
String
发行NFT的数量
获取集合详细数据
获取集合的详细信息，包括地板价等，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/collection-details
请求示例
GET /api/v5/explorer/nft/collection-details?chainShortName=ETH&tokenContractAddress=0xed5af388653567af2f388e6224dc7c4b3241c544
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"collectionName": "BoredApeYachtClub",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"totalSupply": "10000",
"holder": "5537",
"avgPrice": "39335.9037",
"transactionNumber": "156",
"activeUser": "67",
"transactionVolume": "1927459.2813000001",
"transactionVolumeUsd": "2992611829.332006",
"floorPrice": "24.38995001",
"lastPrice": "26.9",
"collectionLogoUrl": "https://static.coinall.ltd/cdn/nft/files/collection/205-logo.webp"
}
]
}
返回参数
参数名
类型
描述
collectionName
String
项目名称（全称）
tokenContractAddress
String
项目合约地址
totalSupply
String
发行NFT的数量
holder
String
NFT 持有人数
avgPrice
String
平均价格
transactionNumber
String
日交易数量
activeUser
String
日活跃用户数量
transactionVolume
String
日交易金额，单位为本链币
transactionVolumeUsd
String
日交易金额，单位为USDT
floorPrice
String
地板价
lastPrice
String
最新成交价
collectionLogoUrl
String
项目Logo
获取集合NFT列表
获取集合的NFT列表，支持公链：ETH, OKTC, BSC, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/collection-nft-list
请求示例
GET /api/v5/explorer/nft/collection-nft-list?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
filterType
String
否
筛选数据 转账次数最多：maximum_number_of_transfer 价格由高到低: price_high 价格由低到高: price_low 最新交易时间: latest_transaction_time 默认为 maximum_number_of_transfer
tokenId
String
否
NFT的ID
page
String
否
页码
limit
String
否
返回的条数，最大每页100条，默认20条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10002",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"totalSupply": "10000",
"nftList": [
{
"tokenId": "2779",
"holdingAddressAmount": "1",
"logoUrl": "/nft/files/c34da970-16ba-44b0-8892-bd05d24a350c.webp",
"protocolType": "token_721",
"lastTransactionTime": "1697631959000",
"lastPrice": "24",
"lastPriceUnit": "ETH",
"transactionCount": "202",
"mintTime": "1631463135000",
"title": "Bored Ape Yacht Club #2779"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenContractAddress
String
项目合约地址
totalSupply
String
nft的总发行数量
nftList
Array
NFT列表
> tokenId
String
NFT的tokenid
> holdingAddressAmount
String
持仓该NFT的地址个数
> logoUrl
String
NFT的图片链接
> protocolType
String
该NFT的合约类型
> lastTransactionTime
String
最近交易时间，Unix时间戳的毫秒数格式，如 1597026383085
> lastPrice
String
该NFT的最新价格
> lastPriceUnit
String
价格对应的计单位
> transactionCount
String
该NFT被交易次数
> mintTime
String
该NFT的铸造时间
> title
String
该NFT的metadata中的name属性，可获取ENS或者DID
获取集合的持仓列表
获取某个集合的持币地址列表，仅返回余额为top10000的地址，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/token/position-list
请求示例
GET /api/v5/explorer/token/position-list?chainShortName=eth&tokenContractAddress=0x495f947276749ce646f68ac8c248420045cb7b5e
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
holderAddress
String
否
持仓地址
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"circulatingSupply": "1005858",
"positionList": [
{
"holderAddress": "0x000000000000000000000000000000000000dead",
"amount": "1109086708481",
"valueUsd": "",
"positionChange24h": "",
"rank": "1"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainFullName
String
公链全称，例如：Ethereum
chainShortName
String
公链缩写符号，例如：ETH
circulatingSupply
String
总流通量
positionList
Array
持仓列表
> holderAddress
String
持仓地址
> amount
String
持仓数量
> valueUsd
String
持仓价值，以美金为单位
> positionChange24h
String
24小时持仓量变化
> rank
String
持仓量排名
获取集合地板价
获取集合在各个NFT交易市场中的地板价，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/collection-floor-price
请求示例
GET /api/v5/explorer/nft/collection-floor-price?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
marketplace
String
否
项目NFT交易市场 OpenSea LooksRare X2Y2 Blur CryptoPunks okx
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"marketplace": "OKX",
"floorPrice": "200",
"priceSymbol": "ETH",
"updateTime": "1697542101000"
},
{
"marketplace": "X2Y2",
"floorPrice": "26.98",
"priceSymbol": "ETH",
"updateTime": "1697470407000"
},
{
"marketplace": "LooksRare",
"floorPrice": "26.349",
"priceSymbol": "ETH",
"updateTime": "1697701282000"
},
{
"marketplace": "Blur",
"floorPrice": "24.65",
"priceSymbol": "ETH",
"updateTime": "1697701832000"
},
{
"marketplace": "OpenSea",
"floorPrice": "26.349",
"priceSymbol": "ETH",
"updateTime": "1697701278000"
}
]
}
返回参数
参数名
类型
描述
marketplace
String
项目NFT交易市场
floorPrice
String
该项目的地板价
priceSymbol
String
地板价的单位
updateTime
String
地板价数据更新时间
获取NFT详细数据
获取某个NFT的详细信息，包括地板价、属性和属性的稀有度，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/nft-details
请求示例
GET /api/v5/explorer/nft/nft-details?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
tokenId
String
是
NFT ID
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"collectionName": "BoredApeYachtClub",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "3481",
"protocolType": "token_721",
"token": "BAYC",
"ownerAddress": "0x7285e8f0186a0a41e73cef7603ad7b80a2d5a793",
"logoUrl": "https://static.oklink.com/cdn/nft/files/d7169236-7cbb-4776-8a4c-3ef358f01fc9.webp",
"lastPrice": "0",
"lastPriceUnit": "ETH",
"lastTransactionTime": "1628951146000",
"lastHeight": "13023815",
"lastTxid": "0x7e91013ab5bc0b336f57696dc6cbc7b631127fc0996bab9e10c6657ff09eec9a",
"transactionCount": "66",
"minterAddress": "0xee402489d83e2b22d496910f8c810d35a3ad7b25",
"mintTime": "1619853826000",
"floorPrice": "24.38995001",
"title": "Bored Ape Yacht Club #3481",
"attributes": [
{
"traitType": "Background",
"value": "Gray",
"prevalence": "0.117"
},
{
"traitType": "Clothes",
"value": "Striped Tee",
"prevalence": "0.0412"
},
{
"traitType": "Eyes",
"value": "Bloodshot",
"prevalence": "0.0846"
},
{
"traitType": "Fur",
"value": "Gray",
"prevalence": "0.0496"
},
{
"traitType": "Hat",
"value": "Halo",
"prevalence": "0.0324"
},
{
"traitType": "Mouth",
"value": "Bored Unshaven",
"prevalence": "0.1551"
}
]
}
]
}
返回参数
参数名
类型
描述
collectionName
String
项目名称（全称）
tokenContractAddress
String
项目合约地址
tokenId
String
NFT的tokenid
protocolType
String
该NFT的合约类型
token
String
代币名称
ownerAddress
String
该NFT的持有者地址
logoUrl
String
NFT的图片链接
lastPrice
String
该NFT的最新价格
floorPrice
String
该NFT的地板价
lastPriceUnit
String
价格对应的计单位
lastTransactionTime
String
最近交易时间，Unix时间戳的毫秒数格式，如 1597026383085
lastHeight
String
最近交易所在区块
lastTxid
String
最近交易的hash
transactionCount
String
该NFT被交易次数
minterAddress
String
该NFT的创建地址
storageMethod
String
该NFT的存储方式
mintTime
String
该NFT的铸造时间
title
String
该NFT的metadata中的name属性，可获取ENS或者DID
attributes
Array
属性
> traitType
String
属性类别
> value
String
属性值
> prevalence
String
该属性的稀有度，以小数表示，0.1=10%
获取NFT的持有者地址
获取NFT的持有者地址列表，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/nft-owner-address
请求示例
GET /api/v5/explorer/nft/nft-owner-address?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
项目合集的合约地址
tokenId
String
是
NFT的ID
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"positionList": [
{
"ownerAddress": "0x7285e8f0186a0a41e73cef7603ad7b80a2d5a793",
"logoUrl": "https://static.oklink.com/cdn/nft/files/d7169236-7cbb-4776-8a4c-3ef358f01fc9.webp",
"amount": "1"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
positionList
Array
持有NFT的地址列表
> ownerAddress
String
该NFT的持有者地址
> logoUrl
String
NFT的图片链接
> amount
String
持仓数量
获取NFT的历史交易
获取NFT的历史交易数据，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/nft-trade-history
请求示例
GET /api/v5/explorer/nft/nft-trade-history?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481&activeType=sale&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合约地址
tokenId
String
是
NFT的ID
activeType
String
是
该笔交易的类型，铸造：mint；转账：transfer；成交：sale
page
String
否
页码
limit
String
否
返回的条数，最大每页100条，默认20条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "0",
"collectionName": "Bored Ape Yacht Club",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "3481",
"token": "BAYC",
"historyList": [
{
"amount": "1",
"createTime": "1685730899000",
"fromAddress": "0x4341f1bdd076760013ffc1aeff9fcf1c2c815fab",
"toAddress": "0x5f90dc9735d752e8ef296c045f66efc788a01126",
"price": "45.8640199999999965",
"priceSymbol": "ETH",
"usdPrice": "86760.5079937999981",
"marketplace": "LooksRare",
"actveType": "sale",
"txId": "0x2e925d817680ca70eb46e49f919b1406b86470fa10d50ce1649f57d3615a7bd9",
"invalid": false
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
collectionName
String
项目名称（全称）
tokenContractAddress
String
项目合约地址
tokenId
String
NFT的tokenid
token
String
代币名称
logoUrl
String
NFT的图片链接
historyList
array
历史列表
> amount
String
成交数量
> createTime
String
时间，毫秒时间戳
> fromAddress
String
NFT转出地址
> toAddress
String
NFT转入地址
> price
String
成交价格
> priceSymbol
String
价格单位
> usdPrice
String
折算为美金的成交价值
> marketplace
String
交易市场，例如：OpenSea
> activeType
String
该笔交易的类型，铸造：mint；转账：transfer；成交：sale
> txId
String
交易哈希
> invalid
Bol
是否已过期，true 或 false
获取NFT的出价订单
获取某NFT的出价订单，展示指定NFT在各个交易市场中的订单数据，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/nft-offers-list
请求示例
GET /api/v5/explorer/nft/nft-offers-list?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
tokenId
String
是
NFT的ID
marketplace
String
否
项目NFT交易市场 OpenSea LooksRare X2Y2 Blur CryptoPunks okx
page
String
否
页码
limit
String
否
返回的条数，最大每页100条，默认20条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "140",
"collectionName": "Bored Ape Yacht Club",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "3481",
"token": "BAYC",
"offerList": [
{
"amount": "1",
"createTime": "1683990533000",
"validTime": "1699542522000",
"price": "1",
"priceSymbol": "WETH",
"priceSymbolContractAddress": "",
"orderHash": "0x9fe5e206029ad24c077ca696b43218b7e236d0c871d07aa94f5367208bb9989e",
"ownerAddress": "0xf0ae1a04481a894ecd3dd231af914572bc289935",
"marketplace": "OKX",
"usdPrice": "1919.76"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
collectionName
String
项目名称（全称）
tokenContractAddress
String
项目合约地址
tokenId
String
NFT的token id
token
String
代币名称
offerList
Array
出价单列表
> amount
String
数量
> createTime
String
订单上架时间，毫秒时间戳
> validTime
String
该笔委托过期时间
> price
String
委托价格
> priceSymbol
String
委托价格单位
> priceSymbolContractAddress
String
委托价格单位的代币合约地址
> orderHash
String
订单hash
> ownerAddress
String
出价订单地址
> marketplace
String
交易市场
> usdPrice
String
折算为美金的委托价值
获取NFT的出售订单
获取某NFT的出售订单，展示指定NFT在各个交易市场中的订单数据，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/nft-listing-list
请求示例
GET /api/v5/explorer/nft/nft-listing-list?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=6137
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
tokenContractAddress
String
是
合集的合约地址
tokenId
String
是
NFT的token ID
marketplace
String
否
项目NFT交易市场 OpenSea LooksRare X2Y2 Blur CryptoPunks okx
page
String
否
页码
limit
String
否
返回的条数，最大每页100条，默认20条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "2",
"collectionName": "Bored Ape Yacht Club",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "6137",
"token": "BAYC",
"listingList": [
{
"amount": "1",
"createTime": "1697470407000",
"validTime": "1697729593000",
"price": "26.98",
"priceSymbol": "ETH",
"priceSymbolContractAddress": "",
"orderHash": "0xce44938ed7af8565835b6bc2e57368093bba1fd29d05aa223f1a382d5d62a8d5",
"ownerAddress": "0x65a837220bddc55b67010adec2125e136ed19444",
"marketplace": "X2Y2",
"usdPrice": "41935.5536"
},
{
"amount": "1",
"createTime": "1697530292000",
"validTime": "2147443200000",
"price": "26.98",
"priceSymbol": "ETH",
"priceSymbolContractAddress": "",
"orderHash": "0x478e6e8ee59adfbd81d546af6757df6642e6e9d66b816306dc5305c668997d29",
"ownerAddress": "0x65a837220bddc55b67010adec2125e136ed19444",
"marketplace": "Blur",
"usdPrice": "41935.5536"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
collectionName
String
项目名称（全称）
tokenContractAddress
String
项目合约地址
tokenId
String
NFT的token id
token
String
代币名称
listingList
Array
出售单列表
> amount
String
数量
> createTime
String
订单创建时间，毫秒时间戳
> validTime
String
该笔订单过期时间
> price
String
出售价格
> priceSymbol
String
出售价格单位
> priceSymbolContractAddress
String
出售价格单位的代币合约地址
> orderHash
String
订单哈希
> ownerAddress
String
出售订单地址
> marketplace
String
交易市场
> usdPrice
String
折算为美金的委托价值
获取地址持有的NFT列表
获取指定地址持有的NFT列表，支持公链：ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/nft/address-balance-fills
请求示例
GET /api/v5/explorer/nft/address-balance-fills?chainShortName=oktc&address=0xda0d7f342b9c0f7f5f456e0c0a3ec6fe925eaef3&protocolType=token_721&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
地址
protocolType
String
是
代币协议类型 token_721 token_1155
tokenContractAddress
String
否
项目合集的合约地址
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "224",
"tokenList": [
{
"tokenContractAddress": "0x1e0e008eec6d04c52a3945d3df33d04e06a9c46f",
"tokenId": "5158",
"protocolType": "token_721",
"amount": "1",
"token": "GPF",
"logoUrl": "https://static.oklink.com/cdn/nft/files/65964236-8bd0-4985-9548-440c7953bc8c.webp"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> tokenContractAddress
String
合集的合约地址
> tokenId
String
该地址持仓的tokenid
> protocolType
String
该NFT的合约类型
> amount
String
该地址持有这个NFT的数量
> token
String
代币名称
> logoUrl
String
NFT的logo链接
Defi数据模块
Defi数据模块接口，支持查询Defi借贷（存取、借还、清算）交易数据、不同Defi项目的收益率和总锁仓量数据
查询借贷存取交易
查询Defi借贷存取交易，最多返回最近10000条数据；支持公链：ETH
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/defi/lending-access
请求示例
GET /api/v5/explorer/defi/lending-access?chainShortName=ETH&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：ETH
tokenContractAddress
String
否
代币合约地址；若查询本链币，可填写0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
startBlockHeight
String
否
开始搜索的区块高度
endBlockHeight
String
否
结束搜索的区块高度
maxAmount
String
否
筛选交易数量区间，最大数量
minAmount
String
否
筛选交易数量区间，最小数量
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x2fbb7b6c205851dff82fb27a8a9515fa032a5b6b69845ac6f4ba189967a87653",
"height": "18632143",
"transactionTime": "1700714831000",
"action": "supply",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"quantity": "1900000",
"amount": "1900000",
"project": "Aave V2",
"from": "0xf4dfcd61c36fc3ac374e52206c43253e14c2ffe2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> action
String
交易行为：supply，供应；redeem，赎回
> tokenContractAddress
String
代币合约地址；若为本链币，则返回0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
> quantity
String
代币的供应或赎回数量
> amount
String
代币的交易金额，等于交易数量*代币价格，单位为USD
> project
String
借贷项目
> from
String
发送方，多个地址，逗号分隔
查询借贷借还交易
查询Defi借贷借还交易，最多返回最近10000条数据；支持公链：ETH
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/defi/lending-borrow
请求示例
GET /api/v5/explorer/defi/lending-borrow?chainShortName=ETH&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：ETH
tokenContractAddress
String
否
代币合约地址；若查询本链币，可填写0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
startBlockHeight
String
否
开始搜索的区块高度
endBlockHeight
String
否
结束搜索的区块高度
maxAmount
String
否
筛选交易数量区间，最大数量
minAmount
String
否
筛选交易数量区间，最小数量
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0xf370eb39e628abf10e120ee2af353fdb48172884495be5fa03065e51cebf1ae1",
"height": "18624454",
"transactionTime": "1700621867000",
"action": "repay",
"tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"quantity": "25.22281301849709",
"amount": "49671.2295389268",
"project": "Aave V2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> action
String
交易行为：loan，借款；repay，还款
> tokenContractAddress
String
代币合约地址；若为本链币，则返回0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
> quantity
String
代币的借款或还款数量
> amount
String
代币的交易金额，等于交易数量*代币价格，单位为USD
> project
String
借贷项目
查询借贷清算交易
查询Defi借贷清算交易，最多返回最近10000条数据；支持公链：ETH
每次调用消耗 5 点HTTP请求
GET /api/v5/explorer/defi/lending-liquidate
请求示例
GET /api/v5/explorer/defi/lending-liquidate?chainShortName=ETH&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：ETH
tokenContractAddress
String
否
代币合约地址；若查询本链币，可填写0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
startBlockHeight
String
否
开始搜索的区块高度
endBlockHeight
String
否
结束搜索的区块高度
maxAmount
String
否
筛选交易数量区间，最大数量
minAmount
String
否
筛选交易数量区间，最小数量
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x1120c5ec58e4c5b7565bae56f916845b266213bac2be079607add92bbe51b4a2",
"height": "18623731",
"transactionTime": "1700613095000",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"quantity": "792.439819",
"amount": "792.439819",
"rewards": "828.09961",
"rewardsSymbol": "USDC",
"liquidator": "0xb6569481dccddd527c2b0e8ba32f494e52224ca1",
"project": "Aave V2"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易哈希
> height
String
交易发生的区块高度
> transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
> tokenContractAddress
String
代币合约地址；若为本链币，则返回0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
> quantity
String
代币的清算数量
> amount
String
代币的清算金额，等于清算数量*代币价格，单位为USD
> rewards
String
清算奖励
> rewardsSymbol
String
清算奖励币种单位
> liquidator
String
清算人
> project
String
借贷项目
Defi项目收益率和TVL
支持查询多条公链、多个Defi项目的年化收益率APY或年化利率APR，以及总锁仓量TVL数据
查询支持的Defi协议和公链
获取该模块支持的Defi协议名称和公链列表，默认按照Defi协议名称的首字母排序
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/defi/support-protocol
请求示例
GET /api/v5/explorer/defi/support-protocol
请求参数
参数名
类型
是否必须
描述
chainShortName
String
否
公链缩写符号，如ETH
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainShortName": "AVAX",
"protocol": "Aave V2"
},
{
"chainShortName": "ETH",
"protocol": "Aave V2"
},
{
"chainShortName": "MATIC",
"protocol": "Aave V2"
}
]
}
返回参数
参数名
类型
描述
chainShortName
String
公链缩写符号，例如：ETH
protocol
String
Defi协议名称
根据代币查询Defi数据
查询公链上的不同代币在不同Defi协议中，年化收益率APY或年化利率APR、以及总锁仓量TVL数据；仅支持查询单币池
可通过接口/api/v5/explorer/defi/support-protocol查询支持的公链和Defi协议
每次调用消耗 3 点HTTP请求
GET /api/v5/explorer/defi/token-pool-data
请求示例
GET /api/v5/explorer/defi/token-pool-data?tokenContractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&chainShortName=ETH&protocol=Aave v3&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，如ETH
tokenContractAddress
String
是
代币合约地址；若查询本链币，可填写0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
protocol
String
是
协议名称
startTime
String
否
查询晚于该日期的代币Defi历史数据，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年，默认返回近30天数据
endTime
String
否
查询早于该日期的代币Defi历史数据，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年，默认返回近30天数据
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "30",
"chainShortName": "ETH",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"protocol": "Aave V3",
"rateType": "0",
"rate": "0.04003",
"borrowRateType": "1",
"borrowRate": "0.0491",
"tvl": "46893689.20997",
"poolHistory": [
{
"time": "1702828800000",
"historyRate": "0.05477",
"historyTvl": "39603860.76729802",
"historyBorrowRate": "0.06569"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainShortName
String
公链缩写符号，例如：ETH
tokenContractAddress
String
代币合约地址
protocol
String
Defi协议名称
rateType
Array
supply 收益率类型，0为APY，1为APR
rate
String
代币在该流动性池当前的supply APY或APR，数据每小时更新
borrowRateType
Array
borrow 收益率类型，0为APY，1为APR，仅适用于借贷协议
borrowRate
String
代币在该流动性池当前的borrow APY或APR，仅适用于借贷协议，数据每小时更新
tvl
String
代币在该流动性池当前的总锁仓量，数据每小时更新
poolHistory
Array
代币在流动性池的APY和TVL历史数据，取每天0点的数据
> time
String
日期，以天为维度，Unix时间戳的毫秒数格式，如 1701705600000
> historyRate
String
代币在该流动性池的supply APY或APR历史数据，数据每天更新
> historyTvl
String
代币在该流动性池的TVL历史数据，数据每天更新
> historyBorrowRate
String
代币在该流动性池的borrow APY或APR历史数据，仅适用于借贷协议，数据每天更新
根据流动性池查询Defi数据
根据流动性池的合约地址或LP代币的合约地址，查询不同公链、不同协议、不同流动性池中的年化收益率APY或年化利率APR、以及总锁仓量TVL数据
每次调用消耗 3 点HTTP请求
GET /api/v5/explorer/defi/defi-pool-data
请求示例
GET /api/v5/explorer/defi/defi-pool-data?chainShortName=ETH&poolAddress=0x12392f67bdf24fae0af363c24ac620a2f67dad86
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，如ETH
poolAddress
String
是
流动性池的合约地址，或LP代币的合约地址
startTime
String
否
查询晚于该日期的Defi历史数据，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年，默认返回近30天数据
endTime
String
否
查询早于该日期的Defi历史数据，Unix时间戳的毫秒数格式，如 1597026383085；startTime与endTime之差最长不超过1年，默认返回近30天数据
page
String
否
页码
limit
String
否
返回条数，默认返回最近的20条，最多100条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"limit": "20",
"page": "1",
"totalPage": "2",
"chainShortName": "ETH",
"investmentName": "TUSD",
"protocol": "Compound",
"rateType": "0",
"rate": "0.11277",
"borrowRateType": "1",
"borrowRate": "0.12144",
"tvl": "769606.55705",
"poolHistory": [
{
"time": "1705334400000",
"historyRate": "0.05377",
"historyTvl": "630785.3408479508",
"historyBorrowRate": "0.06957"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainShortName
String
公链缩写符号，例如：ETH
protocol
String
Defi协议名称
investmentName
String
投资品名称
rateType
Array
supply 收益率类型，0为APY，1为APR
rate
String
代币在该流动性池当前的supply APY或APR，数据每小时更新
borrowRateType
Array
borrow 收益率类型，0为APY，1为APR，仅适用于借贷协议
borrowRate
String
代币在该流动性池当前的borrow APY或APR，仅适用于借贷协议，数据每小时更新
tvl
String
代币在该流动性池当前的总锁仓量，数据每小时更新
poolHistory
Array
代币在流动性池的APY和TVL历史数据，取每天0点的数据
> time
String
日期，以天为维度，Unix时间戳的毫秒数格式，如 1701705600000
> historyRate
String
代币在该流动性池的supply APY或APR历史数据，数据每天更新
> historyTvl
String
代币在该流动性池的TVL历史数据，数据每天更新
> historyBorrowRate
String
代币在该流动性池的borrow APY或APR历史数据，仅适用于借贷协议，数据每天更新
K线数据模块
K线数据模块功能模块接口，提供 200+ 条公链的全币种代币行情数据。基于底层强大的解析能力，实时的解析代币的池子里的价格，为用户提供最全面的代币行情数据。
支持公链列表
获取该模块支持的公链列表，可用来查询公链的chainID；默认按照公链缩写的首字母顺序排列
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/tokenprice/chain-list
请求示例
GET /api/v5/explorer/tokenprice/chain-list
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainId": "260",
"chainFullName": "Arkblock",
"chainShortName": "ABT"
},
{
"chainId": "787",
"chainFullName": "Acala Network",
"chainShortName": "ACA"
}
]
}
返回参数
参数名
类型
描述
chainList
Array
支持的公链列表
> chainId
String
公链唯一标识
> chainFullName
String
公链全称，例如：Bitcoin
> chainShortName
String
公链缩写符号，例如：BTC
代币列表
查询 200+ 公链代币列表，获取代币唯一id。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/tokenprice/token-list
请求示例
GET /api/v5/explorer/tokenprice/token-list?token=ordi
请求参数
参数名
类型
是否必须
描述
tokenUniqueId
String
否
代币的唯一ID
page
String
否
页码，不填写，默认返回第一页
limit
String
否
每页返回数据个数，默认为20条数据，最多50条
token
String
否
代币简称，大小写兼容
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"tokenList": [
{
"tokenUniqueId": "18135625983068672",
"tokenFullName": "ordi",
"token": "ordi",
"network": [
{
"chainId": "56",
"chainFullName": "BNB Smart Chain",
"chainShortName": "BNB",
"tokenContractAddress": "0xf06aed41437f9e6d5b21812bb5d41fd709bc4f78"
}
]
},
{
"tokenUniqueId": "18684748417958401",
"tokenFullName": "ordi",
"token": "ordi",
"network": [
{
"chainId": "0",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"tokenContractAddress": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0"
}
]
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
tokenList
Array
代币列表
> tokenUniqueId
String
代币在OKLink系统里的唯一ID标识
> tokenFullName
String
代币全称
> token
String
代币简称
> network
Array
该代币所发行的网络
>> chainId
String
公链唯一标识
>> chainFullName
String
公链全称，例如：Bitcoin
>> chainShortName
String
公链缩写符号，例如：BTC
>> tokenContractAddress
String
代币合约地址
代币历史数据
支持查询 200+ 公链代币的历史价格数据。
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/tokenprice/historical
请求示例
GET /api/v5/explorer/tokenprice/historical?chainId=0&tokenContractAddress=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0&limit=2
请求参数
参数名
类型
是否必须
描述
chainId
String
是
chain的唯一标识，可通过接口/api/v5/explorer/tokenprice/chain-list查询支持链的chainId
tokenContractAddress
String
否
代币合约地址 ，不填写此参数，默认查询本链币的历史数据
limit
String
否
返回数据条数，默认为50条，单次请求最多返回200条
after
String
否
请求此时间戳之前（更旧的数据）的分页内容，传的值为对应接口的time
before
String
否
请求此时间戳之后（更新的数据）的分页内容，传的值为对应接口的time
period
String
否
筛选时间粒度，默认值1d [1m/5m/30m/1h/1D]
查询Facet-VM上铭文代币价格时合约地址前需增加'facet_',如'facet_0x55ab0390a89fed8992e3affbf61d102490735e24'
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"price": "3.271",
"time": "1697644800000",
"priceAbnormal": []
},
{
"price": "3.129",
"time": "1697558400000",
"priceAbnormal": []
}
]
}
返回参数
参数名
类型
描述
price
String
价格
time
String
数据更新时间
priceAbnormal
String
异常币价类型Low Liquidity：低流动性Disparity Between Sources：多价格源差异大Abnormal Fluctuation：价格异常波动
批量查询代币价格
可以批量查询最多100个代币的价格，价格经过多个CEX和DEX的价格的综合计算
每次调用消耗 10 点HTTP请求
GET /api/v5/explorer/tokenprice/price-multi
请求示例
GET /api/v5/explorer/token/tokenprice/price-multi?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2,0x8d983cb9388eac77af0474fa441c4815500cb7bb
请求参数
参数名
类型
必须
描述
chainId
String
否
公链的唯一标识，可通过接口/api/v5/explorer/tokenprice/chain-list查询支持链的chainId chainId和chainShortName必须两者选其一
chainShortName
String
否
公链缩写符号，例如：btc、ethchainId和chainShortName必须两者选其一
tokenContractAddress
String
是
代币的合约地址，最多可以输入100个地址，以,分隔
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"lastPrice": "6.397",
"tokenContractAddress": "0x8d983cb9388eac77af0474fa441c4815500cb7bb",
"priceAbnormal": []
},
{
"lastPrice": "1395.5956462884245",
"tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"priceAbnormal": []
}
]
}
返回参数
参数名
类型
描述
lastPrice
String
代币的最新价格，价格每1分钟更新1次，单位为USD
tokenContractAddress
String
代币的合约地址
priceAbnormal
String
异常币价类型Low Liquidity：低流动性Disparity Between Sources：多价格源差异大Abnormal Fluctuation：价格异常波动
代币市场数据
支持查询 200+ 公链代币的市场数据信息，提供市场上全币种详情。
每次调用消耗 2 点HTTP请求
GET /api/v5/explorer/tokenprice/market-data
请求示例
GET /api/v5/explorer/tokenprice/market-data?chainId=0&tokenContractAddress=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0
请求参数
参数名
类型
是否必须
描述
chainId
String
是
chain的唯一标识，可通过接口/api/v5/explorer/tokenprice/chain-list查询支持链的chainId
tokenContractAddress
String
否
代币合约地址，不填写此参数，默认查询本链币的历史数据。
查询Facet-VM上铭文代币价格时合约地址前需增加'facet_',如'facet_0x55ab0390a89fed8992e3affbf61d102490735e24'
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"lastPrice": "3.412",
"totalSupply": "71946000",
"circulatingSupply": "21000000",
"volume24h": "10030.84212626599936",
"marketCap": "71946000",
"high24h": "3.546",
"low24h": "3.193",
"priceAbnormal": []
}
]
}
返回参数
参数名
类型
描述
lastPrice
String
最新价格
totalSupply
String
代币总供应量
circulatingSupply
String
代币流通量
volume24h
String
24小时交易量
marketCap
String
全网 总市值
high24h
String
24小时最高价
low24h
String
24小时最低价
priceAbnormal
String
异常币价类型Low Liquidity：低流动性Disparity Between Sources：多价格源差异大Abnormal Fluctuation：价格异常波动
逐笔交易数据
获取某Dex中的逐笔交易数据，最多查询10000条
每次调用消耗 1 点HTTP请求
GET /api/v5/explorer/tokenprice/tracker
请求示例
GET /api/v5/explorer/tokenprice/tracker?chainId=1&limit=2
请求参数
参数名
类型
是否必须
描述
chainId
String
是
chain的唯一标识，可通过接口/api/v5/explorer/tokenprice/chain-list查询支持链的chainId
poolAddress
String
否
代币池子合约地址
tokenContractAddress
String
否
代币合约地址
dexName
String
否
发生该笔交易的Dex
page
String
否
页码，不填写，默认返回第一页
height
String
否
区块高度
limit
String
否
每页返回数据个数，默认为20条数据，最多50条
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "5000",
"transactionList": [
{
"txId": "0x7bc10ebc1a151e1d13117edcca38f1e0c28f2faf4b4205970ac2005d181235b1",
"poolAddress": "0x42bc8892085648c1d4b647e405a947f1e0badd38",
"tokenInAmount": "0.04",
"tokenInContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenOutAmount": "2315878.592885542",
"tokenOutContractAddress": "0x857f4fe9426f48526efccf55e7528f6dd5ece6fd",
"dexName": "Balancer V2",
"factoryAddress": "0xba12222222228d8ba445958a75a0704d566bf2c8",
"transactionAmountUsd": "62.08102743967378",
"transactionTime": "1697703791000",
"height": "18383165",
"index": "237",
"traderAddress": "0x2461d9eafa23ffcfe242ed501c1687616a3ec95f"
},
{
"txId": "0xd2689e38ba03a8465046ae2154f0d3407d5e5eb9f021bdee0542337abefaeb9c",
"poolAddress": "0x10027efa7bfd14ac56de5c7e3427efa857d182ee",
"tokenInAmount": "0.007",
"tokenInContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenOutAmount": "1274359.422601473",
"tokenOutContractAddress": "0xa49f4dc8101c84678ac6f0f15c2676d3d8362bd0",
"dexName": "Uniswap V2",
"factoryAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"transactionAmountUsd": "10.864179801942912",
"transactionTime": "1697703791000",
"height": "18383165",
"index": "234",
"traderAddress": "0x8b6d9e300d29bd349f5bdf1fbcac02ba8b97b083"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
transactionList
Array
交易列表
> txId
String
交易Hash
> poolAddress
String
发生该笔交易的pool合约地址
> tokenInAmount
String
转入代币数量
> tokenInContractAddress
String
转入代币合约地址
> tokenOutAmount
String
转出代币数量
> tokenOutContractAddress
String
转出代币的代币合约地址
> dexName
String
Dex名称
> factoryAddress
String
工厂合约地址
> transactionAmountUsd
String
交易金额，以USD为单位
> transactionTime
String
交易时间，UTC格式毫秒时间戳。
> height
String
发生该笔交易的区块高度
> index
String
该笔交易在区块里顺序
> traderAddress
String
交易者地址
链上工具模块
链上工具模块接口，可进行合约验证、查询地址授权代币列表、检测域名风险、广播交易。
合约验证
验证合约源代码是一种项目开源的方式，便于终端用户查看合约，提高合约的透明度。
该功能模块接口，支持提交合约源代码进行合约验证、验证代理合约、查询已验证合约的合约 ABI 和源代码。
支持公链：ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
验证合约源代码
通过上传合约源代码，OKLink 浏览器会将编译后的合约字节码和区块链上的字节码进行匹配，并将其显示在浏览器的合约页面中。
您可使用验证合约源代码 API，进行合约的快速验证，提高验证效率。合约验证的平均处理时间在 30-60s 之间。
支持公链：ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 0 点HTTP请求
POST /api/v5/explorer/contract/verify-source-code
请求示例
POST /api/v5/explorer/contract/verify-source-code
body
{
"chainShortName":"ETH",
"contractAddress":"0x9Dca580D2c8B8e19e9d77345a5b4C2820B25b386",
"contractName":"HelloWorld",
"sourceCode":"pragma solidity ^0.7.6;↵contract HelloWorl {↵ string public greet = 'Hello Worl!';↵}",
"codeFormat":"solidity-single-file",
"compilerVersion":"v0.7.6+commit.7338295f",
"optimization":"1",
"optimizationRuns":"200",
"contractAbi":"0xfce353f66162630000000000000000000000000",
"evmVersion":"tangerineWhistle",
"viaIr":false,
"libraryInfo":[
{
"libraryName":"libraryName1",
"libraryAddress":"0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc"
},
{
"libraryName":"libraryName2",
"libraryAddress":"0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc"
},
{
"libraryName":"libraryName3",
"libraryAddress":"0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc"
}
]
}
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
contractAddress
String
是
合约地址
contractName
String
是
合约名称
sourceCode
String
是
合约源代码；如果合约使用 imports，需要将代码连接成一个文件（即 flattening），可以使用 Solidity flatteners 工具SolidityFlattery（由@DaveAppleton开发）
codeFormat
String
是
代码格式，支持solidity-single-file、solidity-standard-json-input、Vyper
compilerVersion
String
是
使用的编译器版本，如v0.7.6+commit.7338295f、vyper:0.2.11，可在 OKLink 浏览器-合约验证查看支持的编译器版本
optimization
String
是
编译合约时是否使用了优化，0无优化，1有优化
optimizationRuns
String
否
执行优化时运行代码的次数
contractAbi
String
否
合约ABI
evmVersion
String
否
编译合约的EVM版本，若编译时使用了默认版本无需填写；其他指定版本如：tangerineWhistle，spuriousDragon，byzantium
licenseType
String
否
开源许可证类型
viaIr
Bol
否
是否引入基于IR的代码生成器，请与编译时的设置保持一致；true / false，默认为false
libraryInfo
Array
否
合约中引用的库的信息；libraryName和libraryAddress需要进行一一匹配；最多支持10个不同的库对
> libraryName
String
否
库名称
> libraryAddress
String
否
库地址，如0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc
返回结果
{
"code": "0",
"msg": "",
"data": [
"eb5c06099d3841359d398541166343fe"
]
}
返回参数
参数名
类型
描述
guid
String
若提交成功会返回GUID，可根据该GUID查询验证结果
查询合约源代码验证结果
您可以在提交源代码验证之后，根据返回的 GUID 查询验证结果；支持公链：ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 0 点HTTP请求
POST /api/v5/explorer/contract/check-verify-result
请求示例
POST /api/v5/explorer/contract/check-verify-result
body
{
"chainShortName":"ETH",
"guid":"eb5c06099d3841359d398541166343fe"
}
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
guid
String
是
根据GUID查询合约源代码验证结果
返回结果
{
"code": "0",
"msg": "",
"data": [
"Success"
]
}
返回参数
参数名
类型
描述
result
String
合约源代码验证结果；Success代表验证通过，Fail代表未通过验证，Pending代表验证中
使用hardhat进行合约验证
如果使用 hardhat插件 进行合约验证，需要对 hardhat.config.js 文件进行如下修改：
apiKey 为 OKLink API 秘钥，可在 https://www.oklink.com/ 个人中心 - API 管理中申请
network 为您添加的区块链网络
chainId 为公链 ID
urls 中的 apiURL 为 https://www.oklink.com/api/explorer/v1/contract/verify/async/api/{chainName}，browserURL 为 https://www.oklink.com/{chainName}，可在 https://www.oklink.com/ 中查看 OKLink 支持的公链和对应的 URL
以 ETH 链为例，配置如下：
module.exports = {
...
etherscan: {
apiKey: {OKLink API key},
customChains: [
{
network: "eth",
chainId: 1,
urls: {
apiURL: "https://www.oklink.com/api/explorer/v1/contract/verify/async/api/eth",
browserURL: "https://www.oklink.com/eth",
}
}
]
}
};
验证代理合约
验证代理合约是否按照预期调用实现合约；支持公链：ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 0 点HTTP请求
POST /api/v5/explorer/contract/verify-proxy-contract
请求示例
POST /api/v5/explorer/contract/verify-proxy-contract
body
{
"chainShortName": "ETH",
"proxyContractAddress": "0xfeee12d53ddb7ce61ee467ddf7243212a953174a",
"expectedImplementation": "0x0ecbefc71524068cf18f9d4e50d787e134ee70b8"
}
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
proxyContractAddress
String
是
代理合约地址
expectedImplementation
String
否
验证该代理合约转发调用的实现合约是否为该地址
返回结果
{
"code": "0",
"msg": "",
"data": [
"4f2e75682f75410f958c0a3bbf754358"
]
}
返回参数
参数名
类型
描述
guid
String
若提交成功会返回GUID，可根据该GUID查询验证结果
查询代理合约验证结果
您可以在提交代理合约验证之后，根据返回的 GUID 查询验证结果；支持公链：ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 0 点HTTP请求
POST /api/v5/explorer/contract/check-proxy-verify-result
请求示例
POST /api/v5/explorer/contract/check-proxy-verify-result
body
{
"chainShortName":"ETH",
"guid":"4f2e75682f75410f958c0a3bbf754358"
}
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
guid
String
是
根据GUID查询代理合约验证结果
返回结果
{
"code": "0",
"msg": "The proxy's (0x826427966fb2e7edee940c5d99b7d66062faef2e) implementation contract is found at 0xd4a2dca4e03713d5bf7d2173237058466a9c1be4 and is successfully updated.",
"data": []
}
返回参数
参数名
类型
描述
result
String
代理合约源代码验证结果 若验证通过，则返回实现合约的合约地址；若验证失败，则返回“未检测到该代理合约的实现合约”
查询已验证合约的合约ABI和源代码
查询已验证合约的合约 ABI、源代码等基本信息，或查询已验证代理合约的实现合约地址信息；支持公链：ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/contract/verify-contract-info
请求示例
/api/v5/explorer/contract/verify-contract-info?chainShortName=ETH&contractAddress=0xcF80631b469A54dcba8c8ee1aF84505f496ed248
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
contractAddress
String
是
合约地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"sourceCode": "// proxy.sol - execute actions atomically through the proxy's identity\r\n\r\n// Copyright (C) 2017 DappHub, LLC\r\n\r\n// This program is free software: you can redistribute it and/or modify\r\n// it under the terms of the GNU General Public License as published by\r\n// the Free Software Foundation, either version 3 of the License, or\r\n// (at your option) any later version.\r\n\r\n// This program is distributed in the hope that it will be useful,\r\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\r\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\r\n// GNU General Public License for more details.\r\n\r\n// You should have received a copy of the GNU General Public License\r\n// along with this program. If not, see
"contractName": "DSProxy",
"compilerVersion": "v0.4.23+commit.124ca40d",
"optimization": "1",
"optimizationRuns": "200",
"contractAbi": "[{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"owner_\",\"type\":\"address\"}],\"name\":\"setOwner\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_target\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_data\",\"type\":\"bytes\"}],\"name\":\"execute\",\"outputs\":[{\"name\":\"response\",\"type\":\"bytes32\"}],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_code\",\"type\":\"bytes\"},{\"indexed\":false,\"name\":\"_data\",\"type\":\"bytes\"}],\"name\":\"execute\",\"outputs\":[{\"name\":\"target\",\"type\":\"address\"},{\"name\":\"response\",\"type\":\"bytes32\"}],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"cache\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"authority_\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_cacheAddr\",\"type\":\"address\"}],\"name\":\"setCache\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_cacheAddr\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"constant\":false,\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"sig\",\"type\":\"bytes4\"},{\"indexed\":true,\"name\":\"guy\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"foo\",\"type\":\"bytes32\"},{\"indexed\":true,\"name\":\"bar\",\"type\":\"bytes32\"},{\"indexed\":false,\"name\":\"wad\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"fax\",\"type\":\"bytes\"}],\"name\":\"LogNote\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"LogSetAuthority\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"owner\",\"type\":\"address\"}],\"name\":\"LogSetOwner\",\"payable\":false,\"type\":\"event\"}]",
"evmVersion": "Default",
"licenseType": "No License (None)",
"libraryInfo": "",
"proxy": "0",
"implementation": "",
"swarmSource": "bzzr://e498874c9ba9e75028e0c84f1b1d83b2dad5de910c59b837b32e5a190794c5e1"
}
]
}
返回参数
参数名
类型
描述
sourceCode
String
合约源代码
contractName
String
合约名称
compilerVersion
String
使用的编译器版本
optimization
String
编译合约时是否使用了优化，0无优化，1有优化
optimizationRuns
String
执行优化运行代码的次数
contractAbi
String
合约ABI
evmVersion
String
编译合约的EVM版本
licenseType
String
开源许可证类型
libraryInfo
Array
合约中引用的库的信息
> libraryName
String
库名称
> libraryAddress
String
库地址，如0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc
proxy
String
是否为代理合约，0表示不是代理合约，1表示是代理合约
implementation
String
代理合约的实现合约的地址
swarmSource
String
合约源代码的Swarm的哈希值
查询代币授权列表
使用这个API接口查询某代币的授权列表，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, OPBNB
每次调用消耗 1 点HTTP请求
GET /api/v5/tracker/contractscanner/token-authorized-list
请求示例
GET /api/v5/tracker/contractscanner/token-authorized-list?chainShortName=eth&address=0xb011c3F34edbDE3703C25B7eDF2E22a3b4fed08b
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：BTC
address
String
是
您想要查询的代币合约地址
protocolType
String
否
代币类型token_20 token_721 token_1155 默认查询20代币授权信息
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainShortName": "ETH",
"protocolType": "token_20",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"authorizationAddress": "0xb011c3f34edbde3703c25b7edf2e22a3b4fed08b",
"precision": "6",
"tokenFullName": "USD Coin",
"token": "USDC",
"holdingAmount": "6.284591",
"authorizedList": [
{
"approvedContractAddress": "0xb45a2dda996c32e93b8c47098e90ed0e7ab18e39",
"approvedAmount": "unlimited",
"tokenId": "",
"approvedTime": "1673422055000",
"approvedTxId": "0x1fc39113ffb410dd40d8bddaf2efe8a935720f5c8c9b8b5013ef98d912a3a4d6",
"approvedProjectName": ""
}
]
}
]
}
返回参数
参数名
类型
描述
chainShortName
String
公链缩写符号，例如：BTC
protocolType
String
合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
tokenContractAddress
String
代币/NFT集合的合约地址
authorizationAddress
String
被检测的授权地址
precision
String
精度
tokenFullName
String
代币名字全称/或者NFT项目名称：USDCoin
token
String
代币名字简称/NFT项目简称
holdingAmount
String
被检测的地址的链上持仓该代币数量
authorizedList
Array
授权的合约列表
> approvedContractAddress
String
被授权合约地址
> tokenId
String
被授权的tokenID
> approvedAmount
String
授权数量，无限：unlimited ，其他为具体数值
> approvedTime
String
授权时间，UTC 毫秒时间戳
> approvedTxId
String
授权的交易hash
> approvedProjectName
String
授权的项目名称 例如：uniswap V3
查询地址授权代币列表
使用这个API接口查询某地址授权的代币合约列表，包括20代币和721代币的授权信息，支持公链：ETH, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, OPBNB
每次调用消耗 1 点HTTP请求
GET /api/v5/tracker/contractscanner/address-authorized-list
请求示例
GET /api/v5/tracker/contractscanner/address-authorized-list?chainShortName=eth&address=0x7Bf5d8EB050F8cc78BD056BF74047337893B51b0&limit=1
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
address
String
是
您想要查询的地址
protocolType
String
否
代币类型token_20 token_721 token_1155 默认查询20代币授权信息
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": {
"limit": "1",
"page": "1",
"totalPage": "4",
"chainShortName": "ETH",
"authorizedList": [
{
"address": "0x7bf5d8eb050f8cc78bd056bf74047337893b51b0",
"approvedContractAddress": "0x881d40237659c251811cec9c364ef91dc08d300c",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"symbol": "USDT",
"protocolType": "token_20",
"approvedTxId": "0x11a7bc38c0fa9a400ec47a95c94d47b3e5cb0fa0c673b913ffde4ed46adc578f",
"approvedTxHeight": "16720553",
"approvedTime": "1677513299000",
"approvedAmount": "unlimited",
"tokenId": "",
"type": "approval"
}
]
}
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
chainShortName
String
公链缩写符号，
authorizedList
Array
授权列表
> address
String
地址
> approvedContractAddress
String
被授权合约地址
> tokenContractAddress
String
代币/NFT集合的合约地址
> symbol
String
代币名称
> protocolType
String
合约协议类型 20代币：token_20 721代币：token_721 1155代币：token_1155
> approvedTxId
String
授权的交易hash
> approvedTxHeight
String
授权交易hash的高度
> approvedTime
String
授权时间，UTC 毫秒时间戳
> approvedAmount
String
授权数量，无限：unlimited ，其他为具体数值
> tokenId
String
被授权的tokenID
> type
String
授权的类型 approval: 表示 approval 类型授权 approval_all: 表示approval all 类型授权 cancel_approval: 表示取消approval all 类型授权 通常而言, 20 代币只有 approval, 721 有三种类型, 1155 有 approval_all 和 cancel_approval
域名风险检测
通过该接口筛查域名风险，并通过完善的黑域名库和风险特征识别钓鱼网站，降低用户的被钓鱼的风险。
风险等级
风险等级
规则
描述
极高
命中黑域名库
我们认为您检测的域名有极大的风险，建议您做相关措施。
高
命中关键词精准匹配策略
我们认为您检测的域名与官方域名关键词相同，需要警惕钓鱼网站的可能性。
中
命中模糊匹配策略
我们认为被检测的域名有风险，可能需要关注。
低
命中白名单或未有规则命中
不代表该域名没有风险，在我们的风险策略识别或者域名库中没有记录 。
每次调用消耗 1 点HTTP请求
GET /api/v5/tracker/domainscanner/domain-risk-scanning
请求示例
GET /api/v5/tracker/domainscanner/domain-risk-scanning?domain=www.oklink.com
请求参数
参数名
类型
是否必须
描述
domain
String
是
域名， 例如：www.oklink.com 批量查询最多支持5个，以英文逗号分隔。
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"domain": "www.oklink.com",
"level": "LOW"
}
]
}
返回参数
参数名
类型
描述
domain
String
检测域名
level
String
风险等级；风险极大：SEVERE；高：HIGH；中：MEDIUM；低：LOW
广播交易上链
基于OKlink强大的节点服务能力，将您已经完成签名的交易通过该接口广播到指定区块链上，发送给节点验证此交易，支持公链：BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET
每次调用消耗 5 点HTTP请求
POST /api/v5/explorer/transaction/publish-tx
请求示例
POST /api/v5/explorer/transaction/publish-tx
body
{
"chainShortName":"eth",
"signedTx":"12232323"
}
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号
signedTx
String
是
要广播的已签名的原始交易
返回结果
{
"code":"0",
"msg":"",
"data":[
{
"chainFullName":"Bitcoin",
"chainShortName":"BTC",
"txid":"5e95ebfe52c50758e69bbac1d2cc4224dc520498e38505bc958fae8bcd5e8366"
}
]
}
返回参数
参数名
类型
描述
chainFullName
String
公链全称，例如：Bitcoin
chainShortName
String
公链缩写符号，例如：BTC
txid
String
交易哈希
Webhook订阅服务
订阅服务功能模块接口，用于订阅地址或者链上发生的事件，你可以添加Webhook URL来接收您订阅的事件推送，并快速集成到您的应用当中。
支持公链：ETH, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA
Webhook 重试逻辑
如果回调您的服务失败，我们得到了https 状态码非200的响应时，会进行重试，一小时内失败50次即会停止推送，每次间隔5秒。
订阅限制
免费版账户权益：支持订阅50个任务，每个任务最多20个地址，每日推送消息数量上限1000条。
付费版账户权益：支持订阅100个任务，每个任务最多100个地址。
创建webhook任务
创建webhook任务，并设置订阅条件
每次创建消耗 5 点，每次消息推送消耗 1 点HTTP请求
POST /api/v5/explorer/webhook/create-address-activity-tracker
请求示例
POST /api/v5/explorer/webhook/create-address-activity-tracker
body
{
"event":"tokenTransfer",
"chainShortName":"eth",
"webhookUrl":"your own rul",
"trackerName":"name",
"addresses":[
"0xceb69f6342ece283b2f5c9088ff249b5d0ae66ea",
"0x21a31ee1afc51d94c2efccaa2092ad1028285549"
],
"tokenContractAddress":[
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"
],
"valueUsdFilter":{
"minValueUsd":"50000",
"maxValueUsd":"100000"
},
"amountFilter":{
"minAmount":"23",
"maxAmount":"40"
}
}
请求参数
参数名
类型
是否必须
描述
event
String
是
监控的事件类型，tokenTransfer：代币转账，nativeTokenTransfer：本链币转账
chainShortName
String
是
公链缩写符号
webhookUrl
String
是
接收消息的URL，接收到消息后需返回状态码"200"
trackerName
String
是
监控任务名称
addresses
Array
是
地址
tokenContractAddress
Array
否
代币合约地址
amountFilter
Array
否
代币数量筛选
> minAmount
String
否
最小代币数量
> maxAmount
String
否
最大代币数量
valueUsdFilter
Array
否
美元价值筛选
> minValueUsd
String
否
交易的最小金额
> maxValueUsd
String
否
交易的最大金额
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
返回参数
参数名
类型
描述
trackerId
String
监控任务ID，是监控任务唯一标识符
消息推送
{
'blockHash': "0x0b7a9422898ccebf1bf075338c55f0959a506a140992ba3c7f5a896a0e86a7e5",
'symbol': "WETH",
'amount': "'"0.7086312210942441",
'tokenId': "",
'txId': "0x4535e911613107e39dac30f726356a949947b2883bf4af80c977de821675cfb9",
'methodId': "",
'transactionTime': "1697115527000",
'transactionType': "tokenTransfer",
'tokenContractAddress': "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
'from': "0x99dfde431b40321a35deb6aeb55cf338ddd6eccd",
'to': "0x98c3d3183c4b8a650614ad179a1a98be0a8d6b8e",
'event': "tokenTransfer",
'operation': "",
'trackerId': "1481",
'chainShortName': "eth",
'height': "18334488",
'status': "success"
}
消息推送字段
参数名
类型
描述
event
String
监控的事件类型，tokenTransfer：代币转账，nativeTokenTransfer：本链币转账
chainShortName
String
是
height
String
交易发生的区块
transactionTime
String
交易时间；Unix时间戳的毫秒数格式，如 1597026383085
blockHash
String
区块哈希
txId
String
交易哈希
from
String
发送方地址
to
String
接收方地址
amount
String
交易数量
tokenId
String
代币ID，适用于721和1155代币
symbol
String
交易代币的符号
tokenContractAddress
String
交易代币的合约地址
methodId
String
方法
operation
String
操作类型
status
String
交易状态 success 成功 fail 失败 pending 等待确认
trackerId
String
监控任务ID，是监控任务唯一标识符
更新webhook任务条件
更新webhook任务订阅条件
每次消耗 3 点HTTP Request
POST /api/v5/explorer/webhook/update-address-activity-tracker
请求示例
POST /api/v5/explorer/webhook/update-address-activity-tracker
body
{
"event":"nativeTokenTransfer",
"trackerId":"your trackerId",
"chainShortName":"eth",
"webhookUrl":"your own rul",
"trackerName":"name",
"addresses":[
"0xceb69f6342ece283b2f5c9088ff249b5d0ae66ea",
"0x21a31ee1afc51d94c2efccaa2092ad1028285549"
],
"tokenContractAddress":[
"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"0xa0b73e1ff0b80914ab6fe0444e65848c4c34450b"
],
"valueUsdFilter":{
"minValueUsd":"500000",
"maxValueUsd":"1000000"
},
"amountFilter":{
"minAmount":"23",
"maxAmount":"40"
}
}
Request Parameters
参数名
类型
是否必须
描述
event
String
否
监控的事件类型，tokenTransfer：代币转账，nativeTokenTransfer：本链币转账
trackerId
String
是
监控任务ID，是监控任务唯一标识符
chainShortName
String
否
公链缩写符号
webhookUrl
String
否
接收消息的URL，接收到消息后需返回状态码"200"
trackerName
String
否
监控任务名称
tokenContractAddress
Array
否
代币合约地址
amountFilter
Array
否
代币数量筛选
> minAmount
String
否
最小代币数量
> maxAmount
String
否
最大代币数量
valueUsdFilter
Array
否
美元价值筛选
> minValueUsd
String
否
交易的最小金额
> maxValueUsd
String
否
交易的最大金额
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
返回参数
参数名
类型
描述
trackerId
String
监控任务ID，是监控任务唯一标识符
更新webhook任务状态
更新webhook任务订阅状态
每次消耗 3 点HTTP Request
POST /api/v5/explorer/webhook/update-tracker-status
请求示例
POST /api/v5/explorer/webhook/update-tracker-status
body
{
"trackerId": "xxxx",
"isActive": true
}
Request Parameters
参数名
类型
是否必须
描述
trackerId
String
是
监控任务ID，是监控任务唯一标识符
isActive
String
是
是否正常运行：正常发送消息：true，停止发送消息：false
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
返回参数
参数名
类型
描述
trackerId
String
监控任务ID，是监控任务唯一标识符
删除webhook任务
删除webhook任务
每次消耗 3 点HTTP Request
POST /api/v5/explorer/webhook/delete-tracker
请求示例
POST /api/v5/explorer/webhook/delete-tracker
body
{
"trackerId": "xxxx"
}
Request Parameters
参数名
类型
是否必须
描述
trackerId
String
是
监控任务ID，是监控任务唯一标识符
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
返回参数
参数名
类型
描述
trackerId
String
监控任务ID，是监控任务唯一标识符
修改webhook任务地址集合
修改webhook订阅地址集合
每次消耗 3 点HTTP Request
POST /api/v5/explorer/webhook/add-and-remove-tracker-addresses
请求示例
POST /api/v5/explorer/webhook/add-and-remove-tracker-addresses
{
"trackerId": "xxxx",
"action": "add",
"chainShortName": "eth",
"addresses":[
"",
""
]
}
Request Parameters
参数名
类型
是否必须
描述
trackerId
String
是
监控任务ID，是监控任务唯一标识符
action
String
是
操作行为：'add' 增加，'remove' 删除，'replace' 替换
chainShortName
String
是
公链缩写符号
addresses
Array
是
地址
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
返回参数
参数名
类型
描述
trackerId
String
监控任务ID，是监控任务唯一标识符
获取webhook任务列表
获取webhook任务列表
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/webhook/get-tracker-list
请求示例
GET /api/v5/explorer/webhook/get-tracker-list
Request Parameters
参数名
类型
是否必须
描述
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "1",
"trackerList": [
{
"trackerId": "xxxx",
"event": "tokenTransfer",
"trackerName": "xxxxxxx",
"chainShortName": "ETH",
"webhookUrl": " xxxxxx",
"isActive": true,
"updateTime": "1697105146000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
trackerList
Array
监控任务集合
> event
String
监控的事件类型
> trackerId
String
监控任务ID
> chainShortName
String
公链缩写符号
> webhookUrl
String
接收消息的URL
> trackerName
String
监控任务名称
> updateTime
String
更新时间
> isActive
String
是否活跃
获取webhook任务订阅地址列表
获取webhook任务订阅地址列表
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/webhook/get-tracker-addresses
请求示例
GET /api/v5/explorer/webhook/get-tracker-addresses?trackerId=xxxx
请求参数
参数名
类型
是否必须
描述
trackerId
String
是
监控任务ID，是监控任务唯一标识符
limit
String
否
每一页返回的条数，默认返回最近的20条，最多100条
page
String
否
页码
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "1",
"addressList": [
{
"address": "0xa7efae728d2936e78bda97dc267687568dd593f3",
"eventCount": "0",
"createTime": "1697180588000"
}
]
}
]
}
返回参数
参数名
类型
描述
page
String
当前页码
limit
String
当前页共多少条数据
totalPage
String
总共多少页
addressList
Array
地址集合
> address
String
地址
> eventCount
String
事件触发数量
> createTime
String
创建时间
获取webhook任务详情
获取webhook任务详情
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/webhook/get-tracker-details
请求示例
GET /api/v5/explorer/webhook/get-tracker-details?trackerId=xxxx
请求参数
参数名
类型
是否必须
描述
trackerId
String
是
监控任务ID，是监控任务唯一标识符
返回结果
{
"code": "0",1
1
"msg": "",
"data": [
{
"event": "tokenTransfer",
"chainShortName": "ETH",
"trackerId": "xxx",
"webhookUrl": " xxxx",
"trackerName": "wethtestweth112",
"addressCount": "4",
"updateTime": "1697179310000",
"tokenContractAddress": [
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
],
"amountFilter": {
"minAmount": "5",
"maxAmount": "10"
},
"valueUsdFilter": {
"minValueUsd": "",
"maxValueUsd": ""
}
}
]
}
返回参数
参数名
类型
描述
event
String
监控的事件类型，tokenTransfer：代币转账，nativeTokenTransfer：本链币转账
trackerId
String
监控任务ID，是监控任务唯一标识符
chainShortName
String
公链缩写符号
webhookUrl
String
接收消息的URL，接收到消息后需返回状态码"200"
trackerName
String
监控任务名称
updateTime
String
更新时间
addressCount
Array
地址数量
tokenContractAddress
Array
代币合约地址
amountFilter
Array
代币数量筛选。minAmount：最小代币数量；maxAmount ：最大代币数量
valueUsdFilter
Arrary
美元价值筛选。minValueUsd：交易的最小金额；maxValueUsd ：交易的最大金额
webhook测试demo
测试webhook监控任务是否能正常收到数据
使用Ngrok来测试webhook
注册一个免费的Ngrok账户
使用Ngrok引导来安装Ngrok. macOS 运行 'brew install ngrok'
连接您的 Ngrok 帐户 ：'ngrok authtoken YOUR_AUTH_TOKEN'
启动您的本地频道：获取webhook url (Forwarding)
Python Code Demo
from flask import Flask, request
app = Flask(__name__)
@app.route('/webhook', methods=['POST'])
def webhook():
data = request.get_json()
print(data)
return 'suucess'
if __name__ == '__main__':
app.run(port=8001, debug=True)
获取到webhook url后可参照以下步骤进行调试
1.创建webhook监控任务（将获取到的url填入）
2.创建webhook消息推送监听
创建webhook消息推送监控可参照右侧代码
用户需知
为了确保webhook监控的消息能正确推送请确保将以下ip加入白名单：
'47.52.206.222'
RPC API
该模块接口完全兼容 Etherscan，以帮助各 EVM 系公链开发者低成本快速迁移至 OKLink，支持 GET 和 POST 请求。
目前该模块支持 ETH、Polygon、X1_TEST 3条链，后续将继续支持更多 EVM 系公链。
API 请求地址 URL：
https://www.oklink.com/api/v5/explorer/{chainShortName}/api
OKLink 浏览器 API 支持多条公链，因此在查询不同公链的数据时，您需要将公链的缩写放在 Base URL 中，如右侧示例，可在支持的公链查询各公链缩写。
https://www.oklink.com/api/v5/explorer/eth/api
?module=transaction
&action=gettxreceiptstatus
&txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76
请求参数：
所有 module（模块名称）、action（接口功能）及其他请求参数，均与 Etherscan 保持一致。
API 秘钥使用方法：
对于每个 API 请求，需要在 HTTP Request Headers 中添加 (“Ok-Access-Key”，填写您的 API 密钥)。
地址模块 查询地址本链币余额
查询单个地址的本链币余额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=balance
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
返回结果
{
"status": "1",
"message": "OK",
"result": "311273596438144883191969"
}
返回参数
参数名
类型
描述
result
String
地址当前的本链币余额，单位为 wei
批量查询地址本链币余额
批量查询最多20个地址的本链币余额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 3 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=balancemulti
&address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526
请求参数
参数名
类型
是否必须
描述
address
String
是
地址，最多20个，以逗号分隔
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"balance": "332567136222827062478",
"account": "0x63a9975ba31b0b9626b34300f7f627147df1f526"
},
{
"balance": "40891626854930000000999",
"account": "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a"
}
]
}
返回参数
参数名
类型
描述
account
String
地址
balance
String
该地址当前的本链币余额，单位为wei
查询地址普通交易列表
查询某个地址的普通交易列表，最多返回10000笔交易，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlist
&address=0x75fa7ed2996e3d430c8fc670a1c6fc4da4d91c9d
&startblock=19166650
&endblock=19166650
&page=1
&offset=1
&sort=asc
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
startblock
String
否
开始查询的区块
endblock
String
否
结束查询的区块
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "19166650",
"timeStamp": "1707191639",
"hash": "0xc3ff0eba575456c7db192ac96d9fe663795e061494b8ac9242166ebe1418d846",
"nonce": "9",
"blockHash": "0xf93f6d21b9ccf9ffb96981239be6cee55d3b5a9ee3ada004b7f6faf54154bae9",
"transactionIndex": "189",
"from": "0x75fa7ed2996e3d430c8fc670a1c6fc4da4d91c9d",
"to": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
"value": "0",
"gas": "105356",
"gasPrice": "17465509927",
"isError": "0",
"input": "0xde0e9a3e00000000000000000000000000000000000000000000000000d275d8b2e31159",
"contractAddress": "",
"cumulativeGasUsed": "19090928",
"gasUsed": "90310",
"confirmations": "4",
"methodId": "0xde0e9a3e",
"functionName": "unwrap(uint256 tokenId)",
"txreceipt_status": "1"
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
nonce
String
该交易是发起者地址发起的第几笔交易
blockHash
String
区块哈希
transactionIndex
String
区块内交易编号
from
String
发送方地址
to
String
接收方地址
value
String
交易数量，单位为wei
gas
String
gas上限
gasPrice
String
gas价格，单位为wei
isError
String
交易中的合约执行是否发生错误，0表示无错误，1表示有错误
txreceipt_status
String
交易状态，1表示成功，0表示失败
input
String
交易的输入数据
contractAddress
String
如果交易涉及到创建新合约，返回创建的合约地址
cumulativeGasUsed
String
在当前区块中，到目前为止执行的所有交易所消耗的gas量的总和
gasUsed
String
gas消耗
confirmations
String
已确认区块数
methodId
String
标识智能合约函数的短哈希
functionName
String
调用的合约函数名
根据地址查询内部交易
查询某个地址的内部交易列表，最多返回10000笔交易，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlistinternal
&address=0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3
&startblock=0
&endblock=19153162
&page=1
&offset=1
&sort=asc
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
startblock
String
否
开始查询的区块
endblock
String
否
结束查询的区块
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"2535368",
"timeStamp":"1477837690",
"hash":"0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",
"from":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
"to":"",
"value":"0",
"contractAddress":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
"input":"",
"type":"create",
"gas":"254791",
"gasUsed":"46750",
"traceId":"0",
"isError":"0",
"errCode":""
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
from
String
发送方地址
to
String
接收方地址
value
String
交易数量，单位为wei
contractAddress
String
如果内部交易涉及到创建新合约，返回创建的合约地址
input
String
交易的输入数据
type
String
内部交易类型
gas
String
gas限额
gasUsed
String
执行该步骤所消耗的gas
traceId
String
内部交易的跟踪标识符
isError
String
交易是否发生错误，0表示无错误，1表示有错误
errCode
String
如果有错误发生，返回错误码，否则返回空
根据交易哈希查询内部交易
查询某个交易内的内部交易列表，最多返回10000笔交易，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlistinternal
&txhash=0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170
请求参数
参数名
类型
是否必须
描述
txhash
String
是
交易哈希
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "1743059",
"timeStamp": "1466489498",
"hash": "0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170",
"from": "0x2cac6e4b11d6b58f6d3c1c9d5fe8faa89f60e5a2",
"to": "0x66a1c3eaf0f1ffc28d209c0763ed0ca614f3b002",
"value": "7106740000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"traceId": "2",
"isError": "0",
"errCode": ""
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
from
String
发送方地址
to
String
接收方地址
value
String
交易数量，单位为wei
contractAddress
String
如果内部交易涉及到创建新合约，返回创建的合约地址
input
String
交易的输入数据
type
String
内部交易类型
gas
String
gas限额
gasUsed
String
执行该步骤所消耗的gas
traceId
String
内部交易的跟踪标识符
isError
String
交易是否发生错误，0表示无错误，1表示有错误
errCode
String
如果有错误发生，返回错误码，否则返回空
根据区块高度查询内部交易
查询某个区块高度范围内的内部交易列表，最多返回10000笔交易，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlistinternal
&startblock=13481773
&endblock=13491773
&page=1
&offset=1
&sort=asc
请求参数
参数名
类型
是否必须
描述
startblock
String
是
开始查询的区块
endblock
String
是
结束查询的区块
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "13481773",
"timeStamp": "1635100060",
"hash": "0x4ee28cc6a573f745b693a2571300c4e0eb2027c8f7275a5f3b37f3ead7f6b32d",
"from": "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
"to": "0x5b3256965e7c3cf26e11fcaf296dfc8807c01073",
"value": "38000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"traceId": "4",
"isError": "0",
"errCode": ""
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
from
String
发送方地址
to
String
接收方地址
value
String
交易数量，单位为wei
contractAddress
String
如果内部交易涉及到创建新合约，返回创建的合约地址
input
String
交易的输入数据
type
String
内部交易类型
gas
String
gas限额
gasUsed
String
执行该步骤所消耗的gas
traceId
String
内部交易的跟踪标识符
isError
String
交易是否发生错误，0表示无错误，1表示有错误
errCode
String
如果有错误发生，返回错误码，否则返回空
查询地址ERC-20代币转账
查询某个地址的ERC-20代币转账列表，或某个代币合约的代币转账列表，支持公链：ETH, POLYGON, X1_TEST
只输入address：查询该地址的ERC-20代币转账列表
只输入contractaddress：查询该合约地址对应ERC-20代币的转账列表
同时输入contractaddress & address：查询某个地址对于某个特定ERC-20代币的转账列表
注意：区块高度范围建议在10,000以内，否则接口可能会超时
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokentx
&contractaddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2
&address=0x4e83362442b8d1bec281594cea3050c8eb01311c
&page=1
&offset=1
&startblock=19153000
&endblock=19153162
&sort=asc
请求参数
参数名
类型
是否必须
描述
address
String
否
地址
contractaddress
String
否
代币合约地址
startblock
String
否
开始查询的区块
endblock
String
否
结束查询的区块
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result":
"result":[
{
"blockNumber":"4730207",
"timeStamp":"1513240363",
"hash":"0xe8c208398bd5ae8e4c237658580db56a2a94dfa0ca382c99b776fa6e7d31d5b4",
"nonce":"406",
"blockHash":"0x022c5e6a3d2487a8ccf8946a2ffb74938bf8e5c8a3f6d91b41c56378a96b5c37",
"from":"0x642ae78fafbb8032da552d619ad43f1d81e4dd7c",
"contractAddress":"0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"to":"0x4e83362442b8d1bec281594cea3050c8eb01311c",
"value":"5901522149285533025181",
"tokenName":"Maker",
"tokenSymbol":"MKR",
"tokenDecimal":"18",
"transactionIndex":"81",
"gas":"940000",
"gasPrice":"32010000000",
"gasUsed":"77759",
"cumulativeGasUsed":"2523379",
"input":"deprecated",
"confirmations":"7968350"
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
nonce
String
该交易是发起者地址发起的第几笔交易
blockHash
String
区块哈希
from
String
发送方地址
contractAddress
String
代币合约地址
to
String
接收方地址
value
String
代币交易数量
tokenName
String
代币名称
tokenSymbol
String
代币符号
tokenDecimal
String
代币精度
transactionIndex
String
区块内交易编号
gas
String
gas上限
gasPrice
String
gas价格，单位为wei
gasUsed
String
gas消耗
cumulativeGasUsed
String
在当前区块中，到目前为止执行的所有交易所消耗的gas量的总和
input
String
交易的输入数据，通常是调用合约函数的编码
confirmations
String
已确认区块数
查询地址ERC-721代币转账
查询某个地址的ERC-721代币转账列表，或某个代币合约的代币转账列表，支持公链：ETH, POLYGON, X1_TEST
只输入address：查询该地址的ERC-721代币转账列表
只输入contractaddress：查询该合约地址对应ERC-721代币的转账列表
同时输入contractaddress & address：查询某个地址对于某个特定ERC-721代币的转账列表
注意：区块高度范围建议在10,000以内，否则接口可能会超时
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokennfttx
&contractaddress=0x06012c8cf97bead5deae237070f9587f8e7a266d
&address=0x6975be450864c02b4613023c2152ee0743572325
&page=1
&offset=1
&startblock=0
&endblock=27025780
&sort=asc
请求参数
参数名
类型
是否必须
描述
address
String
否
地址
contractaddress
String
否
代币合约地址
startblock
String
否
开始查询的区块
endblock
String
否
结束查询的区块
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "4708120",
"timeStamp": "1512907118",
"hash": "0x031e6968a8de362e4328d60dcc7f72f0d6fc84284c452f63176632177146de66",
"nonce": "0",
"blockHash": "0x4be19c278bfaead5cb0bc9476fa632e2447f6e6259e0303af210302d22779a24",
"from": "0xb1690c08e213a35ed9bab7b318de14420fb57d8c",
"to": "0x6975be450864c02b4613023c2152ee0743572325",
"contractAddress": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
"tokenName": "CryptoKitties",
"tokenSymbol": "CK",
"tokenDecimal": "0",
"transactionIndex": "81",
"gas": "158820",
"gasPrice": "40000000000",
"gasUsed": "60508",
"cumulativeGasUsed": "4880352",
"input": "0x454a2ab3000000000000000000000000000000000000000000000000000000000003157a",
"confirmations": "14452761",
"tokenID": "202106"
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
nonce
String
该交易是发起者地址发起的第几笔交易
blockHash
String
区块哈希
from
String
发送方地址
contractAddress
String
代币合约地址
to
String
接收方地址
tokenID
String
NFT 的代币 ID
tokenName
String
代币名称
tokenSymbol
String
代币符号
tokenDecimal
String
代币精度
transactionIndex
String
区块内交易编号
gas
String
gas上限
gasPrice
String
gas价格，单位为wei
gasUsed
String
gas消耗
cumulativeGasUsed
String
在当前区块中，到目前为止执行的所有交易所消耗的gas量的总和
input
String
交易的输入数据，通常是调用合约函数的编码
confirmations
String
已确认区块数
查询地址ERC-1155代币转账
查询某个地址的ERC-1155代币转账列表，或某个代币合约的代币转账列表，支持公链：ETH, POLYGON, X1_TEST
只输入address：查询该地址的ERC-1155代币转账列表
只输入contractaddress：查询该合约地址对应ERC-1155代币的转账列表
同时输入contractaddress & address：查询某个地址对于某个特定ERC-1155代币的转账列表
注意：区块高度范围建议在10,000以内，否则接口可能会超时
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=token1155tx
&contractaddress=0x76be3b62873462d2142405439777e971754e8e77
&address=0x83f564d180b58ad9a02a449105568189ee7de8cb
&page=1
&offset=1
&startblock=0
&endblock=99999999
&sort=asc
请求参数
参数名
类型
是否必须
描述
address
String
否
地址
contractaddress
String
否
代币合约地址
startblock
String
否
开始查询的区块
endblock
String
否
结束查询的区块
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "13472395",
"timeStamp": "1634973285",
"hash": "0x643b15f3ffaad5d38e33e5872b4ebaa7a643eda8b50ffd5331f682934ee65d4d",
"nonce": "41",
"blockHash": "0xa5da536dfbe8125eb146114e2ee0d0bdef2b20483aacbf30fed6b60f092059e6",
"from": "0x1e63326a84d2fa207bdfa856da9278a93deba418",
"to": "0x83f564d180b58ad9a02a449105568189ee7de8cb",
"contractAddress": "0x76be3b62873462d2142405439777e971754e8e77",
"tokenName": "parallel",
"tokenSymbol": "LL",
"transactionIndex": "100",
"gas": "140000",
"gasPrice": "52898577246",
"gasUsed": "105030",
"cumulativeGasUsed": "11739203",
"input": "0x3e6b214b0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000288300000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000004eb500000000000000000000000000000000000000000000000000000000000000410344d5913b3beedc05dd524fb9006ac0d8e52936b366551c1a0a0f8487e7e1e87e345e8094d856cdf5eb36a8b0e6e243d041760d21d3de073cb8bae0cc578fcd1b00000000000000000000000000000000000000000000000000000000000000",
"confirmations": "5688487",
"tokenValue": "1",
"tokenID": "10371"
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
hash
String
交易哈希
nonce
String
该交易是发起者地址发起的第几笔交易
blockHash
String
区块哈希
from
String
发送方地址
contractAddress
String
代币合约地址
to
String
接收方地址
tokenValue
String
代币交易数量
tokenID
String
NFT 的代币 ID
tokenName
String
代币名称
tokenSymbol
String
代币符号
transactionIndex
String
区块内交易编号
gas
String
gas上限
gasPrice
String
gas价格，单位为wei
gasUsed
String
gas消耗
cumulativeGasUsed
String
在当前区块中，到目前为止执行的所有交易所消耗的gas量的总和
input
String
交易的输入数据，通常是调用合约函数的编码
confirmations
String
已确认区块数
查询地址验证的区块
查询某个地址验证的区块列表，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=getminedblocks
&address=0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b
&page=1
&offset=1
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "19135623",
"timeStamp": "1706815223",
"blockReward": "115675929186924040"
}
]
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
秒级时间戳
blockReward
String
区块奖励，单位为wei
查询地址历史本链币余额
查询某个地址在特定区块高度的本链币余额，支持公链：ETH, POLYGON
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=balancehistory
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&blockno=8000000
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
blockno
String
是
区块高度
返回结果
{
"status": "1",
"message": "OK",
"result": "610538078574759898951277"
}
返回参数
参数名
类型
描述
result
String
地址在对应区块的本链币余额，单位为 wei
合约模块 查询已验证合约的ABI
查询已验证智能合约的合约ABI，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=getabi
&address=0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413
请求参数
参数名
类型
是否必须
描述
address
String
是
合约地址
返回结果
{
"status": "1",
"message": "OK",
"result": "[{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"proposals\",\"outputs\":[{\"name\":\"recipient\",\"type\":\"address\"},{\"name\":\"amount\",\"type\":\"uint256\"},{\"name\":\"description\",\"type\":\"string\"},{\"name\":\"votingDeadline\",\"type\":\"uint256\"},{\"name\":\"open\",\"type\":\"bool\"},{\"name\":\"proposalPassed\",\"type\":\"bool\"},{\"name\":\"proposalHash\",\"type\":\"bytes32\"},{\"name\":\"proposalDeposit\",\"type\":\"uint256\"},{\"name\":\"newCurator\",\"type\":\"bool\"},{\"name\":\"yea\",\"type\":\"uint256\"},{\"name\":\"nay\",\"type\":\"uint256\"},{\"name\":\"creator\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minTokensToCreate\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"rewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"daoCreator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"divisor\",\"outputs\":[{\"name\":\"divisor\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"extraBalance\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"executeProposal\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"unblockMe\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalRewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"actualBalance\",\"outputs\":[{\"name\":\"_actualBalance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"closingTime\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"allowedRecipients\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"refund\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_description\",\"type\":\"string\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"},{\"indexed\":false,\"name\":\"_debatingPeriod\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"bool\"}],\"name\":\"newProposal\",\"outputs\":[{\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"DAOpaidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minQuorumDivisor\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_newContract\",\"type\":\"address\"}],\"name\":\"newContract\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"name\":\"balance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"changeAllowedRecipients\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"halveMinQuorum\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"paidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"splitDAO\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"DAOrewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"proposalDeposit\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"numberOfProposals\",\"outputs\":[{\"name\":\"_numberOfProposals\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"lastTimeMinQuorumMet\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_toMembers\",\"type\":\"bool\"}],\"name\":\"retrieveDAOReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"receiveEther\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"isFueled\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_tokenHolder\",\"type\":\"address\"}],\"name\":\"createTokenProxy\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"name\":\"getNewDAOAddress\",\"outputs\":[{\"name\":\"_newDAO\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_supportsProposal\",\"type\":\"bool\"}],\"name\":\"vote\",\"outputs\":[{\"name\":\"_voteID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"getMyReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"rewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFromWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"name\":\"remaining\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"}],\"name\":\"changeProposalDeposit\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"blocked\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"curator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"checkProposalCode\",\"outputs\":[{\"name\":\"_codeChecksOut\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"privateCreation\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_curator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_daoCreator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_minTokensToCreate\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_closingTime\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_privateCreation\",\"type\":\"address\"}],\"payable\":false,\"type\":\"constructor\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"FuelingToDate\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"CreatedToken\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Refund\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"newCurator\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"description\",\"type\":\"string\"}],\"name\":\"ProposalAdded\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"position\",\"type\":\"bool\"},{\"indexed\":true,\"name\":\"voter\",\"type\":\"address\"}],\"name\":\"Voted\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"result\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"quorum\",\"type\":\"uint256\"}],\"name\":\"ProposalTallied\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"NewCurator\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"AllowedRecipientChanged\",\"payable\":false,\"type\":\"event\"}]"
}
返回参数
参数名
类型
描述
result
String
合约ABI
查询已验证合约的源代码
查询已验证智能合约的合约源代码，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=getsourcecode
&address=0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413
请求参数
参数名
类型
是否必须
描述
address
String
是
合约地址
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"SourceCode": "/*\n\n- Bytecode Verification performed was compared on second iteration -\n\nThis file is part of the DAO.\n\nThe DAO is free software: you can redistribute it and/or modify\nit under the terms of the GNU lesser General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThe DAO is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU lesser General Public License for more details.\n\nYou should have received a copy of the GNU lesser General Public License\nalong with the DAO. If not, see
"ABI": "[{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"proposals\",\"outputs\":[{\"name\":\"recipient\",\"type\":\"address\"},{\"name\":\"amount\",\"type\":\"uint256\"},{\"name\":\"description\",\"type\":\"string\"},{\"name\":\"votingDeadline\",\"type\":\"uint256\"},{\"name\":\"open\",\"type\":\"bool\"},{\"name\":\"proposalPassed\",\"type\":\"bool\"},{\"name\":\"proposalHash\",\"type\":\"bytes32\"},{\"name\":\"proposalDeposit\",\"type\":\"uint256\"},{\"name\":\"newCurator\",\"type\":\"bool\"},{\"name\":\"yea\",\"type\":\"uint256\"},{\"name\":\"nay\",\"type\":\"uint256\"},{\"name\":\"creator\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minTokensToCreate\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"rewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"daoCreator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"divisor\",\"outputs\":[{\"name\":\"divisor\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"extraBalance\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"executeProposal\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"unblockMe\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalRewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"actualBalance\",\"outputs\":[{\"name\":\"_actualBalance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"closingTime\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"allowedRecipients\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"refund\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_description\",\"type\":\"string\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"},{\"indexed\":false,\"name\":\"_debatingPeriod\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"bool\"}],\"name\":\"newProposal\",\"outputs\":[{\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"DAOpaidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minQuorumDivisor\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_newContract\",\"type\":\"address\"}],\"name\":\"newContract\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"name\":\"balance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"changeAllowedRecipients\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"halveMinQuorum\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"paidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"splitDAO\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"DAOrewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"proposalDeposit\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"numberOfProposals\",\"outputs\":[{\"name\":\"_numberOfProposals\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"lastTimeMinQuorumMet\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_toMembers\",\"type\":\"bool\"}],\"name\":\"retrieveDAOReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"receiveEther\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"isFueled\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_tokenHolder\",\"type\":\"address\"}],\"name\":\"createTokenProxy\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"name\":\"getNewDAOAddress\",\"outputs\":[{\"name\":\"_newDAO\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_supportsProposal\",\"type\":\"bool\"}],\"name\":\"vote\",\"outputs\":[{\"name\":\"_voteID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"getMyReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"rewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFromWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"name\":\"remaining\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"}],\"name\":\"changeProposalDeposit\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"blocked\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"curator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"checkProposalCode\",\"outputs\":[{\"name\":\"_codeChecksOut\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"privateCreation\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_curator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_daoCreator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_minTokensToCreate\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_closingTime\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_privateCreation\",\"type\":\"address\"}],\"payable\":false,\"type\":\"constructor\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"FuelingToDate\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"CreatedToken\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Refund\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"newCurator\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"description\",\"type\":\"string\"}],\"name\":\"ProposalAdded\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"position\",\"type\":\"bool\"},{\"indexed\":true,\"name\":\"voter\",\"type\":\"address\"}],\"name\":\"Voted\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"result\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"quorum\",\"type\":\"uint256\"}],\"name\":\"ProposalTallied\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"NewCurator\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"AllowedRecipientChanged\",\"payable\":false,\"type\":\"event\"}]",
"ContractName": "DAO",
"CompilerVersion": "v0.3.1-2016-04-12-3ad5e82",
"OptimizationUsed": "1",
"Runs": "200",
"ConstructorArguments": "000000000000000000000000da4a4626d3e16e094de3225a751aab7128e965260000000000000000000000004a574510c7014e4ae985403536074abe582adfc80000000000000000000000000000000000000000000000001bc16d674ec80000000000000000000000000000000000000000000000000a968163f0a57b4000000000000000000000000000000000000000000000000000000000000057495e100000000000000000000000000000000000000000000000000000000000000000",
"EVMVersion": "Default",
"Library": "",
"LicenseType": "",
"Proxy": "0",
"Implementation": "",
"SwarmSource": ""
}
]
}
返回参数
参数名
类型
描述
SourceCode
String
合约源代码
ABI
String
合约ABI
ContractName
String
合约名称
CompilerVersion
String
使用的编译器版本
OptimizationUsed
String
编译合约时是否使用了优化，0无优化，1有优化
Runs
String
执行优化运行代码的次数
ConstructorArguments
String
构造函数参数，使用ABI编码的形式
EVMVersion
String
编译合约的EVM版本
Library
Array
合约中引用的库的信息
LicenseType
String
开源许可证类型
Proxy
String
是否为代理合约，0表示不是代理合约，1表示是代理合约
Implementation
String
代理合约的实现合约的地址
SwarmSource
String
合约源代码的Swarm的哈希值
查询合约创建者和创建交易哈希
查询合约的部署地址和创建合约的交易哈希，每次请求最多支持查询5个合约，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=getcontractcreation
&contractaddresses=0xB83c27805aAcA5C7082eB45C868d955Cf04C337F
请求参数
参数名
类型
是否必须
描述
contractaddresses
String
是
合约地址，最多5个，以逗号分隔
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"contractAddress": "0xb83c27805aaca5c7082eb45c868d955cf04c337f",
"contractCreator": "0x390dcfddebeff949b9862ec91d7be337b8995553",
"txHash": "0x0dbad4991b6727df606650635c9e632dad8a92c6363c91652307680efd336c6e"
}
]
}
返回参数
参数名
类型
描述
contractAddress
String
合约地址
contractCreator
String
合约创建者
txHash
String
合约创建的交易哈希
验证合约源代码
上传合约源代码进行合约验证，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 0 点
请求示例
POST https://www.oklink.com/api/v5/explorer/eth/api/contract/verifysourcecode
body
{
"sourceCode":"pragma solidity ^0.7.6;↵contract HelloWorl {↵ string public greet = 'Hello Worl!';↵}",
"contractaddress":"0x9Dca580D2c8B8e19e9d77345a5b4C2820B25b386",
"codeformat":"solidity-single-file",
"contractname":"HelloWorld",
"compilerversion":"v0.7.6+commit.7338295f",
"optimizationUsed":"1",
"runs":"200",
"evmVersion":"tangerineWhistle"
}
]
}
请求参数
参数名
类型
是否必须
描述
sourceCode
String
是
合约源代码；如果合约使用 imports，需要将代码连接成一个文件（即 flattening），可以使用 Solidity flatteners 工具SolidityFlattery（由@DaveAppleton开发）
contractaddress
String
是
合约地址
codeformat
String
是
代码格式，支持solidity-single-file、solidity-standard-json-input、Vyper
contractname
String
是
合约名称
compilerversion
String
是
使用的编译器版本，如v0.7.6+commit.7338295f、vyper:0.2.11，可在 OKLink 浏览器-合约验证查看支持的编译器版本
optimizationUsed
String
是
编译合约时是否使用了优化，0无优化，1有优化
runs
String
否
执行优化时运行代码的次数
constructorArguements
String
否
构造函数参数，使用ABI编码的形式
evmversion
String
否
编译合约的EVM版本，若编译时使用了默认版本无需填写；其他指定版本如：tangerineWhistle，spuriousDragon，byzantium
licenseType
String
否
开源许可证类型
libraryname
String
否
合约中使用的库的名称，最多支持10个
libraryaddress
String
否
合约中使用的库的地址，和libraryname一一对应
返回结果
{
"status": "1",
"message": "OK",
"result": "7bea22463da94c649662c1a5aae3efa9"
}
返回参数
参数名
类型
描述
result
String
若提交成功会返回GUID，可根据该GUID查询验证结果
查询合约验证结果
在提交合约源代码验证之后，根据返回的 GUID 查询验证结果，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 0 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=checkverifystatus
&guid=ezq878u486pzijkvvmerl6a9mzwhv6sefgvqi5tkwceejc7tvn
请求参数
参数名
类型
是否必须
描述
guid
String
是
根据GUID查询合约源代码验证结果
返回结果
{
"status": "0",
"message": "OK",
"result": "Success"
}
返回参数
参数名
类型
描述
result
String
合约源代码验证结果；Success代表验证通过，Fail代表未通过验证，Pending代表验证中
验证代理合约
验证代理合约是否按照预期调用实现合约，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 0 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=verifyproxycontract
&address=0xbc46363a7669f6e12353fa95bb067aead3675c29
&expectedimplementation=0xe45a5176bc0f2c1198e2451c4e4501d4ed9b65a6
请求参数
参数名
类型
是否必须
描述
address
String
是
代理合约地址
expectedimplementation
String
否
验证该代理合约转发调用的实现合约是否为该地址
返回结果
{
"status": "1",
"message": "OK",
"result": "523a27789e84489285ffb7c3eaec9cf4"
}
返回参数
参数名
类型
描述
result
String
若提交成功会返回GUID，可根据该GUID查询验证结果
查询代理合约验证结果
在提交代理合约验证之后，根据返回的 GUID 查询验证结果，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 0 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=checkproxyverification
&guid=ezq878u486pzijkvvmerl6a9mzwhv6sefgvqi5tkwceejc7tvn
请求参数
参数名
类型
是否必须
描述
guid
String
是
根据GUID查询代理合约验证结果
返回结果
{
"status": "0",
"message": "OK",
"result": "The proxy's (0x826427966fb2e7edee940c5d99b7d66062faef2e) implementation contract is found at 0xd4a2dca4e03713d5bf7d2173237058466a9c1be4 and is successfully updated."
}
返回参数
参数名
类型
描述
result
String
代理合约源代码验证结果 若验证通过，则返回实现合约的合约地址；若验证失败，则返回“未检测到该代理合约的实现合约”
交易模块 查询合约执行状态
查询交易的合约执行状态，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=transaction
&action=getstatus
&txhash=0xaf1023b59104130950f5719fb5b719332385dc787cf2e2c31121a7268179b443
请求参数
参数名
类型
是否必须
描述
txhash
String
是
交易哈希
返回结果
{
"status": "1",
"message": "OK",
"result": {
"isError": "0",
"errDescription": ""
}
}
返回参数
参数名
类型
描述
isError
String
合约执行状态；对于成功交易，返回0；对于失败交易，返回1
errDescription
String
错误描述
查询交易执行状态
查询交易执行状态，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=transaction
&action=gettxreceiptstatus
&txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76
请求参数
参数名
类型
是否必须
描述
txhash
String
是
交易哈希
返回结果
{
"status": "1",
"message": "OK",
"result": {
"status": "1"
}
}
返回参数
参数名
类型
描述
status
String
交易执行状态，对于成功交易，返回1；对于失败交易，返回0
区块模块 查询区块奖励
查询区块奖励，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=block
&action=getblockreward
&blockno=2165403
请求参数
参数名
类型
是否必须
描述
blockno
String
是
区块高度
返回结果
{
"status": "1",
"message": "OK",
"result": {
"blockNumber": "2165403",
"timeStamp": "1472533979",
"blockMiner": "0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3",
"blockReward": "5314181600000000000"
}
}
返回参数
参数名
类型
描述
blockNumber
String
区块高度
timeStamp
String
出块时间，秒级时间戳
blockMiner
String
区块验证者地址
blockReward
String
区块奖励，单位为wei
查询区块预估倒计时时间
查询某个区块验证完成的剩余预估时间，单位为秒，支持公链：ETH, POLYGON
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=block
&action=getblockcountdown
&blockno=19161699
请求参数
参数名
类型
是否必须
描述
blockno
String
是
区块高度
返回结果
{
"status": "1",
"message": "OK",
"result": {
"CurrentBlock": "19161603",
"CountdownBlock": "19161699",
"RemainingBlock": "96",
"EstimateTimeInSec": "1166.976"
}
}
返回参数
参数名
类型
描述
CurrentBlock
String
当前最新区块高度
CountdownBlock
String
要查询倒计时的区块高度
RemainingBlock
String
剩余区块数量
EstimateTimeInSec
String
区块验证完成预估剩余时间，单位为秒
根据时间戳查询区块高度
查询特定时间出块的区块高度，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=block
&action=getblocknobytime
×tamp=1578638524
&closest=before
请求参数
参数名
类型
是否必须
描述
timestamp
String
是
查询的时间戳；Unix时间戳的秒数格式
closest
String
是
before为在该时间戳之前（包括该时间戳）出块的最近的区块，after为在该时间戳之后（包括该时间戳）出块的最近的区块
返回结果
{
"status": "1",
"message": "OK",
"result": "9251482"
}
返回参数
参数名
类型
描述
result
String
区块高度
查询每日平均区块大小
查询一段时间内的每日平均区块大小，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavgblocksize
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"blockSize_bytes": "20373.362004950493"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"blockSize_bytes": "17499.098277608915"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC日期，格式为yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
blockSize_bytes
String
当日平均区块大小，单位为bytes
查询每日区块数量和奖励
查询每日出块数量和区块奖励，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyblkcount
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"blockCount": "4848",
"UTCDate": "2019-02-01",
"blockRewards_Eth": "14929.4646908706"
},
{
"unixTimeStamp": "1549065600",
"blockCount": "4935",
"UTCDate": "2019-02-02",
"blockRewards_Eth": "15120.386084685942"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC日期，格式为yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
blockCount
String
当日出块数量
blockRewards_Eth
String
当日区块奖励之和，单位为本链币
查询每日区块奖励
查询每日区块奖励，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyblockrewards
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"blockRewards_Eth": "14929.4646908706"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"blockRewards_Eth": "15120.386084685942"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC日期，格式为yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
blockRewards_Eth
String
当日区块奖励之和，单位为本链币
查询每日平均出块时间
查询每日平均出块时间，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavgblocktime
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC时间，格式为yyyy-MM-dd，如 2019-02-01
sort
String
否
asc为升序，desc为降序，默认为asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"blockTime_sec": "17.821782178217823"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"blockTime_sec": "17.507598784194528"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC日期，格式为yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
blockTime_sec
String
每日平均出块时间，单位为秒
代币模块 查询ERC-20代币总供应量
查询ERC-20代币当前流通量，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=tokensupply
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
请求参数
参数名
类型
是否必须
描述
contractaddress
String
是
ERC-20代币合约地址
返回结果
{
"status": "1",
"message": "OK",
"result": "21265524714464"
}
返回参数
参数名
类型
描述
result
String
result：代币总供应量，注意结果以代币最小精度返回，比如代币总供应量为215.241526476136819398，精度为18，则返回215241526476136819398
查询地址ERC-20代币余额
查询某地址的某个ERC-20代币余额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokenbalance
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
请求参数
参数名
类型
是否必须
描述
contractaddress
String
是
ERC-20代币合约地址
address
String
是
要查询余额的地址
返回结果
{
"status": "1",
"message": "OK",
"result": "15"
}
返回参数
参数名
类型
描述
result
String
地址代币余额，注意结果以代币最小精度返回，比如代币余额为215.241526476136819398，精度为18，则返回215241526476136819398
查询ERC-20代币历史总供应量
查询某ERC-20代币在特定区块高度的历史供应量，支持公链：ETH, POLYGON
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&blockno=8000000
请求参数
参数名
类型
是否必须
描述
contractaddress
String
是
ERC-20代币合约地址
blockno
String
是
区块高度
返回结果
{
"status": "1",
"message": "OK",
"result": "21265524714464"
}
返回参数
参数名
类型
描述
result
String
代币在对应区块的总供应量，注意结果以代币最小精度返回，比如代币总供应量为215.241526476136819398，精度为18，则返回215241526476136819398
查询地址ERC-20代币历史余额
查询某个地址在特定区块对于某ERC-20代币的历史余额，支持公链：ETH, POLYGON
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
&blockno=8000000
请求参数
参数名
类型
是否必须
描述
contractaddress
String
是
ERC-20代币合约地址
address
String
是
要查询余额的地址
blockno
String
是
区块高度
返回结果
{
"status": "1",
"message": "OK",
"result": "135499"
}
返回参数
参数名
类型
描述
result
String
地址在对应区块的代币历史余额，注意结果以代币最小精度返回，比如代币余额为215.241526476136819398，精度为18，则返回215241526476136819398
查询ERC-20代币持仓地址列表
查询某ERC-20当前的持仓地址和持仓数量，按照持仓数量降序返回，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=token
&action=tokenholderlist
&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d
&page=1
&offset=1
请求参数
参数名
类型
是否必须
描述
contractaddress
String
是
ERC-20代币合约地址
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"TokenHolderAddress": "0x455257963812c008ce8edf3d08cb48e95c8aa2e2",
"TokenHolderQuantity": "6521980135015"
}
]
}
返回参数
参数名
类型
描述
TokenHolderAddress
String
代币持仓地址
TokenHolderQuantity
String
地址对于代币的持仓数量，注意结果以代币最小精度返回，比如代币持仓量为215.241526476136819398，精度为18，则返回215241526476136819398
查询ERC-20/721/1155代币信息
查询某ERC-20/721/1155代币的项目信息，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 3 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=token
&action=tokeninfo
&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07
请求参数
参数名
类型
是否必须
描述
contractaddress
String
是
代币合约地址
返回结果
{
"status": "1",
"message": "OK",
"result": {
"contractAddress": "0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",
"tokenName": "Gods Unchained Cards",
"symbol": "CARD",
"divisor": "0",
"tokenType": "ERC721",
"totalSupply": "6972003",
"website": "https://godsunchained.com/?refcode=0x5b3256965e7C3cF26E11FCAf296DfC8807C01073",
"twitter": "https://twitter.com/GodsUnchained",
"whitepaper": "",
"tokenPriceUSD": ""
}
}
返回参数
参数名
类型
描述
contractAddress
String
代币合约地址
tokenName
String
代币名称
symbol
String
代币符号
divisor
String
代币精度
tokenType
String
代币类型，ERC-20、ERC-721、ERC-1155
totalSupply
String
代币的总供应量
website
String
代币的官方网站
String
代币的Twitter链接
whitepaper
String
代币的白皮书链接
tokenPriceUSD
String
代币当前的美元价格
查询地址ERC-20代币持仓列表
查询某地址持有的ERC-20代币和余额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=addresstokenbalance
&address=0x983e3660c0bE01991785F80f266A84B911ab59b0
&page=1
&offset=1
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x618e75ac90b12c6049ba3b27f5d5f8651b0037f6",
"TokenName": "QASH",
"TokenSymbol": "QASH",
"TokenQuantity": "19",
"TokenDivisor": "6"
}
]
}
返回参数
参数名
类型
描述
TokenAddress
String
代币合约地址
TokenName
String
代币名称
TokenSymbol
String
代币符号
TokenQuantity
String
代币持仓数量
TokenDivisor
String
代币精度
查询地址ERC-721代币持仓列表
查询某地址持有的ERC-721代币和余额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=addresstokennftbalance
&address=0x6b52e83941eb10f9c613c395a834457559a80114
&page=1
&offset=1
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x7c6f282efbe06e93de4ab5e646478bee20f966b8",
"TokenName": "Legionfarm Celebrities Collection",
"TokenSymbol": "LFT",
"TokenQuantity": "1"
}
]
}
返回参数
参数名
类型
描述
TokenAddress
String
代币合约地址
TokenName
String
代币名称
TokenSymbol
String
代币符号
TokenQuantity
String
代币持仓数量
查询地址特定ERC-721代币持仓列表
查询某地址持有的某个ERC-721项目代币，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=addresstokennftinventory
&address=0x123432244443b54409430979df8333f9308a6040
&contractaddress=0xed5af388653567af2f388e6224dc7c4b3241c544
&page=1
&offset=1
请求参数
参数名
类型
是否必须
描述
address
String
是
地址
contractaddress
String
是
ERC-721代币合约地址
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为100
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
"TokenId": "9055"
}
]
}
返回参数
参数名
类型
描述
TokenAddress
String
代币合约地址
TokenId
String
ERC-721代币的ID
日志模块 查询事件日志
根据不同筛选条件查询事件日志，包括：根据地址和 topic0 筛选，根据地址和区块高度筛选，根据地址、区块高度、topic0 筛选，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=logs
&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
&action=getLogs
&address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8
&page=1
&offset=1
请求参数
参数名
类型
是否必须
描述
address
String
是
触发事件日志的智能合约的地址
fromBlock
String
否
开始查询的区块
toBlock
String
否
结束查询的区块
topic0
String
否
事件日志的 topic0
page
String
否
页码
offset
String
否
每页返回数量，默认值和最大值均为 100
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000003e316f6abe52fc5cf70a6c9c0932dcb1fcbf3d62",
"0x00000000000000000000000029469395eaf6f95920e59f858042f0e28d98a20b",
"0x0000000000000000000000000000000000000000000000000000000000000f93"
],
"data": "0x",
"blockNumber": "0x12674cc",
"timeStamp": "0x65d9e2af",
"gasPrice": "0x56e959dc4",
"gasUsed": "0x3210f",
"logIndex": "0x18a",
"transactionHash": "0x946d9bc16b827d616c37fc422aee9719153a3490585569f03ff7cfb9c00319ad",
"transactionIndex": "0x78"
}
]
}
返回参数
参数名
类型
描述
address
String
触发事件日志的智能合约的地址
topics
Array
事件日志的 topic
data
String
事件的非索引参数
blockNumber
String
区块高度
timeStamp
String
交易时间，秒级时间戳
gasPrice
String
该笔交易的 gas 价格，单位为 wei
gasUsed
String
该笔交易的 gas 消耗
logIndex
String
事件日志在区块中的位置索引
transactionHash
String
交易哈希
transactionIndex
String
区块内交易编号
Gas模块 查询预估 gas 价格
查询预估 gas 价格，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=gastracker
&action=gasoracle
请求参数
返回结果
{
"status": "1",
"message": "OK",
"result": {
"suggestBaseFee": "28.126699714",
"gasUsedRatio": "0.371853066666666667,0.999953733333333333,0.523121033333333333,0.738372333333333333,0.394655666666666667",
"LastBlock": "19297505",
"SafeGasPrice": "28.127541273",
"ProposeGasPrice": "28.127933611",
"FastGasPrice": "29.639802826"
}
}
返回参数
参数名
类型
描述
suggestBaseFee
String
建议每 gas 基础费，单位为 Gwei
gasUsedRatio
String
最近 5 个区块的 gas 消耗比例
LastBlock
String
最新区块高度
SafeGasPrice
String
慢速 gas 价格，单位为 Gwei
ProposeGasPrice
String
建议 gas 价格，单位为 Gwei
FastGasPrice
String
快速 gas 价格，单位为 Gwei
查询每日平均 gas 限额
查询每日平均 gas 限额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavggaslimit
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"gasLimit": "8001271",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"gasLimit": "8001245",
"UTCDate": "2019-02-02"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
gasLimit
String
当日平均 gas 限额
查询每日 gas 消耗总额
查询每日所有交易 gas 消耗总额，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailygasused
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"gasUsed": "29994520939",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"gasUsed": "28583928186",
"UTCDate": "2019-02-02"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
gasUsed
String
当日 gas 消耗总额
查询每日平均 gas 价格
查询每日平均 gas 价格，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavggasprice
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"maxGasPrice_Wei": "60814303896257",
"minGasPrice_Wei": "0",
"avgGasPrice_Wei": "13320433407"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"maxGasPrice_Wei": "20000000000000",
"minGasPrice_Wei": "0",
"avgGasPrice_Wei": "11986248035"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
maxGasPrice_Wei
String
每日最大 gas 价格，单位为 wei
minGasPrice_Wei
String
每日最小 gas 价格，单位为 wei
avgGasPrice_Wei
String
每日平均 gas 价格，单位为 wei
统计模块 查询本链币总供应量
查询不同公链的本链币总供应量，支持公链：ETH, POLYGON
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=nativetokensupply
请求参数
返回结果
{
"status": "1",
"message": "OK",
"result": "120156541650000000000000000"
}
返回参数
参数名
类型
描述
result
String
本链币总供应量，单位为 wei
查询本链币最新价格
查询不同公链的本链币最新价格，支持公链：ETH, POLYGON
每次调用消耗 2 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=nativetokenprice
请求参数
返回结果
{
"status": "1",
"message": "OK",
"result": {
"nativetokenbtc": "0.057867210944049643",
"nativetokenusd": "2954.26",
"nativetokenbtc_timestamp": "1708778400",
"nativetokenusd_timestamp": "1708778400"
}
}
返回参数
参数名
类型
描述
nativetokenbtc
String
本链币相对于 BTC 的价格
nativetokenbtc_timestamp
String
本链币相对于 BTC 的价格的最近更新时间，秒级时间戳
nativetokenusd
String
本链币的最新美元价格
nativetokenusd_timestamp
String
本链币最新美元价格的更新时间，秒级时间戳
查询每日网络交易费用
查询每日网络交易费用之和，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailytxnfee
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"transactionFee_nativetoken": "14929.4646908706"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"transactionFee_nativetoken": "15120.386084685942"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
transactionFee_nativetoken
String
当日支付给矿工的交易费用之和，单位为本链币
查询每日新增地址数
查询每日新增地址数量，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailynewaddress
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"newAddressCount": "59997",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"newAddressCount": "70617",
"UTCDate": "2019-02-02"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
newAddressCount
String
当日新增地址数
查询每日网络利用率
查询每日网络利用率，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailynetutilization
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"networkUtilization": "0.8464394280243289",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"networkUtilization": "0.7686569959455622",
"UTCDate": "2019-02-02"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
networkUtilization
String
当日网络利用率，即每日平均 gas 消耗/gas limit
查询每日交易数量
查询每日交易数量，支持公链：ETH, POLYGON, X1_TEST
每次调用消耗 5 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailytx
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"transactionCount": "498856",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"transactionCount": "450314",
"UTCDate": "2019-02-02"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
transactionCount
String
当日交易数量
查询本链币历史每日价格
查询不同公链本链币历史每日价格，支持公链：ETH, POLYGON
每次调用消耗 1 点
请求示例
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=nativetokendailyprice
&startdate=2024-02-01
&enddate=2024-02-02
&sort=asc
请求参数
参数名
类型
是否必须
描述
startdate
String
是
开始查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
enddate
String
是
结束查询日期，UTC 时间，格式为 yyyy-MM-dd，如 2019-02-01
sort
String
否
asc 为升序，desc 为降序，默认为 asc
返回结果
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1706745600",
"value": "2283.4",
"UTCDate": "2024-02-01"
},
{
"unixTimeStamp": "1706832000",
"value": "2303.71",
"UTCDate": "2024-02-02"
}
]
}
返回参数
参数名
类型
描述
UTCDate
String
UTC 日期，格式为 yyyy-MM-dd，如 2019-02-01
unixTimeStamp
String
秒级时间戳
value
String
当日本链币美元价格
API使用和管理
可查询不同公链支持的API接口、不同API接口支持的公链，以及您的浏览器API订阅信息、历史调用数据、调用消耗TOP10接口
查询公链支持接口
获取指定公链所支持的API接口信息，包括BTC, BCH, LTC, DASH, DOGE, ETH, OKTC,X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BEACON, STARKNET, COSMOS
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/chain-supported-apis
请求示例
GET /api/v5/explorer/chain-supported-apis?chainShortName=btc
请求参数
参数名
类型
是否必须
描述
chainShortName
String
是
公链缩写符号，例如：btc、eth，请求/api/v5/explorer/blockchain/summary接口查询OKLink已支持的公链
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"chainSupportedApis": [
"/api/v5/explorer/btc/address-balance-details",
"/api/v5/explorer/block/address-balance-history",
"/api/v5/explorer/address/utxo",
"/api/v5/explorer/address/address-summary",
"/api/v5/explorer/btc/position-list",
"/api/v5/explorer/address/unspent",
"/api/v5/explorer/blockchain/transaction",
"/api/v5/tracker/contractscanner/token-authorized-list",
"/api/v5/explorer/address/transaction-list",
"/api/v5/explorer/btc/inscriptions-list",
"/api/v5/explorer/btc/transaction-list",
"/api/v5/explorer/btc/address-balance-list",
"/api/v5/explorer/btc/token-details",
"/api/v5/explorer/pool/pool-hashrate-rank",
"/api/v5/explorer/transaction/large-transaction-list",
"/api/v5/explorer/block/block-fills",
"/api/v5/explorer/block/block-list",
"/api/v5/explorer/transaction/transaction-fills",
"/api/v5/explorer/transaction/unconfirmed-transaction-list",
"/api/v5/explorer/transaction/publish-tx",
"/api/v5/explorer/transaction/transaction-list",
"/api/v5/explorer/blockchain/fee",
"/api/v5/explorer/address/rich-list",
"/api/v5/explorer/transaction/decode",
"/api/v5/explorer/address/balance-multi",
"/api/v5/explorer/btc/token-list",
"/api/v5/explorer/tokenprice/price-multi",
"/api/v5/explorer/blockchain/mine",
"/api/v5/explorer/stablecoin/printing-record",
"/api/v5/explorer/blockchain/address",
"/api/v5/explorer/pool/estimated-pool-share",
"/api/v5/explorer/blockchain/hashes",
"/api/v5/explorer/block/transaction-list",
"/api/v5/explorer/blockchain/info",
"/api/v5/explorer/blockchain/block"
]
}
]
}
查询接口支持公链
查询指定接口所支持的公链
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/api-supported-chains
请求示例
GET /api/v5/explorer/api-supported-chains?apiUrl=/api/v5/explorer/blockchain/info
请求参数
参数名
类型
是否必须
描述
apiUrl
String
是
API接口的URL，例如：/api/v5/explorer/blockchain/info
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"apiSupportedChains": [
"BTC",
"BCH",
"LTC",
"DASH",
"DOGE",
"ETH",
"OKEXCHAIN",
"X1_TEST",
"BSC",
"ETC",
"POLYGON",
"AVAXC",
"ETHW",
"ETF",
"FTM",
"OPTIMISM",
"ARBITRUM",
"KLAYTN",
"ZKSYNC",
"GNOSIS",
"RONIN",
"LINEA",
"POLYGON_ZKEVM",
"APT",
"SUI",
"TRON"
]
}
]
}
返回参数
参数名
类型
描述
apiSupportedChains
Array
API接口支持的公链
API管理
查询您的浏览器API订阅信息、历史调用数据、调用消耗TOP10接口
注意：该模块只支持查询浏览器API中调用消耗>0的接口，且统计的是调用消耗点数，而不是调用次数
查询订阅信息
查询您OKlink浏览器API订阅服务的到期时间、调用消耗
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/management/subscription-info
请求示例
GET /api/v5/explorer/management/subscription-info
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"expirationTime": "1727107199000",
"totalCalls": "1000000",
"usedCalls": "6061",
"remainedCalls": "993939"
}
]
}
返回参数
参数名
类型
描述
expirationTime
String
订阅到期时间，Unix时间戳的毫秒数格式，如 1597026383085
totalCalls
String
订阅总调用量，单位为calls/year
usedCalls
String
已用调用消耗
remainedCalls
String
剩余调用消耗
查询历史调用数据
查询您OKlink浏览器API订阅的历史每日调用消耗，时间跨度最长一个月，默认返回最近一个月的调用数据
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/management/call-history
请求示例
GET /api/v5/explorer/management/call-history
请求参数
参数名
类型
是否必须
描述
startTime
String
否
开始查询的时间，Unix时间戳的毫秒数格式，如 1597026383085
endTime
String
否
结束查询的时间，Unix时间戳的毫秒数格式，如 1597026383085
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"time": "1696608000000",
"calls": "6"
},
{
"time": "1696780800000",
"calls": "369"
}
]
}
返回参数
参数名
类型
描述
time
String
调用日期，以天为维度；Unix时间戳的毫秒数格式，如 1597026383085
calls
String
当天调用消耗
查询调用消耗TOP10接口
查询您累计调用消耗最多的TOP10接口，最多返回最近一年的调用数据
每次调用消耗 0 点HTTP请求
GET /api/v5/explorer/management/top-calls
请求示例
GET /api/v5/explorer/management/top-calls
返回结果
{
"code": "0",
"msg": "",
"data": [
{
"topCalls": [
{
"rank": "1",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},
{
"rank": "2",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},
{
"rank": "3",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},
{
"rank": "4",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},{
"rank": "5",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
}
]
}
]
}
返回参数
参数名
类型
描述
topCalls
Array
调用消耗TOP10接口
> rank
String
接口调用消耗排名
> apiUrl
String
API接口的URL，例如：/api/v5/explorer/blockchain/info
> calls
String
API接口的总调用消耗
About us | Blockchain Explorer | OKLink
t us | Blockchain Explorer | OKLinkBy clicking "Accept", you agree to the storing of cookies on your device to improve your browsing experience, analyze web traffic, and enhance security.AcceptExplorerOnchain AMLWhy OKLink Onchain AMLOKLink Onchain AML is committed to crypto compliance, risk prevention with cutting-edge technologies and premium servicesKYTMonitor on-chain risks to ensure crypto asset securityKYAGet an overview of address risks to improve compliance awarenessSecurity auditConduct on-chain data analysis for dual security protectionChaintelligenceWhy OKLink ChaintelligenceOKLink Chaintelligence serves as a pioneer of blockchain security to empower enforcement and compliance teamsCompliance analysis toolsMake investigations hassle-freeSituation awarenessDetect risks through smart alertsReport & ConsultReport crypto crime and access professional guidanceAPIsOne-stop blockchain data platformOKLink is committed to making blockchain-related information accessible to everyone and enabling people to understand on-chain information in the simplest way possible. After years of development, OKLink has become a global leader in blockchain data services. It provides comprehensive data analysis of major blockchains and technical services to a wide variety of users.170+Chains1,000 TBStructured data3BAddress labelsWhat we offerOKLink ExplorerA one-stop Web3 data platform that supports monitoring tools and on-chain data analysis for major public blockchains, enabling quick access to on-chain information.Onchain AMLAn AML solution designed to empower compliance and risk management for crypto assets.ChaintelligenceA one-stop system that assists with investigations involving crypto assets and combats crypto-related crime.OpenAPIBlockchain infrastructure that supports major public blockchains, enabling professionals to quickly build blockchain-based applications.Our partnersStock ticker: 01499.HKOKG Technology Holdings LimitedListed on the HKEx, OKG Technology Holdings Limited partners with professional institutions and focuses on the application of blockchain technology and other relevant businesses.
English简体中文English繁體中文DeutschEspañolFrançaisPortuguésPусскийTiếng ViệtTürkçe한국어日本語ExplorerBitcoinEthereumOKT ChainTRONBNB ChainPolygonzkSync EraStarkNetArbitrum OneOptimismEthereumPoWSuiCosmos HubTether USDAvalanche-CLitecoinDIS CHAINFantomOKT Chain TestnetX1 TestnetEthereum ClassicSolanaAptosBeacon ChainBitcoin CashDASHDogecoinGnosisKlaytnRoninLineaPolygon zkEVMScrollBaseopBNB MainnetGoerli TestnetSepolia TestnetAmoy TestnetPolygon zkEVM TestnetMumbai TestnetCantoManta PacificOnchain AMLKYTKYASecurity auditChaintelligenceCompliance analysis toolsSituation awarenessReport & ConsultAPIsAPI plansAPI documentationAPI managementMore about OKLinkAbout usTerms of servicePrivacy policy statementAcademyOTCContact usPartnership[email protected]Partnership[email protected]WechatTelegramTwitterWeiboDiscord© 2014-2024 OKLink.com. All Rights Reserved.Beijing ICP No. 2001701
OKLink API guide | OKLink technical support | OKLink
OKLink API guide | OKLink technical support | OKLink
NAV
Onchain AML
Explorer
Change Log
Onchain AML
Explorer
Change Log
中文
Introduction
Quickstart Guide
Getting Started
Authentication and Invocation Example
Supported Chains
Rate Limit
Support
FAQ
Errors and API status
Contact Us
Blockchain General API
Chain Info
Query the list of chains
Query public chain details
Query block basic information
Query address overview
Query the best handling fee or gas fee
Query on-chain transaction information
Query the basic information of computing power
Query basic mining information
Block
Query block header details
Query block list
Query block transaction list
Batch query block transaction list
Query block height by time
Query estimated block countdown time
Query blocks validated by address
Address
Query address information
Query EVM address information
Query address active chain
Query address token balance
Query address balance details
Query address history balance
Query address transaction list information
Query address normal transaction list
Query address internal transaction list
Query address token transaction list
Batch query address entity labels
Batch query balances
Batch query token balances
Batch query normal transactions
Batch query internal transactions
Batch query token transactions
Top 100 richest addresses
Native token position ranking
Pool
Query the mining pool share
Get the mining pool hashrate ranking
Validator
Transaction
Query transaction list information
Query the list of large value transactions
Query the list of unconfirmed transactions
Query internal transaction detail
Query token transaction detail
Query transaction details
Batch query transaction detail
Batch query internal transaction
Batch query token transaction
Token
Query token list information
Query token position list details
Query token position statistics
Query token transfer details
Batch query token transaction
Query token supply history
Log
Query log by block and address
Query log by address and topic
Query log by address
Query log by transaction
Stats
Query blockchain stats
Query block stats
Query gas stats
UTXO
Query address UTXO transaction
Query address remaining UTXO
BRC20
Query inscriptions list
Query token list
Query token details
Query token position Address List
Query token transfer list
Query address balance list
Query address balance details
EVM
ETH Deflation
Query the ETH supply change overview
Query the ETH supply and burn
Query the ETH staking
Query the gas consumption
Beacon
Beacon chain basic information
Beacon chain slot list
Beacon chain validator list query
Beacon chain validator details
Staking record list of the Beacon chain
Beacon chain withdrawal record query
Beacon Chain Withdrawal Credentials Information
StarkNet
Query StarkNet block header details
Query StarkNet block transaction list
Query StarkNet address token balance
Query StarkNet address normal transaction list
Query StarkNet address token transaction list
Cosmos
Query blockchain info
Query block fills
Query block transaction list
Query validator list
Query address native token balance
Query address token balance
Query address Cosmos transaction
Query transaction list
Query token list
Query token position list
Batch query token price
Inscription
Get list of inscription tokens
Get list of addresses holding inscription tokens
Get list of inscription token transfers
Get list of inscriptions
Get list of inscription tokens held by an address
Get list of inscriptions held by an address
Get inscription token transfers by address
Get inscription token transaction details by transaction hash
Get inscription token transaction details by block
Tether
Query USDT printing/destruction list
POR
Query proof of reserves
Query proof of reserves history
Query POR address list
Query address balance details
Query asset flow of exchanges
NFT API
Chain list
NFT market overview
Collection info
Collection details
Collection NFT list
Position list
Collection floor price
NFT details
Historical transactions of the NFT
NFT trader history
Retrieve NFT offer list
Retrieve NFT listing list
The NFTs held by the address
Defi API
Query Defi lending access transactions
Query Defi lending borrowing transactions
Query Defi lending liquidation transactions
Defi APY and TVL
Supported Defi protocols and chains
Query by tokens
Query by pool address
Market Data
Supported chains
Token list
Kline
Batch query token price
Token market data
Tracker
On-chain Tools
Contract verification
Verify source code
Check source code verification result
Verify source code with hardhat
Verify proxy contract
Check proxy contract verification result
Query info for verified contract
Token authorized list
Address authorized list
Domain risk scanner
Send raw transaction
Webhook
Creat webhook task
Update webhook task
Update webhook task status
Delete webhook task
Edit webhook task addresses list
Get webhook trakcer list
Get webhook task address list
Get webhook task detail
webhook test demo
RPC API
Account
Get native token balance for an address
Get native token balance for multiple addresses
Get normal transactions by address
Get internal transactions by block height
Get internal transactions by transaction hash
Get internal transactions by block height
Get ERC-20 token transfers by address
Get ERC-721 token transfers by address
Get ERC-1155 token transfers by address
Get address-validated blocks
Get historical native token balance by address
Contract
Get ABI for verified contracts
Get source code of verified contracts
Get contract creator and creation transaction hash
Verify contract source code
Get contract verification status
Verify proxy contract
Get proxy contract verification status
Transaction
Check contract execution status
Check transaction receipt status
Block
Get block rewards
Get estimated countdown time until block validation
Get block height by timestamp
Get daily average block size
Get daily block count and rewards
Get daily block rewards
Get daily average time block time
Token
Get total supply of ERC-20 tokens by address
Get ERC-20 token balance by address
Get total ERC-20 token supply by address
Get historical ERC-20 token balance by address
Get list of addresses with ERC-20 tokens
Get ERC-20/721/1155 token information
Get ERC-20 token holdings by address
Get ERC-721 token holdings by address
Get specific ERC-721 token holdings by address
Log
Get event logs
Gas
Get gas oracle
Get daily average gas limit
Get daily total gas used
Get daily average gas price
Stats
Get the total supply of the chain's native token
Get the last price of the chain's native token
Get daily network transaction fee
Get daily new address count
Get daily network utilization
Get daily transaction count
Get historical daily price of the chain's native token
API Use and Management
Chain supported APIs
API supported chains
API management
Subscription info
Call history
Top 10 calls
Introduction
The OKLink Explorer APIs are a set of highly scalable APIs that enable Web3 developers to access the most comprehensive blockchain data across all leading L1/L2 networks. OKLink Explorer indexes block-by-block data for 40+ mainstream L1/L2 public blockchain networks, and tracks transactions and market data for 200+ blockchain networks, encompassing 7 million+ tokens and NFTs. Serving as an infrastructure layer, the OKLink Explorer APIs play a pivotal role in significantly reducing development time, infrastructure costs, and time to market.
The OKLink Explorer APIs are a collection of RESTful APIs that meet OpenAPI specifications, and they incorporate webhooks services for real-time data updates. Our APIs can help you build whatever you are creating, providing data on blocks, transactions, tokens, NFTs, markets, and more across all the leading L1/L2 blockchain networks.
The following functional data modules are what we currently support:
Blockchain General Data: Obtain fundamental data such as blockchain information, block data, address data, miner data, transaction data, and token data for various public chains.
UTXO Data Module: Obtain UTXO chain data for UTXO-based chains including BTC, BCH, LTC, DASH, DOGE, and BRC-20 data.
EVM Data Module: Obtain ETH deflation data, Beacon Chain data, StarkNet data, and more.
Cosmos Data Module: Obtain basic information, block, address, transaction, and token data for COSMOS, KAVA, and EVMOS.
Stablecoin Data Module: Obtain issuance and destruction records of USDT on TRX, BTC, and ETH.
POR Data Module: Obtain reserve details, historical reserve records, and asset details for 9 mainstream exchanges, including OKX, Binance, Bitfinex, and others.
NFT Data Module: Obtain NFT-related data, including collection data, NFT attributes, rarity, floor price, and more.
Defi Data Module: Obtain DeFi data, including DeFi lending (access, borrowing, and liquidation) transactions, APY and TVL data of different Defi projects.
Market Data Module: Obtain token market data, tick-by-tick transaction data, and more for 200+ public chains.
On-chain Tools Module: Provide on-chain tools such as contract verification, querying approved token lists, detecting domain risks, and broadcasting transactions.
Webhook Module: Used to subscribe to events occurring on addresses or on-chain, and quickly integrate them into your application.
In order to aid developers from various EVM-based blockchains in migrating to OKLink swiftly and cost-effectively, we also support interfaces that are fully compatible with Etherscan, including the following modules:
RPC API: We support data for modules including account, contract, transaction, block, token, log, Gas, and stats. All module names, action names, and other request parameters are consistent with Etherscan.
In addition, we provide APIs to query the interfaces supported by the public chain, the public chains supported by the interface, subscription information, and call statistics, which can enhance your experience and management of the OKLink Explorer APIs.
API use and management: Query the interfaces supported by the public chain, the public chains supported by the interface, and your OKLink Explorer API subscription information, historical call data, the top 10 interfaces by call consumption.
Quickstart GuideGetting Started
Quickstart guide to OKLink Explorer API. Learn how to create an account, create API keys, authenticate, and get ready to make your first API request to start building!
Visit the OKLink official website and register using your email or phone number.
After successful registration, log in using your email or phone number.
Go to the API management page and create your API keys.
With your API keys, start your on-chain data exploration journey using the OKLink Explorer APIs!
Authentication and Invocation Example
An API key is the unique identifier used for accessing API endpoints. All OpenAPI endpoints require API key authentication for access.
You can create up to 5 API keys based on your needs. For your data security, please don't share the keys with anyone.
Root URL for API:
https://www.oklink.com/
How to use API Key:
For each API request, you need to add your API key in the Http Request Headers ("Ok-Access-Key", followed by your API key).
Example of API interface invocation:
We provide example code snippets in different programming languages, including cURL, Python, JavaScript - jQuery, Go, Java - OkHttp, PHP, and Rust to help you quickly get started.
cURL
curl -X GET 'https://www.oklink.com/api/v5/explorer/blockchain/summary' \
--header 'Ok-Access-Key:Your APIkey' \
--header 'Content-type: application/json'
Python
import requests
url = "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH"
payload = ""
headers = {
# apiKey
'Ok-Access-Key': 'apiKey'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
JavaScript - jQuery
var settings = {
"url": "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH",
"method": "GET",
"timeout": 0,
"headers": {
"Accept": "*/*",
"Ok-Access-Key": "apiKey",
},
};
$.ajax(settings).done(function (response) {
console.log(response);
});
Go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH"
method := "GET"
apiKey := "apiKey"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Ok-Access-Key", apiKey)
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Java - OkHttp
package com.oklink.demo;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class JavaDemo {
public static void main(String[] args) {
try {
String url = "https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH";
String apiKey = "apiKey";
OkHttpClient client = new OkHttpClient.Builder().build();
Request request = new Request.Builder()
.url(url)
.addHeader("Ok-Access-Key", apiKey)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}catch (IOException e){
e.printStackTrace();
}
}
}
PHP
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
$headers = array();
$headers[] = 'Ok-Access-Key: apiKey';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
}
curl_close($ch);
Rust
extern crate reqwest;
use reqwest::header;
fn main() -> Result<(), Box
let mut headers = header::HeaderMap::new();
headers.insert("Ok-Access-Key", "apiKey".parse().unwrap());
let res = reqwest::Client::new()
.get("https://www.oklink.com/api/v5/explorer/blockchain/summary?chainShortName=ETH")
.headers(headers)
.send()?
.text()?;
println!("{}", res);
Ok(())
}
Supported Chains
The OKLink Explorer APIs currently support a total of 42 mainstream L1/L2 chains with block-by-block data:
Chain Full Name
Chain Short Name
Chain ID
Bitcoin
BTC
0
Bitcoin Cash
BCH
145
Litecoin
LTC
2
DASH
DASH
5
Dogecoin
DOGE
3
Ethereum
ETH
1
OKT Chain
OKTC
66
BNB Chain
BSC
56
Ethereum Classic
ETC
61
Polygon
POLYGON
137
Avalanche-C
AVAXC
43114
EthereumPoW
ETHW
10001
Dis Chain (EthereumFair)
DIS (ETHF)
513100
Fantom
FTM
250
Canto
CANTO
70000014
OP Mainnet
OP
10
Arbitrum One
ARBITRUM
42161
KLAYTN
KLAYTN
8217
zkSync Era
ZKSYNC
324
Gnosis
GNOSIS
100
Ronin
RONIN
2020
LINEA
LINEA
59144
Beacon
BEACON
70000040
StarkNet
STARKNET
9004
Polygon zkEVM
POLYGON_ZKEVM
1101
Base
BASE
8453
Scroll
SCROLL
534352
Omega
OMEGA
408
Manta Pacific
MANTA
169
opBNB Mainnet
OPBNB
204
X1 Test
X1_TEST
19500
Sepolia Testnet
SEPOLIA_TESTNET
11155111
Goerli Testnet
GOERLI_TESTNET
70000030
Mumbai Testnet
MUMBAI_TESTNET
80001
Amoy Testnet
AMOY_TESTNET
80002
Polygon zkEVM Testnet
POLYGON_ZKEVM_TESTNET
1442
Aptos
APT
637
Sui
SUI
784
TRON
TRON
195
Cosmos Hub
COSMOS
118
Kava
KAVA
459
Evmos
EVMOS
710
For token price data, we support 200+ public chains.
As part of ongoing enhancements, the OKLink Explorer APIs will be expanded to include support for additional public blockchains. If the blockchain you wish to integrate isn't currently listed, please reach out to us via email at [email protected]. We'll assess your request and proceed accordingly.
Rate Limit
We've put rate limits on API calls to prevent API overload, ensuring optimal processing speed, response time, and enhancing the overall security of both OKLink Explorer APIs and the retrieved data. Different access limits apply to free and paid users:
For free users, the limit is 5 requests per second per account.
For paid users, the limit is 80 requests per second per account.
To learn more about paid subscription plans, log in to your account and go to the API management page > My subscription > Check out more API plans. Here, you can learn the specific details of the available plans.
If you receive a JSON response with "errorcode": "50011", it means you have reached the API rate limit.
SupportFAQ
1. How many public chains are supported by the OKLink Explorer APIs?
The OKLink Explorer APIs currently support a total of 42 mainstream L1 and L2 chains with block-by-block data. You can check the list here.
For token price data, the OKLink Explorer APIs currently support over 200 public chains, you can get the list of public chains supported in this module by Supported chains.
We are expanding our support to include more public blockchains. If the blockchain you wish to integrate isn't currently listed, please reach out to us via email at [email protected]. We'll assess your request and proceed accordingly.
2. Do the OKLink Explorer APIs have an SDK?
We provide invocation examples in different programming languages, including cURL, Python, JavaScript —jQuery, Go, Java — OkHttp, PHP, and Rust to help you get started quickly. You can find more details here.
3. What is the OKLink Explorer APIs pricing scheme?
For pricing details, please log in and go to the API management page > My subscription > Check out more API plans. (You can check out specific plans in the pop-up window.)
4. How can I check which public chains are supported by different APIs?
You can find the supported public chains for each API endpoint in the API descriptions or by Query chain supported APIs and Query API supported chains.
5. How can I view my API usage?
You can check your total calls, remaining calls, and expiration date on the API management page > My subscription.
Additionally, you can check the above data through the Subscription info. This link can also be used to set up your expiration monitoring reminder.
Furthermore, in this module, you can use the Call history and Top 10 calls to check your historical call consumption and the most consumed interfaces, which enables you to personalize API interface management.
Errors and API status
The server responds to a user's request by issuing HTTP codes and error codes when the request is made to the server. Please refer to the table below to further understand the error codes when indicating the success or failure of an API call.
Response Example
{
"code": "50038",
"msg": "This chain does not currently support.",
"data": []
}
Here are the error codes and messages we used:
General Class
Error Message
HTTP Status Code
Error Code
Succeeded.
200
0
Body can not be empty.
400
50000
Service temporarily unavailable, please try again later.
503
50001
Json data format error.
400
50002
Endpoint request timeout (does not mean that the request was successful or failed, please check the request result).
400
50004
API is offline or unavailable.
410
50005
Invalid Content_Type, please use "application/json" format.
400
50006
Account blocked.
200
50007
User does not exist.
200
50008
Account is suspended due to ongoing liquidation.
200
50009
User ID can not be empty.
200
50010
Requests too frequent.
429
50011
Account status invalid.
200
50012
System is busy, please try again later.
200
50013
Parameter {0} can not be empty.
400
50014
Either parameter {0} or {1} is required.
400
50015
Parameter {0} does not match parameter {1}.
400
50016
Parameter {0} and {1} can not exist at the same time.
200
50024
Parameter {0} count exceeds the limit {1}.
200
50025
System error.
500
50026
No permission to use this API. You need to upgrade your account's payment level.
403
50030
Parameter %s error.
400
50036
Token does not exist.
200
50037
This chain does not currently support.
200
50038
This alert has no history of processing.
200
50039
No data is displayed for this block height.
200
50040
The historical balance of this token is not currently supported.
200
50041
This token protocol type does not support scanning.
200
50042
Your account behavior triggered risk control, and the API function has been frozen. Please contact us by email [email protected]
200
50043
Data already exists.
400
50044
Client operation error.
400
50045
API Class
Error Message
HTTP Status Code
Error Code
API frozen, please contact customer service.
400
50100
Timestamp request expired.
401
50102
Request header "OK_ACCESS_KEY" can not be empty.
401
50103
Request header "OK_ACCESS_PASSPHRASE" can not be empty.
401
50104
Request header "OK_ACCESS_PASSPHRASE" incorrect.
401
50105
Request header "OK_ACCESS_SIGN" can not be empty.
401
50106
Request header "OK_ACCESS_TIMESTAMP" can not be empty.
401
50107
Exchange ID does not exist.
401
50108
Exchange domain does not exist.
401
50109
Invalid IP.
401
50110
Invalid OK_ACCESS_KEY.
401
50111
Invalid OK_ACCESS_TIMESTAMP.
401
50112
Invalid signature.
401
50113
Invalid authorization.
401
50114
Invalid request method.
405
50115
Exceeds the range of historical data queries.
400
50117
Trade Class
Error Message
HTTP Status code
Error Code
Parameter {0} error.
404
51000
The outputAddress you filled in was not found in this transaction.
200
51001
The outputAddress specified by this index does not exist in this transaction.
200
51002
Detail information with this transaction hash has not been found on the blockchain network, and risk status is pending for this transaction.
200
51003
Contact Us
If you have any questions regarding the OKLink Explorer APIs, please contact us via:
Official Email: [email protected]
Telegram: https://t.me/OKLinkAPI
OKLink reserves the final right to interpret the API tools.
Blockchain General API
The Blockchain General API module interface retrieve fundamental data such as blockchain information, block data, address data, pool data, transaction data, token data, and more for various public blockchains.
Chain Info
These endpoints from this module retrieve data for supported networks, including network details, optimal gas fees, number of addresses, and transaction counts.
Query the list of chains
This endpoint retrieves the list of crypto networks supported by Network module.
HTTP Request
GET /api/v5/explorer/blockchain/summary
Consumption per query 0
Request Example
GET /api/v5/explorer/blockchain/summary
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
No
The blockchain network symbol, e.g. BTC. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"lastHeight": "812740",
"lastBlockTime": "1697622753000",
"circulatingSupply": "19517050",
"circulatingSupplyProportion": "0.9294",
"transactions": "913669129"
},
{
"chainFullName": "Bitcoin Cash",
"chainShortName": "BCH",
"symbol": "BCH",
"lastHeight": "815586",
"lastBlockTime": "1697622060000",
"circulatingSupply": "19534862.5",
"circulatingSupplyProportion": "0.9302",
"transactions": "376125240"
},
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"symbol": "ETH",
"lastHeight": "18376498",
"lastBlockTime": "1697623103000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "2127824775"
},
{
"chainFullName": "OKT Chain",
"chainShortName": "OKTC",
"symbol": "OKT",
"lastHeight": "22989718",
"lastBlockTime": "1697623102000",
"circulatingSupply": "20077976.25",
"circulatingSupplyProportion": "0.9560941071428571",
"transactions": "167592112"
},
{
"chainFullName": "X1_TEST",
"chainShortName": "X1_TEST",
"symbol": "OKB",
"lastHeight": "26938",
"lastBlockTime": "1700031881000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "26801.0"
},
{
"chainFullName": "BNB Chain",
"chainShortName": "BSC",
"symbol": "BNB",
"lastHeight": "32707931",
"lastBlockTime": "1697623106000",
"circulatingSupply": "151705624.6",
"circulatingSupplyProportion": "1",
"transactions": "3584346166"
},
{
"chainFullName": "Ethereum Classic",
"chainShortName": "ETC",
"symbol": "ETC",
"lastHeight": "18541162",
"lastBlockTime": "1697623087000",
"circulatingSupply": "143564715.29",
"circulatingSupplyProportion": "1",
"transactions": "115483536"
},
{
"chainFullName": "Litecoin",
"chainShortName": "LTC",
"symbol": "LTC",
"lastHeight": "2564279",
"lastBlockTime": "1697622845000",
"circulatingSupply": "73774507.97",
"circulatingSupplyProportion": "0.8783",
"transactions": "181126166"
},
{
"chainFullName": "DASH",
"chainShortName": "DASH",
"symbol": "DASH",
"lastHeight": "1956330",
"lastBlockTime": "1697623059000",
"circulatingSupply": "11499070.93",
"circulatingSupplyProportion": "0.6087",
"transactions": "49535771"
},
{
"chainFullName": "TRON",
"chainShortName": "TRON",
"symbol": "TRX",
"lastHeight": "55663883",
"lastBlockTime": "1697623107000",
"circulatingSupply": "90580932915.58",
"circulatingSupplyProportion": "1",
"transactions": "6.56881736E+9"
},
{
"chainFullName": "Polygon",
"chainShortName": "POLYGON",
"symbol": "MATIC",
"lastHeight": "48859754",
"lastBlockTime": "1697623104000",
"circulatingSupply": "9299803030.72",
"circulatingSupplyProportion": "",
"transactions": "3071306297"
},
{
"chainFullName": "Avalanche-C",
"chainShortName": "AVAXC",
"symbol": "AVAX",
"lastHeight": "36601091",
"lastBlockTime": "1697623102000",
"circulatingSupply": "354811879.38",
"circulatingSupplyProportion": "",
"transactions": "257890662"
},
{
"chainFullName": "Aptos",
"chainShortName": "APT",
"symbol": "APT",
"lastHeight": "104439850",
"lastBlockTime": "1697623100438",
"circulatingSupply": "245335823.53",
"circulatingSupplyProportion": "0",
"transactions": "289582063"
},
{
"chainFullName": "EthereumPoW",
"chainShortName": "ETHW",
"symbol": "ETHW",
"lastHeight": "18110977",
"lastBlockTime": "1697623090000",
"circulatingSupply": "107818999.05",
"circulatingSupplyProportion": "1",
"transactions": "1688548041"
},
{
"chainFullName": "DIS CHAIN",
"chainShortName": "DIS",
"symbol": "DIS",
"lastHeight": "18144023",
"lastBlockTime": "1697623083000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "1660726868"
},
{
"chainFullName": "Fantom",
"chainShortName": "FTM",
"symbol": "FTM",
"lastHeight": "69463847",
"lastBlockTime": "1697623104000",
"circulatingSupply": "2803634835.53",
"circulatingSupplyProportion": "0.883035",
"transactions": "446638938"
},
{
"chainFullName": "OP Mainnet",
"chainShortName": "OP",
"symbol": "ETH",
"lastHeight": "111012162",
"lastBlockTime": "1697623101000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "168183124"
},
{
"chainFullName": "Arbitrum One",
"chainShortName": "ARBITRUM",
"symbol": "ETH",
"lastHeight": "141661625",
"lastBlockTime": "1697623108000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "373814666"
},
{
"chainFullName": "Dogecoin",
"chainShortName": "DOGE",
"symbol": "DOGE",
"lastHeight": "4928818",
"lastBlockTime": "1697622845000",
"circulatingSupply": "141459666383.71",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "Sui",
"chainShortName": "SUI",
"symbol": "SUI",
"lastHeight": "15891997",
"lastBlockTime": "1697623099245",
"circulatingSupply": "860392959.69",
"circulatingSupplyProportion": "0.08603929596900001",
"transactions": "821855364"
},
{
"chainFullName": "KLAYTN",
"chainShortName": "KLAYTN",
"symbol": "KLAY",
"lastHeight": "135657958",
"lastBlockTime": "1697623108000",
"circulatingSupply": "3234951226.08",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "zkSync Era",
"chainShortName": "ZKSYNC",
"symbol": "ETH",
"lastHeight": "16684962",
"lastBlockTime": "1697623105000",
"circulatingSupply": "120262264.05",
"circulatingSupplyProportion": "1",
"transactions": "140220679"
},
{
"chainFullName": "Gnosis",
"chainShortName": "GNOSIS",
"symbol": "ETH",
"lastHeight": "30516833",
"lastBlockTime": "1697623100000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "Ronin",
"chainShortName": "RONIN",
"symbol": "RONIN",
"lastHeight": "28598542",
"lastBlockTime": "1697623106000",
"circulatingSupply": "251442247.22",
"circulatingSupplyProportion": "",
"transactions": ""
},
{
"chainFullName": "LINEA",
"chainShortName": "LINEA",
"symbol": "LINEA",
"lastHeight": "659835",
"lastBlockTime": "1697623102000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "2127828200"
},
{
"chainFullName": "POLYGON_ZKEVM",
"chainShortName": "POLYGON_ZKEVM",
"symbol": "ETH",
"lastHeight": "6371025",
"lastBlockTime": "1697623096000",
"circulatingSupply": "",
"circulatingSupplyProportion": "",
"transactions": "5236188.0"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
The native token symbol, e.g. btc.
lastHeight
String
The latest block height
lastBlockTime
String
The Unix timestamp for when the latest block was validated, in milliseconds format, e.g., 1597026383085.
circulatingSupply
String
Circulating supply
circulatingSupplyProportion
String
The ratio of the circulating quantity to the total supply, displayed in decimals, e.g.: 0.85 equals 85%
transactions
String
Total number of transactions
Query public chain details
Get the details of the public chains currently supported by OKLink, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/blockchain/info
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/info?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"rank": "1",
"mineable": true,
"algorithm": "SHA-256",
"consensus": "PoW",
"diffEstimation": "65.70T",
"currentDiff": "61.03T",
"diffAdjustTime": "1698582329000",
"circulatingSupply": "19517050",
"totalSupply": "21000000",
"tps": "3.16",
"lastHeight": "812742",
"lastBlockTime": "1697623175000",
"issueDate": "1231006505000"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
rank
String
Rank
mineable
Bol
Whether to support mining true false
algorithm
String
The core algorithm, e.g. SHA-256
consensus
String
Consensus algorithm, e.g. PoW
diffEstimation
String
Prediction of next mining difficulty, BTC unit: T
currentDiff
String
The current mining difficulty of the whole network
diffAdjustTime
String
The next mining difficulty adjustment time
circulatingSupply
String
Circulating supply
totalSupply
String
Max total supply
tps
String
Transactions per second
lastHeight
String
The latest block height
lastBlockTime
String
The Unix timestamp for when the latest block was validated, in milliseconds format, e.g., 1597026383085.
issueDate
String
Issue date; Unix timestamp format in milliseconds, e.g. 1597026383085
Query block basic information
Obtain the basic information of the detailed blocks of the chains, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/blockchain/block
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/block?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"lastHeight": "812742",
"firstExchangeHistoricalTime": "1231006505000",
"firstBlockTime": "1231006505000",
"firstBlockHeight": "0",
"avgBlockInterval": "573.2926587301587",
"avgBlockSize24h": "1565974.456375839",
"avgBlockSize24hPercent": "-0.10001506153712443",
"mediaBlockSize": "1575044.942857143",
"halveTime": "1712805881000"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
lastHeight
String
The latest block height
firstExchangeHistoricalTime
String
First The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
firstBlockTime
String
First block time; Unix timestamp format in milliseconds, e.g. 1597026383085
firstBlockHeight
String
First block height
avgBlockInterval
String
Average block time (nearly a week), ETH unit is s
avgBlockSize24h
String
Average block size (24 hours)
avgBlockSize24hPercent
String
Average block size change
mediaBlockSize
String
Median block size (last week)
halveTime
String
halving time;Unix timestamp format in milliseconds, e.g. 1597026383085
Query address overview
Get the basic information of the currency Holder addresses of the public chains, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO.
HTTP Request
GET /api/v5/explorer/blockchain/address
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/address?chainShortName=eth
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"symbol": "ETH",
"validAddressCount": "107721078",
"newAddressCount24h": "47093",
"totalAddresses": "305937721",
"newTotalAddresses24h": "109599",
"contractAddresses": "64007840",
"newContractAddresses24h": "19582",
"externalAddresses": "241929881",
"newExternalAddresses24h": "90017",
"activeAddresses": "714816",
"newActiveAddresses": "19728"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
validAddressCount
String
The number of addresses holding the native token of the blockchain.
newAddressCount24h
String
Increment / decrement of the past 24-hour period comparing to the previous one of Holder addresses
totalAddresses
String
Total number of addresses on the blockchain
newTotalAddresses24h
String
Increment / decrement of the past 24-hour period comparing to the previous one of total addresses
contractAddresses
String
Contract addresses
newContractAddresses24h
String
Increment / decrement of the past 24-hour period comparing to the previous one of contract addresses
externalAddresses
String
External addresses
newExternalAddresses24h
String
Increment / decrement of the past 24-hour period comparing to the previous one of external addresses
activeAddresses
String
Active addresses
newActiveAddresses
String
Increment / decrement of the past 24-hour period comparing to the previous one of active addresses
Query the best handling fee or gas fee
Get the basic information of the gas fee of the public chains, the supported chains are BTC, BCH, LTC, DASH, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, GNOSIS, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OPBNB, MANTA, CANTO, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/blockchain/fee
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/fee?chainShortName=eth
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"symbol": "ETH",
"bestTransactionFee": "",
"bestTransactionFeeSat": "",
"recommendedGasPrice": "34.843994267",
"rapidGasPrice": "35.043994267",
"standardGasPrice": "34.793994267",
"slowGasPrice": "34.743994267",
"baseFee": "34.057663431",
"gasUsedRatio": "0.4781578,0.420984233333333333,0.5279502,0.485460466666666667,0.434564833333333333"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
bestTransactionFee
String
Best transaction fee
bestTransactionFeeSat
String
Best transaction fee (Sat)
recommendedGasPrice
String
Recommended gas fee. ETH unit: Gwei
rapidGasPrice
String
Extremely fast Gas fee, estimated transaction confirmation within 15s
standardGasPrice
String
General Gas fee, estimated 3 minutes to complete the transaction confirmation
slowGasPrice
String
Slow Gas fee, estimated greater than 15 minutes to complete transaction confirmation
baseFee
String
Base fee per Gas
gasUsedRatio
String
Gas used ratio of the latest 5 blocks(i.e., Gas consumed / Gas limit), separated by a comma
Query on-chain transaction information
Get the basic transaction information on the public chains, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OPBNB, MANTA, CANTO.
HTTP Request
GET /api/v5/explorer/blockchain/transaction
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/transaction?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g：BTC、ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"pendingTransactionCount": "22597",
"transactionValue24h": "34410716804875",
"totalTransactionCount": "913670420",
"tranRate": "3.16",
"avgTransactionCount24h": "1936.8523489932886",
"avgTransactionCount24hPercent": "0.0211",
"pendingTransactionSize": "164205183"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
pendingTransactionCount
String
Pending transaction count
transactionValue24h
String
Transaction value 24h
totalTransactionCount
String
Total transaction count
tranRate
String
The average TPS for 50 blocks
avgTransactionCount24h
String
Avg number of transactions in 24h
avgTransactionCount24hPercent
String
Changing percent of the avg number of transactions in 24h
pendingTransactionSize
String
Pending transaction size
Query the basic information of computing power
Get the basic information of the public chain computing power, the supported chains are BTC, BCH, LTC, DASH, ETH, ETC.
HTTP Request
GET /api/v5/explorer/blockchain/hashes
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/hashes?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"hashRate": "437.58EH",
"hashRateChange24h": "-0.0074"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
hashrate
String
The total network hash rate in the past week
hashrateChange24h
String
The 24-hour rise and fall of the computing power of the entire network, For example: a positive number means an increase; 0.02, which means an increase of 2% For example: a negative number means a decline: -0.02, which means a decline of 2%
Query basic mining information
Obtain the basic mining information of the public chains, the supported chains are BTC, BCH, LTC, DASH, ETH.
HTTP Request
GET /api/v5/explorer/blockchain/mine
Consumption per query 1
Request Example
GET /api/v5/explorer/blockchain/mine?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"avgMineReward24h": "6.37771195",
"minerIncomePerUnit": "0.000002082802405598016",
"minerIncomePerUnitCoin": "0.000002060056106572138"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Chain native tokens, e.g. btc
avgMineReward24h
String
24-hour average block reward
minerIncomePerUnit
String
Revenue per unit of computing power
minerIncomePerUnitCoin
String
The number of coins earned per unit of computing power
Block
These endpoints from this module retrieve data for a specific block such as block details, block lists, transaction lists within blocks and historical block heights.
Query block header details
Get the block details of the public chains, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/block/block-fills
Consumption per query 1
Request Example
GET /api/v5/explorer/block/block-fills?chainShortName=eth&height=735732
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
height
String
Yes
Block height
netWork
String
No
The abbreviated name of the blockchain network, required for USDT
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"hash": "0x545f02750b8fffe8354140b8ec2414fd72fa34a5ca93c58fe25f94c07ebb44ff",
"height": "735732",
"validator": "NanoPool",
"blockTime": "1450873643000",
"txnCount": "4",
"amount": "12.950329114",
"blockSize": "1509",
"mineReward": "5.012841864",
"totalFee": "0.012841864",
"feeSymbol": "ETH",
"ommerBlock": "0",
"merkleRootHash": "0xcfb7cc8bc5f11bb9c3e05a9fec1a17b63b0899a75624038a762ce800bda588b3",
"gasUsed": "249382",
"gasLimit": "3141592",
"gasAvgPrice": "0.000000051494751025",
"state": "",
"burnt": "",
"netWork": "",
"txnInternal": "0",
"miner": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5",
"difficuity": "8518354788907",
"nonce": "e246c1795e5cc38f",
"tips": "",
"confirm": "17640838",
"baseFeePerGas": ""
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
hash
String
Block hash
height
String
Block height
validator
String
Validator
blockTime
String
The Unix timestamp for when the block was validated, in milliseconds format, e.g., 1597026383085.
amount
String
Amount of the transaction
txnCount
String
The number of normal transactions contained in the block
txnInternal
String
The number of internal transactions contained in the block
blockSize
String
Block size, measured in bytes
mineReward
String
Block reward, block revenue is equal to mineReward + totalFee
totalFee
String
The sum of all fees in the block, in the currency of the fee
feeSymbol
String
Fee currency
ommerBlock
String
The number of ommer blocks
merkleRootHash
String
Merkle root hash
gasUsed
String
Actual amount of gas used
gasLimit
String
Gas limit
gasAvgPrice
String
Gas avg price, in ETH
state
String
Different block states:"pending" indicates that confirmation is currently in progress"done" indicates completion.
burnt
String
Destruction fee amount
netWork
String
The blockchain network, displaying the "chainFullName" of the corresponding public chain, e.g., TRON.
miner
String
The miner's address Hash that packs the block
difficulty
String
Difficulty when packing the block
nonce
String
In PoW blockchains, nonce is used to describe mining difficulty
confirm
String
Confirmed block count
tips
String
The maximum gas price that the transaction initiator is willing to pay to prioritize their transaction for inclusion in a block by miners
baseFeePerGas
String
Basic fee per Gas, in ETH
Query block list
Get the block list information of the public chains, and only return nearly 10,000 block list data, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/block/block-list
Consumption per query 1
Request Example
GET /api/v5/explorer/block/block-list?chainShortName=eth&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
height
String
No
Height
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"blockList": [
{
"hash": "0x68888279454c3a5e20b7f1b814d9b09c42ba13b6ee6e773a8d78dcc0a4bbcaf0",
"height": "18376580",
"validator": "unknown",
"blockTime": "1697624087000",
"txnCount": "134",
"blockSize": "159565",
"mineReward": "0.022295016661867617",
"totalFee": "0.09549692314174378",
"feeSymbol": "ETH",
"avgFee": "0.0007",
"ommerBlock": "0",
"gasUsed": "11074005",
"gasLimit": "30000000",
"gasAvgPrice": "0.000000008623521765",
"state": "",
"burnt": "0.07320190647987616",
"netWork": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
blockList
Array
Block list
> hash
String
Block hash
> height
String
Block height
> validator
String
Validator
> blockTime
String
The Unix timestamp for when the block was validated, in milliseconds format, e.g., 1597026383085.
> txnCount
String
The number of transactions contained in the block
> blockSize
String
Block size. The unit is: bytes
> mineReward
String
Block reward, block revenue is equal to mineReward + totalFee
> totalFee
String
The sum of all fees in the block, in the currency of the fee
> feeSymbol
String
Fee currency
> avgFee
String
Average transaction fee
> ommerBlock
String
The number of ommer blocks
> gasUsed
String
Actual amount of gas used
> gasLimit
String
Gas limit
> gasAvgPrice
String
Gas avg price
> state
String
Different block states:"pending" indicates that confirmation is currently in progress"done" indicates completion.
> burnt
String
Destruction fee amount
> netWork
String
The blockchain network, displaying the "chainFullName" of the corresponding public chain, e.g., TRON.
Query block transaction list
Get the list of transactions in a block under the blockchain, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/block/transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/block/transaction-list?chainShortName=eth&height=18126560&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
height
String
Yes
Height
protocolType
String
No
Protocol type transaction: normal transaction internal: internal transaction token_20 token_721 token_1155 token_10 The default is transaction
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "635",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"blockList": [
{
"txid": "0x5a597e627d67a4e9daa9b710bf217c6690a2ac09521b45ffbb0b82b0f6d84245",
"methodId": "0x771d503f",
"blockHash": "0xadaed44b8d75332a8627a490cdd49e8aab227c901859f7918aea2b7f6d54e297",
"height": "18126560",
"transactionTime": "1694598095000",
"from": "0x104da4efb22a7e560e6df9c813e5eb54ca038737",
"isFromContract": false,
"isToContract": true,
"to": "0x51c72848c68a965f66fa7a88855f9f7784502a7f",
"amount": "0",
"transactionSymbol": "ETH",
"txfee": "0.004454715411444375",
"state": "success",
"tokenId": "",
"tokenContractAddress": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
blockList
Array
Block transaction list
> txid
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> to
String
Recipient address
> amount
String
Number of transactions
> transactionSymbol
String
Symbol
> txfee
String
Transaction Fees
> state
String
Transaction status success fail pending
> tokenContractAddress
String
Token Contract Address
> tokenId
String
NFT token Id
> methodId
String
Method ID
Batch query block transaction list
Batch query the transaction list for certain blocks on a blockchain, and only return the latest 10,000 transaction data. The supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
HTTP Request
GET /api/v5/explorer/block/transaction-list-multi
Consumption per query 3
Request Example
GET /api/v5/explorer/block/transaction-list-multi?chainShortName=eth&startBlockHeight=18809970&endBlockHeight=18809972&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
startBlockHeight
String
Yes
The starting block height
endBlockHeight
String
Yes
The end block height
protocolType
String
No
Protocol type transaction: normal transaction internal: internal transaction token_20 token_721 token_1155 The default is transaction
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "724",
"transactionList": [
{
"height": "18809972",
"txId": "0xb86c039478b97be1e4de569ffa227dd57c0aeb793955328d7d17674f9ec0cee1",
"blockHash": "0x5248621464bded6029e20a0b2da1e103bb31bc4048d8623619b82eb6c2da25ce",
"transactionTime": "1702867319000",
"from": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
"isFromContract": false,
"isToContract": false,
"to": "0x5c8d0eed35a9e632bb8c0abe4662b6ab3326850b",
"amount": "0.150851832900380503",
"transactionSymbol": "ETH",
"txFee": "0.000926296864164",
"state": "success",
"tokenId": "",
"tokenContractAddress": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
transactionList
Array
Block transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> to
String
Recipient address
> amount
String
Number of transactions
> transactionSymbol
String
Symbol
> txFee
String
Transaction Fees
> state
String
Transaction status success fail pending
> tokenContractAddress
String
Token Contract Address
> tokenId
String
NFT token Id
> methodId
String
Method ID
Query block height by time
Query the block height that was validated at a certain timestamp, the supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, TRON, OKTC, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
HTTP Request
GET /api/v5/explorer/block/block-height-by-time
Consumption per query 1
Request Example
GET /api/v5/explorer/block/block-height-by-time?chainShortName=eth&time=1702366480000
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
time
String
Yes
The specific time you want to query, Unix timestamp in millisecond format, e.g. 1597026383085
closest
String
Yes
before: the most recent block that was validated before (including) the given timestamp after: the most recent block that was validated after (including) the given timestamp The default ia before
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"height": "18768649",
"blockTime": "1702366475000"
}
]
}
Response Parameters
Parameter
Type
Description
height
String
Block height
blockTime
String
The actual time when the block was validated, Unix timestamp in millisecond format, e.g. 1597026383085
Query estimated block countdown time
Query the estimated time remaining, in seconds, until a certain block is validated, the supported chains are ETH, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, GNOSIS
HTTP Request
GET /api/v5/explorer/block/block-count-down
Consumption per query 1
Request Example
GET /api/v5/explorer/block/block-count-down?chainShortName=eth&countDownBlockHeight=18812000
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
countDownBlockHeight
String
Yes
The specific block height you want to query
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"currentBlockHeight": "18810144",
"countDownBlockHeight": "18812000",
"remainingBlock": "1856",
"estimateTime": "22405.632"
}
]
}
Response Parameters
Parameter
Type
Description
currentBlockHeight
String
The current latest block height
countDownBlockHeight
String
The block height you want to query
remainingBlock
String
Remaining number of blocks
estimateTime
String
Estimated remaining time for block verification to be completed, the unit is second
Query blocks validated by address
Get the list of blocks validated by an address, and only return the latest 10,000 data. The supported chains are ETH, BSC, POLYGON
HTTP Request
GET /api/v5/explorer/block/mined-block-list
Consumption per query 1
Request Example
GET /api/v5/explorer/block/mined-block-list?chainShortName=eth&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Validator address
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"blockList": [
{
"height": "18811110",
"blockTime": "1702881083000",
"mineReward": "0.028655772120729006"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
blockList
Array
The block list validated by the address
> height
String
Block height
> blockTime
String
Block time; Unix timestamp format in milliseconds, e.g. 1597026383085
> blockReward
String
Block reward, the unit is the native token of the chain
Address
These endpoints from this module retrieve the blockchain address data such as address balance, top whale address, and address details.
Query address information
To obtain the balance information of an address, you can obtain information such as the balance of the public chain address and the balance of the supported public chain smart contract tokens. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/address/address-summary
Consumption per query 1
Request Example
GET /api/v5/explorer/address/address-summary?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"address": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
"contractAddress": "",
"balance": "0",
"balanceSymbol": "ETH",
"transactionCount": "3",
"verifying": "0",
"sendAmount": "0.00144563982877912",
"receiveAmount": "0.00144563982877912",
"tokenAmount": "0",
"totalTokenValue": "",
"createContractAddress": "",
"createContractTransactionHash": "",
"firstTransactionTime": "1649936533000",
"lastTransactionTime": "1673174795000",
"token": "",
"bandwidth": "",
"energy": "",
"votingRights": "",
"unclaimedVotingRewards": "",
"isAaAddress": false
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
address
String
Ordinary address
contractAddress
String
Smart contract address
isProducerAddress
Bol
Whether it is the contract validator address true false
balance
String
Native token balance of the address
balanceSymbol
String
The currency symbol for the native token balance
transactionCount
String
Number of transactions for this address
verifying
String
Amount under confirmation
sendAmount
String
Send amount
receiveAmount
String
Received amount
tokenAmount
String
Total types of tokens
totalTokenValue
String
Total token value
createContractAddress
String
Contract creator
createContractTransactionHash
String
The transaction hash that created the smart contract
firstTransactionTime
String
The time when the first transaction occurred at this address
lastTransactionTime
String
The last transaction time for this address
token
String
Corresponding token
bandwidth
String
As one of the resources in the TRON network, users need to consume bandwidth for sending transactions. Each user is eligible for a certain amount of free bandwidth every day, and also obtain extra bandwidth by staking TRX（Applicable to TRON）
energy
String
The execution of each instruction of smart contract consume a certain amount of energy while running, so contracts of different complexity consume different amounts of energy. When the contract is executed, energy is calculated and deducted according to instruction one by one. When the available energy of the account is insufficient, TRX needs to be burned to pay for the corresponding energy（Applicable to TRON）
votingRights
String
Each user in the TRON network is eligible to participate in the elections by staking their TRX to claim for the voting rights. Inversely, withdrawing their TRX under these processes would loss the voting rights（Applicable to TRON）
unclaimedVotingRewards
String
During the validator election, uses can received certain rewards if successfully voted for the validators. After each round of elections,the voting rewards distributed by validators need to be collected manually（Applicable to TRON）
isAaAddress
Bol
Whether it is an AA address
Query EVM address information
Get the information of an address, you can get the detail information such as balance, token balance, number of contract calls, contract corresponding tokens. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/information-evm
Request Example
GET /api/v5/explorer/address/information-evm?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"balance": "0.000000000000000001",
"balanceSymbol": "ETH",
"transactionCount": "183337245",
"firstTransactionTime": "1511831234000",
"lastTransactionTime": "1697624363000",
"contractAddress": true,
"createContractAddress": "0x36928500bc1dcd7af6a2b4008875cc336b927d57",
"createContractTransactionHash": "0x2f1c5c2b44f771e942a8506148e256f94f1a464babc938ae0690c6e34cd79190",
"contractCorrespondingToken": "USDT",
"contractCalls": "5132287",
"contractCallingAddresses": "897673"
}
]
}
Response Parameters
Parameter
Type
Description
address
String
Ordinary address
balance
String
Native token balance of the address
balanceSymbol
String
Symbol of native token
transactionCount
String
The transaction amount of the address
firstTransactionTime
String
The time when the first transaction occurred of this address
lastTransactionTime
String
The last transaction time of this address
contractAddress
Bol
Whether it is the contract validator address
createContractAddress
String
Contract creator address
createContractTransactionHash
String
The transaction hash that created the smart contract
contractCorrespondingToken
String
Corresponding token
contractCalls
String
The number of times the contract was called in the last 30 days. External and internal transactions are counted.
contractCallingAddresses
String
The number od addresses that called the contract in the last 30 days.
Query address active chain
Query the public chains where EVM-based addresses are active (i.e., have transactions). The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL.
Consumption per query 0HTTP Request
GET /api/v5/explorer/address/address-active-chain
Request Example
GET /api/v5/explorer/address/address-active-chain?address=0xC098B2a3Aa256D2140208C3de6543aAEf5cd3A94
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Avalanche-C",
"chainShortName": "AVAXC",
"isContractAddress": true
},
{
"chainFullName": "BNB Chain",
"chainShortName": "BSC",
"isContractAddress": false
},
{
"chainFullName": "Polygon",
"chainShortName": "POLYGON",
"isContractAddress": false
},
{
"chainFullName": "EthereumPoW",
"chainShortName": "ETHW",
"isContractAddress": false
},
{
"chainFullName": "Fantom",
"chainShortName": "FTM",
"isContractAddress": false
},
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"isContractAddress": false
},
{
"chainFullName": "Gnosis",
"chainShortName": "GNOSIS",
"isContractAddress": false
},
{
"chainFullName": "DIS CHAIN",
"chainShortName": "DIS",
"isContractAddress": false
},
{
"chainFullName": "OP Mainnet",
"chainShortName": "OP",
"isContractAddress": false
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network
chainShortName
String
The abbreviated name of the blockchain network,
isContractAddress
Bol
Whether it is the contract validator address
Query address token balance
Get Token Balance Detail for an address to get information about the balance of all tokens on that address. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/token-balance
Request Example
GET /api/v5/explorer/address/token-balance?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&protocolType=token_20&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
protocolType
String
Yes
Contract protocol Type token_20 token_721 token_1155
tokenContractAddress
String
No
Token Contract Address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "308",
"tokenList": [
{
"symbol": "FNK",
"tokenContractAddress": "0xb5fe099475d3030dde498c3bb6f3854f762a48ad",
"holdingAmount": "115.71687581",
"priceUsd": "",
"valueUsd": "34.25416242664877",
"tokenId": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenList
Array
Token list
> symbol
String
Symbol of the token
> tokenContractAddress
String
Token Contract Address
> holdingAmount
String
The holding amount of the token
> priceUsd
String
Token price in USD
> valueUsd
String
Total token value in USD
> tokenId
String
NFT token ID
Query address balance details
Get the balance details of an address, you can get other large balance information on the address. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
This is an old interface. It is recommended to use the "Query address token balance" under this module.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/address-balance-fills
Request Example
GET /api/v5/explorer/address/address-balance-fills?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
protocolType
String
Yes
Contract protocol Type token_20 token_721 token_1155 token_10
tokenContractAddress
String
No
Token Contract Address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "308",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"tokenList": [
{
"token": "USDT",
"tokenId": "",
"holdingAmount": "406275.909624",
"totalTokenValue": "257.29075982",
"change24h": "0.00010996",
"priceUsd": "1.00046",
"valueUsd": "406462.79654242704",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
tokenList
Array
Token List
> token
String
Token name
> tokenContractAddress
String
Token contract address
> holdingAmount
String
Token holding amount
> totalTokenValue
String
Total token value
> change24h
String
24-hour change in token price
> priceUsd
String
Token USD price
> valueUsd
String
Total USD value of tokens
> tokenId
String
NFT token ID
Query address history balance
The interface updates the height of searchable blocks on an hourly basis. The supported chains are BTC, ETH, POLYGON,POLYGON_ZKEVM , AVAXC , OP, ARBITRUM, TRON.
HTTP Request
GET /api/v5/explorer/block/address-balance-history
Consumption per query 1
Request Example
GET /api/v5/explorer/block/address-balance-history?chainShortName=eth&height=18376634&address=0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
height
String
Yes
Block height
address
String
Yes
Address to check historical balance
tokenContractAddress
String
No
Token contract address, if not filled in, check the balance of this chain tokens, if filled in, check the historical balance of the specified tokens
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"address": "0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701",
"height": "18376634",
"balance": "5.895934930980364414",
"balanceSymbol": "ETH",
"tokenContractAddress": "",
"blockTime": "1697624735000"
}
]
}
Response Parameters
Parameter
Type
Description
address
String
Address
height
String
Block height
balance
String
Balance
blockTime
String
The Unix timestamp for when the block was validated, in milliseconds format, e.g., 1597026383085.
tokenContractAddress
String
Token contract address, if the query is for this chain coin, returns ""
balanceSymbol
String
The balance currency, if it is the local chain coin, is the name of the local chain token, if it is the specified token, is the abbreviated name of the token
Query address transaction list information
Get the transaction list of the public chains currently supported by OKLink, and only return nearly 10,000 transaction data. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/address/transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/address/transaction-list?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
protocolType
String
No
Contract protocol type transaction internal token_20 token_721 token_1155 token_10 trx The default is transaction
symbol
String
No
Symbol of the token
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"transactionLists": [
{
"txId": "0x18714d659c9022eecd29bff3cd05cb78adc6c0b9522b04d713bfb2cc7a2f62f0",
"methodId": "",
"blockHash": "0xea0ee963034d87aeaccd6a0513725bec2a604b6a890e85d96289bfcd547154db",
"height": "16361564",
"transactionTime": "1673174795000",
"from": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
"to": "0xcffad3200574698b78f32232aa9d63eabd290703",
"isFromContract": false,
"isToContract": false,
"amount": "0.000567475798167289",
"transactionSymbol": "ETH",
"txFee": "0.000430211335176",
"state": "success",
"tokenId": "",
"tokenContractAddress": "",
"challengeStatus": "",
"l1OriginHash": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
transactionList
Array
Transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
Transaction time. Broadcasting time for pending transactions. Unix timestamp format in milliseconds, e.g. 1597026383085
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> amount
String
Transaction amount, for blockchains utilizing the UTXO model, the returned value represents the balance change prompted by this transaction for the specified address
> transactionSymbol
String
Transaction currency
> txFee
String
Transaction Fees
> state
String
Trading state success fail pending
> tokenContractAddress
String
Token Contract Address
> challengeStatus
String
Challenge period status
> l1OriginHash
String
L1 executed transaction hash
Query address normal transaction list
Get a list of common transactions associated with an address and return only the last year or one year back from the time of the last transaction. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/normal-transaction-list
Request Example
GET /api/v5/explorer/address/normal-transaction-list?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0xac39ce204486c83fa1aef285456a7e0d76f4a76976ab5ab65bcea98d97ee8508",
"methodId": "0xa9059cbb",
"nonce": "0",
"gasPrice": "8438956495",
"gasLimit": "94813",
"gasUsed": "63209",
"blockHash": "0x62a73bc006e481f6f6da53c3d71ea7a8f20c78de4b12a8eaa89d59d68501eefc",
"height": "18383240",
"transactionTime": "1697704715000",
"from": "0xf284512f225b350bf6e71d5a327891fcd26f640c",
"to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"isFromContract": false,
"isToContract": true,
"amount": "0",
"symbol": "ETH",
"txFee": "0.000533418001092455",
"state": "success",
"transactionType": "2"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> amount
String
Transaction amount
> state
String
trading state success fail pending
> methodId
String
Method ID
> symbol
String
Symbol of the token
> nonce
String
The number of transactions initiated by the sender's address
> gasUsed
String
Actual amount of gas used
> gasLimit
String
Gas limit
> gasPrice
String
Gas price
> txFee
String
Transaction fees
> state
String
Transaction status success fail pending
> transactionType
String
Transaction type 0：original transaction 1:EIP2930 2:EIP1559 Transaction type for Tron is also supported
Query address internal transaction list
Get a list of internal transactions associated with an address. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/internal-transaction-list
Request Example
GET /api/v5/explorer/address/internal-transaction-list?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x34d5bd0c44da0864cfb8b9d7f3311d5eb598a4093b26dd5df5d25ec0e9df4942",
"operation": "call",
"blockHash": "0xee4e80ebc8a4b8071b07abd63906a4201bcf76d66100369a39148a0f529d098c",
"height": "18376673",
"transactionTime": "1697625227000",
"from": "0x3a5cc8689d1b0cef2c317bc5c0ad6ce88b27d597",
"to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"isFromContract": true,
"isToContract": true,
"amount": "0",
"symbol": "ETH"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txid
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> operation
String
Operation type
> amount
String
Transaction amount
> symbol
String
Symbol of the token
Query address token transaction list
Get a list of token trading transactions associated with the address. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/token-transaction-list
Request Example
GET /api/v5/explorer/address/token-transaction-list?chainShortName=eth&address=0xdac17f958d2ee523a2206206994597c13d831ec7&protocolType=token_20&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
address
String
Yes
Address
protocolType
String
Yes
Token protocol Type token_20 token_721 token_1155 token_10The default is token_20
tokenContractAddress
String
No
Token contract address
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x66e4b648d6b82c5e2cfdd2121af896a11618c69a356c307e2403a885a8503c88",
"blockHash": "0x6199c61f711a797e7bc88b213a5ae71374898a413e5e20f9f8ad420189088e82",
"height": "18376245",
"transactionTime": "1697620043000",
"from": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"to": "0xce7a837e1717301cb30d668ec6fcc9f4d312f30f",
"tokenContractAddress": "0xd8daa146dc3d7f2e5a7df7074164b6ad99bed260",
"tokenId": "",
"amount": "1450000000",
"symbol": "",
"isFromContract": true,
"isToContract": false
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> from
String
Sender address
> to
String
Recipient address
> tokenContractAddress
String
Token contract address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> amount
String
Transaction amount
> symbol
String
Token symbol
> tokenId
String
NFT token ID
Batch query address entity labels
Batch query the entity labels for a maximum of 20 addresses on a specific chain, only returning the addresses with exchange big address labels and project labels. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, STARKNET, BASE, SCROLL, OMEGA, OPBNB.
Consumption per query 5HTTP Request
GET /api/v5/explorer/address/entity-label
Request Example
GET /api/v5/explorer/address/entity-label?chainShortName=eth&address=0x539C92186f7C6CC4CbF443F26eF84C595baBBcA1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
Chain name, e.g, BTC, ETH.
address
String
Yes
Address, up to 20 addresses separated by a comma.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"label": "OKX.Cold Wallet",
"address": "0x539c92186f7c6cc4cbf443f26ef84c595babbca1"
}
]
}
Response Parameters
Parameter
Type
Description
label
String
The entity labels for the address, such as "Binance.Deposit". If an address has multiple entity labels, they will be separated by commas.
address
String
Address
Batch query balances
This API allows for the batch querying of native token balances for up to 100 addresses. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 10HTTP Request
GET /api/v5/explorer/address/balance-multi
Request Example
GET /api/v5/explorer/address/balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network,
address
String
Yes
Addresses, up to 100 addresses separated by a comma.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"symbol": "ETH",
"balanceList": [
{
"address": "0x85c6627c4ed773cb7c32644b041f58a058b00d30",
"balance": "0"
},
{
"address": "0xb13a8883d5116b418066c379bc3b3f40d087b8d8",
"balance": "0.00019330554147975"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
symbol
String
Native token of the chain
balanceList
Array
Balance list
> address
String
Address
> balance
String
Native token balance of the address
Batch query token balances
This API allows for the batch querying of token balances for up to 50 addresses. The supported chains are LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/address/token-balance-multi
Request Example
GET /api/v5/explorer/address/token-balance-multi?chainShortName=eth&address=0x85c6627c4ed773cb7c32644b041f58a058b00d30,0xb13a8883d5116b418066c379bc3b3f40d087b8d8
Request Example
Parameter
Type
Required
Description
chainShortName
String
Yes
Chain abbreviation
address
String
Yes
Addresses, up to 50 addresses separated by commas.
protocolType
String
No
Different token types, for ERC-20 tokens: token_20, for ERC-721 tokens: token_721, for ERC-1155 tokens: token_1155
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "686",
"balanceList": [
{
"address": "0xf977814e90da44bfa03b6295a0616a897441acec",
"holdingAmount": "400",
"tokenContractAddress": "0x7379cbce70bba5a9871f97d33b391afba377e885"
},
{
"address": "0xf977814e90da44bfa03b6295a0616a897441acec",
"holdingAmount": "123101078.45198849",
"tokenContractAddress": "0x5c885be435a9b5b55bcfc992d8c085e4e549661e"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of records per page, default minimum 20 records, up to 100
totalPage
String
Total number of pages
balanceList
Array
List of token balances
> address
String
Address
> holdingAmount
String
Token balance of the address
> tokenContractAddress
String
Contract address of the token
Batch query normal transactions
This allows for querying ordinary transactions of up to 20 addresses at once. It is necessary to limit the starting block height and the ending block height, the difference between which cannot exceed 10,000 blocks. The supported chains are LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/address/normal-transaction-list-multi
Example Request
GET /api/v5/explorer/address/normal-transaction-list-multi?chainShortName=eth&address=00x533a7ae90fee4cafbc00e6a551cfb39a954cbf48,0xc0a3465b50a47848b7d04e145df61565d3e10566&endBlockHeight=18374343&startBlockHeight=18374341
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
Chain abbreviation
address
String
Yes
Addresses, up to 20 addresses separated by ,
startBlockHeight
String
Yes
Starting block number for the search
endBlockHeight
String
Yes
Ending block number for the search
page
String
No
Page number
limit
String
No
Number of records per page, default min 20, max 100
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "0x76e650150abadac6c781c9c90a0fcda69fce6e69f0fbbfb08d8cadc26076802a",
"methodId": "",
"blockHash": "0x58c6a91b0b5ff04bb7ea9b9f264c547472a96dafbdb069acc1e2e8d63792db16",
"height": "18374343",
"transactionTime": "1697597087000",
"from": "0x533a7ae90fee4cafbc00e6a551cfb39a954cbf48",
"to": "0xc0a3465b50a47848b7d04e145df61565d3e10566",
"isFromContract": false,
"isToContract": false,
"amount": "15296",
"symbol": "ETH",
"txFee": "0.000139810264818",
"gasLimit": "21000",
"gasUsed": "21000",
"gasPrice": "6657631658",
"nonce": "",
"transactionType": "2"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Page number
limit
String
Number of records per page, default min 20, max 100
totalPage
String
Total number of pages
transactionList
Array
List of transactions
> txId
String
Transaction hash
> methodId
String
Short hash identifying the smart contract function
> nonce
String
The number of transactions initiated by the sender's address
> blockHash
String
Block hash
> height
String
Block height of the transaction
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> from
String
Transaction sender's address, multiple addresses separated by ,
> to
String
Transaction receiver's address, multiple addresses separated by ,
> isFromContract
Bool
Whether the from address is a contract address
> isToContract
Bool
Whether the to address is a contract address
> amount
String
Token amount
> symbol
String
Symbol of the transaction token
> txFee
String
Transaction fee (in ETH)
> gasLimit
String
Maximum gas amount
> gasUsed
String
Actual amount of gas used (in Wei)
> gasPrice
String
Gas price (in Wei)
> transactionType
String
Transaction type 0：original transaction 1:EIP2930 2:EIP1559 Transaction type for Tron is also supported
Batch query internal transactions
You can perform a batch query for up to 20 addresses' regular transactions. You need to limit the query to a starting and ending block height, and the difference between the two cannot exceed 10,000 blocks. The supported chains are LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/address/internal-transaction-list-multi
Request Example
GET /api/v5/explorer/address/internal-transaction-list-multi?chainShortName=eth&address=0xd501520326d41aead2a70d4b5bf0c4646c0c9bd8,0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701&endBlockHeight=18374470&startBlockHeight=18370000&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Addresses, up to 20 can be entered, separated by commas
startBlockHeight
String
Yes
The start block height for the search
endBlockHeight
String
Yes
The end block height for the search
page
String
No
Page number
limit
String
No
Number of results per page. The default minimum is 20 and the maximum is 100
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "7",
"transactionList": [
{
"txId": "0xfcc0b4d18791f5932ba7e3563012a176ef0d9f959e0beefc34f6956a0d0043b6",
"blockHash": "0x6eab9220138600d0cd66b73737aec77c016c18c91e13e93a938b7477e1e18865",
"height": "18373050",
"transactionTime": "1697581427000",
"operation": "call",
"from": "0x09fa0d3154363036ea406f254808c53f5f975518",
"to": "0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701",
"isFromContract": true,
"isToContract": false,
"amount": "2450"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of results per page. The default minimum is 20 and the maximum is 100
totalPage
String
Total number of pages
transactionList
Array
List of transactions
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height where the transaction occurred
> operation
String
Operation type (e.g., staticcall)
> from
String
Transaction origin addresses, multiple addresses can be separated by commas
> to
String
Transaction destination addresses, multiple addresses can be separated by commas
> isFromContract
Bool
Whether the 'from' address is a contract address
> isToContract
Bool
Whether the 'to' address is a contract address
> amount
String
Amount of tokens involved in the transaction
Batch query token transactions
This API allows for the batch querying of transactions for up to 20 addresses. It is required to set both the starting block height and the ending block height, with the difference between the two not exceeding 10,000 blocks. The supported chains are LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/address/token-transaction-list-multi
Request Example
GET /api/v5/explorer/address/token-transaction-list-multi?chainShortName=eth&address=0xd501520326d41aead2a70d4b5bf0c4646c0c9bd8,0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701&endBlockHeight=18374470&startBlockHeight=18370000&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
Chain abbreviation
address
String
Yes
Addresses, up to 20 addresses separated by a comma.
startBlockHeight
String
Yes
Starting block height for the search.
endBlockHeight
String
Yes
Ending block height for the search.
page
String
No
Page number.
limit
String
No
Number of results per page; default is a minimum of 20 and a maximum of 100.
protocolType
String
No
Token protocol Type token_20 token_721 token_1155 token_10The default is token_20
tokenContractAddress
String
No
Token contract address, up to 20 addresses separated by a comma.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "88",
"transactionList": [
{
"txId": "0x644fe2fbc53316c3146760ecdb1405fc2dcb4893ac19552ad0898ea669176300",
"blockHash": "0xd027f203664d2911cb2bf2f73134539e6f7b5ac20be6ca998b7ea3691acfcd3d",
"height": "18373112",
"transactionTime": "1697582183000",
"from": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"to": "0xd275e5cb559d6dc236a5f8002a5f0b4c8e610701",
"isFromContract": true,
"isToContract": false,
"amount": "1",
"tokenId": "1",
"symbol": "Airdrop",
"tokenContractAddress": "0xf7b24c63fe941f2caadaee49f10e565d850be067"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Page number.
limit
String
Number of results per page; default is a minimum of 20 and a maximum of 100.
totalPage
String
Total number of pages.
transactionList
Array
List of transactions.
> txId
String
Transaction hash.
> blockHash
String
Block hash.
> height
String
Block height at which the transaction occurred.
> transactionTime
String
Time of the transaction; in Unix timestamp format in milliseconds, e.g., 1597026383085.
> from
String
Sending address(es) of the transaction, separated by a comma if multiple.
> to
String
Receiving address(es) of the transaction, separated by a comma if multiple.
> isFromContract
Bool
Whether the sending address is a contract address.
> isToContract
Bool
Whether the receiving address is a contract address.
> amount
String
Token amount.
> tokenId
String
Token ID, applicable for ERC721 and ERC1155 tokens.
> symbol
String
Symbol of the token.
> tokenContractAddress
String
Contract address of the token.
Top 100 richest addresses
Get the details of the top 100 addresses with the address balance of a public chain or contract. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/address/rich-list
Consumption per query 1
Request Example
GET /api/v5/explorer/address/rich-list?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
No
Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"symbol": "BTC",
"rank": "1",
"address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
"amount": "248597.39163733",
"transactionCount": "842",
"holdRatio": "0.0118",
"netWork": ""
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
symbol
String
Symbol of the token held
rank
String
Rank of the token balance
address
String
Holder address
amount
String
Holding amount
transactionCount
String
The number of transactions
holdRatio
String
Holding percentage
netWork
String
The blockchain network, displaying the "chainFullName" of the corresponding public chain, e.g., TRON.
Native token position ranking
Get the native token position ranking of a public chain, and only return the address with a balance of top 10000. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET
HTTP Request
GET /api/v5/explorer/address/native-token-position-list
Consumption per query 1
Request Example
GET /api/v5/explorer/address/native-token-position-list?chainShortName=ETH
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
page
String
No
Page number
limit
String
No
Number of results per page, default is a minimum of 20 and a maximum of 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "3",
"totalPage": "3334",
"positionList": [
{
"rank": "1",
"symbol": "ETH",
"holderAddress": "0x00000000219ab540356cbb839cbe05303d7705fa",
"amount": "35312968.32606823"
},
{
"rank": "2",
"symbol": "ETH",
"holderAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"amount": "3234638.2256898033"
},
{
"rank": "3",
"symbol": "ETH",
"holderAddress": "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8",
"amount": "1996008.379796362"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Page number.
limit
String
Number of results per page; default is a minimum of 20 and a maximum of 100.
totalPage
String
Total number of pages.
positionList
Array
Position list
> rank
String
Rank of the token balance
> symbol
String
Symbol of the token held
> address
String
Holder address
> amount
String
Holding amount
Pool
These endpoints from this module retrieve data related to specific mining pools such as mining hash rate rankings and lists of validators.
Query the mining pool share
Get the estimated share of each mining pool. The supported chains are BTC, BCH, LTC, DASH, ETH.
HTTP Request
GET /api/v5/explorer/pool/estimated-pool-share
Consumption per query 1
Request Example
GET /api/v5/explorer/pool/estimated-pool-share?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC、ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
period
String
No
Date 1D; 3D; 1W; 1M; 3M; 1Y; AllDefault is 1D
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "1",
"poolName": "AntPool",
"hashrate": "0",
"ratio": "0.2933",
"blockCount": "44",
"emptyBlockCount": "0",
"ommerBlockCount": "0",
"avgBlockSize": "",
"avgFee": "0.12343160636363637",
"minerFeeRatio": "0.0197"
},
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "2",
"poolName": "Foundry USA",
"hashrate": "0",
"ratio": "0.28",
"blockCount": "42",
"emptyBlockCount": "0",
"ommerBlockCount": "0",
"avgBlockSize": "",
"avgFee": "0.14027478785714284",
"minerFeeRatio": "0.0224"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
rank
String
The rank of block production quantity
poolName
String
Pool name
hashrate
String
Hash rate
ratio
String
The percentage of block production share, displayed as a decimal with precision to four decimal places
blockCount
String
The number of blocks
emptyBlockCount
String
The number of empty blocks
ommerBlockCount
String
The number of ommer blocks
avgBlockSize
String
Average block size, in Bytes
avgFee
String
Average transaction fee
minerFeeRatio
String
Miner fee percentage
Get the mining pool hashrate ranking
Get the computing power ranking of a public chain mining pool. The supported chains are BTC, BCH, LTC, DASH, ETH.
HTTP Request
GET /api/v5/explorer/pool/pool-hashrate-rank
Consumption per query 1
Request Example
GET /api/v5/explorer/pool/pool-hashrate-rank?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC、ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
category
String
No
Category real estimated Defaults to real
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "1",
"poolName": "Foundry USA",
"hashrate": "127637910960000010000",
"change24h": "0.0174",
"luckyRatio": "1.0347"
},
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"rank": "2",
"poolName": "AntPool",
"hashrate": "115000000000000000000",
"change24h": "0.0000",
"luckyRatio": "1.0785"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
rank
String
The rank of hash rate
poolName
String
Pool name
hashrate
String
Hash rate
change24h
String
24-hour change in computing power
luckyRatio
String
Lucky ratio
Validator
Get the list of supernodes or validators of the public chains currently supported by OKLink, suitable for chains such as OKC and BSC for pledge mining. The supported chains are OKTC, X1_TEST, BSC, TRON.
HTTP Request
GET /api/v5/explorer/pool/validator-list
Consumption per query 1
Request Example
GET /api/v5/explorer/pool/validator-list?chainShortName=bsc&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network. e.g. BTC、ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
period
period
No
Date 1D; 1W; 3M; 1Y; All Default is 1D
validatorName
String
No
Validator name
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "33",
"validatorList": [
{
"rank": "1",
"validatorName": "Fuji",
"validatorAddress": "0x7ae2f5b9e386cd1b50a4550696d957cb4900f03a",
"weightRatio": "0.05",
"weight": "",
"blocks": "1323",
"staked": "1118400.13217862",
"stakedSymbol": "BNB",
"reward": "-0.07670620656615305",
"rewardSymbol": "BNB",
"state": "-1",
"firstHeight": "48",
"latestHeight": "32710953",
"type": ""
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
validatorList
Array
Validator list
> rank
String
The rank of the validator
> validatorName
String
Validator name
> validatorAddress
String
Validator address
> weightRatio
String
Weight ratio
> weight
String
Weight
> blocks
String
Number of blocks generated
> staked
String
Amount of pledge (estimated value)
> stakedSymbol
String
Staked token name
> reward
String
Reward
> rewardSymbol
String
Reward token
> state
String
Validator Status
> firstHeight
String
First block height
> latestHeight
String
Last block height
> type
String
Tron node type SUPER, Super representative SUPERPARTNER, SR partner SUPERCANDIDATE, SR candidates
Transaction
These endpoints from this module retrieve transaction data such as a list of large transactions, transaction details, and unconfirmed transactions.
Query transaction list information
Get the transaction list of the public chains, and only return nearly 10,000 transaction data. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/transaction/transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/transaction/transaction-list?chainShortName=btc&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
blockHash
String
No
Block hash
height
String
No
Block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"transactionList": [
{
"txid": "8b09dcbc5604284aa88e171e75d717557d9668d4f5499a0db2a7522e478ac3dc",
"blockHash": "000000000000000000021a5bdbd89b086bf6932db2751cf7a01ca873317b3231",
"height": "812753",
"transactionTime": "1697632271000",
"input": "bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d",
"output": "bc1qlavjjmxghslxj6qrcjy2rs5mv7pugy3mzawt80,bc1qr2kugnsttnjkcawhpltw4nsh3z6vuxxguk0z3d",
"isInputContract": false,
"isOutputContract": false,
"amount": "0.00499015",
"transactionSymbol": "BTC",
"txfee": "0.0007215",
"methodId": "",
"transactionType": "",
"state": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
transactionList
Array
Transaction list
> txid
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height of the transaction
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> input
String
Token arrival address
> output
String
Token transfer out address
> isFromContract
Bol
Is the input address a contract address
> isToContract
Bol
Is the output address a contract address
> amount
String
Transaction amount
> transactionSymbol
String
Token symbol of the transaction
> txfee
String
Transaction fee
> methodId
String
Method ID
> transactionType
String
Transaction type 0：original transaction type 1:EIP2930 2:EIP1559
> state
String
Transaction state success fail pending
Query the list of large value transactions
Get the list of large-value transactions on the public chains. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/transaction/large-transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/transaction/large-transaction-list?chainShortName=btc&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
type
String
No
Query transactions with amount more than this value, with a minimum threshold of 100. The default is 100.
height
String
No
Block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"transactionList": [
{
"txid": "bca066292115784d9e83263df6b520794d43b8a8ac8622b03fc7ef6803331710",
"blockHash": "000000000000000000003549b3b7fcdff3a6328021eeabdae70c57e0fd3776c5",
"height": "812747",
"transactionTime": "1697627155000",
"input": "3D68UNbZVkaxZHGeXZ553xudqGfGjcF5y2",
"output": "3MNZCAW6C8rGQKzS39tARXnKVUcRyFF379,3JFudoNxai4Mg9TTB97PZ1i5kZHZ1EzJPT",
"isInputContract": false,
"isOutputContract": false,
"amount": "5119.9088941",
"transactionSymbol": "BTC",
"txfee": "0.0000498",
"methodId": "",
"transactionType": "",
"state": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
transactionList
Array
Transaction list
> txid
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> input
String
Input address
> output
String
Output address
> isInputContract
Bol
Is the input address a contract address
> isOutputContract
Bol
Is the output address a contract address
> amount
String
Transaction amount
> transactionSymbol
String
Transaction symbol
> txfee
String
Transaction fee
> methodId
String
Method ID
> transactionType
String
Transaction type 0：original transaction 1:EIP2930 2:EIP1559
> state
String
Transaction status success fail pending
Query the list of unconfirmed transactions
Get the list of unconfirmed transactions on the public chains, and only return nearly 10,000 transaction data. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/transaction/unconfirmed-transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/transaction/unconfirmed-transaction-list?chainShortName=btc&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"transactionList": [
{
"txid": "e41a58a47d2f9220c367780acd8fc9ee8461b964f1b6ffb3dd610302681b7656",
"height": "",
"transactionTime": "",
"input": "bc1qxx76udl8kjahmlvd8xktaflxgyg0gn664ucw00",
"output": "3GzPyo2eJJgjRB3C3e6w2SfX1heuiPnixo",
"isInputContract": false,
"isOutputContract": false,
"amount": "0.002321",
"transactionSymbol": "BTC",
"txfee": "2220",
"methodId": "",
"transactionType": "",
"randomNumber": "",
"status": "pending"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
transactionList
Array
Transaction list
> txid
String
Transaction hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> isInputContract
Bol
Is the input address a contract address
> isOutputContract
Bol
Is the output address a contract address
> input
String
Token arrival address
> output
String
Token transfer out address
> amount
String
Transaction amount
> transactionSymbol
String
Token symbol
> txfee
String
Transaction fee
> methodId
String
Method ID
> transactionType
String
Transaction type 0：original transaction type 1:EIP2930 2:EIP1559
> state
String
Transaction state success fail pending
> randomNumber
String
RandomNumber
Query internal transaction detail
Query for internal transaction detail by transaction hash. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/transaction/internal-transaction-detail
Request Example
GET /api/v5/explorer/transaction/internal-transaction-detail?chainShortName=eth&txId=0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
txId
String
Yes
Transaction hash
page
String
No
Page
limit
String
No
The number of results returned per request
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10",
"internalTransactionDetails": [
{
"txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
"from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"height": "18076803",
"transactionTime": "1693995971000",
"isFromContract": true,
"isToContract": true,
"operation": "call",
"amount": "0.002",
"state": "success"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
internalTransactionDetails
Array
Internal transaction details
> txId
String
Transaction hash
> height
String
Block height of the transaction
> transactionTime
String
Transaction time
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> operation
String
Operation type
> amount
String
Transaction amount
> state
String
Trading state
Query token transaction detail
Query for token transfer detail by transaction hash. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/transaction/token-transaction-detail
Request Example
GET /api/v5/explorer/transaction/token-transaction-detail?chainShortName=eth&txId=0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
txId
String
Yes
Transaction hash
protocolType
String
No
Contract protocol Type
page
String
No
Page
limit
String
No
The number of results returned per request
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"tokenTransferDetails": [
{
"txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
"from": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"to": "0xf66369997ae562bc9eec2ab9541581252f9ca383",
"height": "18076803",
"transactionTime": "1693995971000",
"isFromContract": true,
"isToContract": true,
"tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "WETH",
"amount": "0.002"
},
{
"txId": "0x06d35ea1b5ec75fa9f66bb0d481102aad6236a8e70427cd91a1b1c3e754244dc",
"from": "0xf66369997ae562bc9eec2ab9541581252f9ca383",
"to": "0xb59ac29fadba6818628a6cb0060a4b57fc4a7126",
"height": "18076803",
"transactionTime": "1693995971000",
"isFromContract": true,
"isToContract": false,
"tokenContractAddress": "0xbc396689893d065f41bc2c6ecbee5e0085233447",
"symbol": "PERP",
"amount": "4.23951772020582"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenTransferDetails
Array
Token transfer detail
> txId
String
Transaction hash
> height
String
Block height
> transactionTime
String
Transaction time
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> tokenContractAddress
String
Contract address of the token
> amount
String
Transaction amount
> symbol
String
Token symbol
Query transaction details
Get the basic transaction information on the public chains. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, APT, SUI, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
This is an old interface. We recommend using other interfaces under this module to query detailed transaction information.
HTTP Request
GET /api/v5/explorer/transaction/transaction-fills
Consumption per query 1
Request Example
GET /api/v5/explorer/transaction/transaction-fills?chainShortName=eth&txid=0x3ae59abf714df29a15bb8ecadfbe3068aff20693bb91c7e7c9d34ce245d56def
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
txid
String
Yes
Transaction hash, batch query up to 20 transactions, separated by English commas.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"txid": "0x3ae59abf714df29a15bb8ecadfbe3068aff20693bb91c7e7c9d34ce245d56def",
"height": "18126676",
"transactionTime": "1694599499000",
"amount": "0.1",
"transactionSymbol": "ETH",
"txfee": "0.000491371954353",
"index": "576",
"confirm": "250634",
"inputDetails": [
{
"inputHash": "0xe61771cd810d82e6ef302f69c76fbaf0538818c7",
"isContract": false,
"amount": ""
}
],
"outputDetails": [
{
"outputHash": "0x095624a01088cca5aae036c128cc9ac8032b9a3c",
"isContract": false,
"amount": ""
}
],
"state": "success",
"gasLimit": "21000",
"gasUsed": "21000",
"gasPrice": "0.000000023398664493",
"totalTransactionSize": "",
"virtualSize": "0",
"weight": "",
"nonce": "1365",
"transactionType": "2",
"methodId": "",
"errorLog": "",
"inputData": "0x",
"isAaTransaction": false,
"tokenTransferDetails": [],
"contractDetails": []
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
txid
String
Transaction hash
height
String
Block height of the transaction
transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
transactionType
String
Transaction type 0：original transaction 1:EIP2930 2:EIP1559
amount
String
Transaction amount
methodId
String
Method ID
errorLog
String
Transaction failure logs
inputData
String
Input data
transactionSymbol
String
Token symbol of the transaction
txfee
String
Transaction fee
index
String
The position index of the transaction in the block
confirm
String
Confirmed block count
inputDetails
Array
Input details
> inputHash
String
The hash address that initiated the transaction
> isContract
Bol
Contract address truefalse
> amount
String
Transaction amount
outputDetails
Array
Output details
> outputHash
String
The hash address to receive the transaction
> isContract
Bol
Contract address truefalse
> amount
String
Transaction amount
state
String
Transaction state success fail pending
gasLimit
String
Gas limit
gasUsed
String
Actual amount of gas used
gasPrice
String
Gas price
totalTransactionSize
String
Total transaction size
virtualSize
String
Virtual size
weight
String
Weight
nonce
String
The number of transactions initiated by the sender's address
isAaTransaction
Bol
Whether it is an AA transaction
tokenTransferDetails
Array
Token transfer details. Request the new interface GET /api/v5/explorer/transaction/internal-transaction-detail and GET /api/v5/explorer/transaction/token-transaction-detail to query more transaction data
> index
String
The positional index of the transaction in the block
> token
String
Token name
> tokenContractAddress
String
Token contract address
> symbol
String
Token symbol
> from
String
Token transfer out address
> to
String
Token arrival address
> isFromContract
Bol
Is the transfer out token address a contract address
> isToContract
Bol
Whether the receiving token address is a contract address
> tokenId
String
NFT token id
> amount
String
Token transfer amount
contractDetails
Array
Contract call transfer details
> index
String
The positional index of the transaction in the block
> from
String
Token transfer out address
> to
String
Token arrival address
> isFromContract
Bol
Is the transfer out token address a contract address
> isToContract
Bol
Is the receiving token address a contract address
> amount
String
Transaction amount
> gasLimit
String
Gas limit
Batch query transaction detail
This allows for querying transactions of up to 20 transaction at once. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 1HTTP Request
GET /api/v5/explorer/transaction/transaction-multi
Request Example
GET /api/v5/explorer/transaction/transaction-multi?chainShortName=eth&txId=0x9a6eca1a9f4cc9b8d338bba2ad50d71be42ceb6aac50059cb8b1fac7e8a37d74
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
txId
String
Yes
Transaction hash
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"txId": "0x9a6eca1a9f4cc9b8d338bba2ad50d71be42ceb6aac50059cb8b1fac7e8a37d74",
"methodId": "",
"blockHash": "0x7b9f40bb135a93a9638d30aa6e4ad97deba89542a975468eede129fad9f5e8df",
"height": "18362555",
"transactionTime": "1697454719000",
"from": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
"to": "0xd87cba5b88ca8c937792a564a60afc0d0683e731",
"isFromContract": false,
"isToContract": false,
"amount": "0.030891615623385848",
"symbol": "ETH",
"nonce": "97806",
"txFee": "0.000194151615588",
"gasPrice": "9245315028",
"gasLimit": "21000",
"gasUsed": "21000",
"state": "success",
"transactionType": ""
}
]
}
Response Parameters
Parameter
Type
Description
txId
String
Transaction hash
blockHash
String
Block hash
height
String
Block height
transactionTime
String
Transaction time；Unix timestamp format in milliseconds
from
String
Sender address
to
String
Recipient address
isFromContract
Bol
Is the From address a contract address
isToContract
Bol
Is the To address a contract address
amount
String
Transaction amount
symbol
String
Token symbol
nonce
String
The number of transactions initiated by the sender's address
gasLimit
String
Gas limit
gasUsed
String
Actual amount of gas used
gasPrice
String
Gas price
txFee
String
Transaction Fees
state
String
Trading state
transactionType
String
Transaction type 0：original transaction 1:EIP2930 2:EIP1559
methodId
String
Method ID
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> amount
String
Transaction amount
> state
String
trading state success fail pending
> method
String
Method ID
> symbol
String
Symbol
> nonce
String
Nonce
> gasUsed
String
Gas
> gasLimit
String
Gas limit
> gasPrice
String
Gas avg price
> txFee
String
Transaction Fees
> state
String
Transaction status success fail pending
Batch query internal transaction
This allows for querying internal transactions of up to 20 transaction at once. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/transaction/internal-transaction-multi
Request Example
GET /api/v5/explorer/transaction/internal-transaction-multi?chainShortName=eth&txId=0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
txId
String
Yes
Transaction hash
page
String
No
Page
limit
String
No
The number of results returned per request
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b",
"blockHash": "0x469ae737291639f3137d3d4e9649c56489e5d19e272248781f8869220900f809",
"height": "18368538",
"transactionTime": "1697526923000",
"operation": "delegatecall",
"from": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"to": "0xa2327a938febf5fec13bacfb16ae10ecbc4cbdcf",
"isFromContract": true,
"isToContract": true,
"amount": "0"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
internalTransactionDetails
Array
Internal transaction details
> txId
String
Transaction hash
> height
String
Block height of the transaction
> transactionTime
String
Transaction time
> operation
String
Operation type
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> amount
String
Transaction amount
Batch query token transaction
This allows for querying token transactions of up to 20 transaction at once. The supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/transaction/token-transfer-multi
Request Example
GET /api/v5/explorer/transaction/token-transfer-multi?chainShortName=eth&txId=0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
txId
String
Yes
Transaction hash
protocolType
String
No
Contract protocol Type
page
String
No
Page
limit
String
No
The number of results returned per request
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "0x633989939634e27ca69e784476a6e06766357ededc42b81b1e112a0180f3b03b",
"blockHash": "0x469ae737291639f3137d3d4e9649c56489e5d19e272248781f8869220900f809",
"height": "18368538",
"transactionTime": "1697526923000",
"from": "0xc94ebb328ac25b95db0e0aa968371885fa516215",
"to": "0x3275311fde369a68ef90bc25de9d462e1d5c8bb7",
"isFromContract": false,
"isToContract": false,
"amount": "554",
"tokenId": "",
"symbol": "USDC",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenTransferDetails
Array
Token transfer detail
> txId
String
Transaction hash
> blockHash
String
Block hash of the transaction
> height
String
Block height
> transactionTime
String
Transaction time
> from
String
Sender address
> to
String
Recipient address
> isFromContract
Bol
Is the From address a contract address
> isToContract
Bol
Is the To address a contract address
> tokenContractAddress
String
Contract address of the token.
> amount
String
Transaction amount
> tokenId
String
NFT token ID
> symbol
String
Token symbol
Token
The endpoints from this module retrieve data for a specified token detail. You can query the token price data on 200+ public chains via the endpoints in Market Data module.
Query token list information
Get basic information about a token on a chain, you can filter tokens by their issue date to search for the latest issued tokens, and the maximum filtering time span is one year.
The supported chains are ETH, OKTC, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/token/token-list
Consumption per query 1
Request Example
GET /api/v5/explorer/token/token-list?chainShortName=eth&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
protocolType
String
No
Contract protocol type token_20 token_721 token_1155 token_10 Default is token_20
tokenContractAddress
String
No
Token contract address
startTime
String
No
Retrieve tokens with issue dates later than this time. It should be in Unix timestamp format in milliseconds, e.g., 1597026383085. The time difference between startTime and endTime should not exceed one year.
endTime
String
No
Retrieve tokens with issue dates earlier than this time. It should be in Unix timestamp format in milliseconds, e.g., 1597026383085. The time difference between startTime and endTime should not exceed one year.
orderBy
String
No
Return the results in descending order based on different criteria. Only applicable to 20 tokens. totalMarketCap: Sort by total market capitalization in descending order. transactionAmount24h: Sort by 24-hour transaction amount in descending order. By default, the results are sorted by market capitalization in descending order.
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"tokenList": [
{
"tokenFullName": "Tether USD",
"token": "USDT",
"precision": "6",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"protocolType": "ERC20",
"addressCount": "4908191",
"totalSupply": "87625667476.7",
"circulatingSupply": "84605973812.99",
"price": "1.00026",
"website": "https://tether.to/",
"totalMarketCap": "84650814979.11",
"issueDate": "1511883490000",
"transactionAmount24h": "6781719762.427729",
"tvl": "293170014.5685352"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
tokenList
Array
Token list
> tokenFullName
String
Full name of the token
> token
String
Token name
> precision
String
Precision
> tokenContractAddress
String
Token contract address
> protocolType
String
Protocol type
> addressCount
String
Address count
> totalSupply
String
Total supply
> circulatingSupply
String
The total circulating supply of this token on all chains
> price
String
Price, the unit is USD
> website
String
Website
> totalMarketCap
String
The total market cap of this token on all chains
> issueDate
String
Issue Date
> transactionAmount24h
String
Transaction amount in the past 24 hours, the unit is USD, only for ERC-20 token
> tvl
String
Total value locked
Query token position list details
Get the list of positions of a token under a public chain, return only the address with a balance of top10000. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, Base, Scroll, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/token/position-list
Consumption per query 1
Request Example
GET /api/v5/explorer/token/position-list?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH.
tokenContractAddress
String
Yes
Token Contract Address
holderAddress
String
No
Holder address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"circulatingSupply": "977631.04",
"positionList": [
{
"holderAddress": "0x0a3f6849f78076aefadf113f5bed87720274ddc0",
"amount": "165544.6846010534",
"valueUsd": "231029494.33741083165440853217918",
"positionChange24h": "-0.000030241911044021",
"rank": "1"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
circulatingSupply
String
Circulating Supply
positionList
Array
Position List
> holderAddress
String
Holder Address
> amount
String
Holding amount
> valueUsd
String
Value of positions, Unit: USD
> positionChange24h
String
24 hour position changes
> rank
String
Position ranking
Query token position statistics
Get the Holder addresses' total purchase amount, purchase quantity, holding cost, and unrealized profit of a specific token on a particular public blockchain. The interface only considers addresses that have purchased the token on a DEX and still hold the token at present. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, ETHW, FTM, OP, ARBITRUM, ZKSYNC, LINEA, POLYGON_ZKEVM, BASE, SCROLL, TRON, and the data is updated every hour.
HTTP Request
GET /api/v5/explorer/token/position-stats
Consumption per query 1
Request Example
GET /api/v5/explorer/token/position-stats?chainShortName=eth&tokenContractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
Chain name, e.g, BTC, ETH.
tokenContractAddress
String
Yes
Token contract address
holderAddress
String
No
Holder address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "500",
"positionList": [
{
"holderAddress": "0xcee284f754e854890e311e3280b767f80797180d",
"amount": "1432683907.127544",
"totalTxnAmount": "949071.1488562819",
"totalTxnQuantity": "948975.819459",
"holdingCost": "1.000100455033023",
"unrealizedProfit": "-244208.182700946177592885512"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
positionList
Array
Position list
> holderAddress
String
Holder address
> amount
String
Holding amount
> totalTxnAmount
String
Total transaction amount in USD for purchases on DEX by the address
> totalTxnQuantity
String
Total quantity of the token purchased on DEX by the address
> holdingCost
String
Holding cost of the address, calculated as totalTxnAmount / totalTxnQuantity. Unit: USD
> unrealizedProfit
String
Unrealized profit of the token held by the address, calculated as (current token price - position cost) * holding amount
Query token transfer details
Get details of a specified token transfer from a specified chain. The supported chains are ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
HTTP Request
GET /api/v5/explorer/token/transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/token/transaction-list?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
tokenContractAddress
String
Yes
Token contract address
maxAmount
String
No
Transaction quantity range, maximum amount
minAmount
String
No
Transaction quantity range, minimum amount
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"totalTransfer": "2005176",
"transactionList": [
{
"txid": "0x784c42f0dee87a0e83ed29d69df6ab2af0a13792f2c266a4fe3f6f2b1f4c59ae",
"blockHash": "0x907077f5157ee31a5665f37f5589170fad2450857fea8d5d99a91ed02f908f1d",
"height": "18377320",
"transactionTime": "1697633099000",
"from": "0xaafb85ad4a412dd8adc49611496a7695a22f4aeb",
"to": "0x7913005b548839da13765020ddb9bf74a151b327",
"isToContract": false,
"isFromContract": true,
"amount": "0",
"transactionSymbol": "MKR",
"methodId": "0x8a179be4",
"tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"protocolType": "ERC20",
"state": "success",
"tokenId": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
totalTransfer
String
Total transfer
transactionList
Array
Transaction List
> txid
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> to
String
Token arrival address
> from
String
Token transfer out address
> isFromContract
Bol
Is the transfer out token address a contract address
> isToContract
Bol
Is the receiving token address a contract address
> amount
String
Transaction amount
> transactionSymbol
String
Token symbol of the transaction
> methodId
String
Method ID
> tokenContractAddress
String
Token Contract Address
> protocolType
String
Protocol Type
> state
String
Status success failpending
> tokenId
String
NFT token ID for 721 and 1155 tokens
Batch query token transaction
Batch query transactions of up to 20 contracts' tokens, with a maximum search of 10,000 blocks. The supported chains are LTC, ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, TRON, BASE, SCROLL, OMEGA, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET.
Consumption per query 5HTTP Request
GET /api/v5/explorer/token/token-transaction-list-multi
Request Example
GET /api/v5/explorer/token/token-transaction-list-multi?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2&endBlockHeight=17925814&startBlockHeight=17916100&limit=1
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Query via GET /api/v5/explorer/blockchain/summary.
tokenContractAddress
String
Yes
Token contract address, can input up to 20 addresses, separated by ','.
startBlockHeight
String
Yes
Starting block number for the search.
endBlockHeight
String
Yes
Ending block number for the search.
page
String
No
Page number.
limit
String
No
Number of items to return per page. Defaults to a minimum of 20 and a maximum of 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "712",
"transactionList": [
{
"txId": "0x3512b39be2705de69c45b94d08068dd9ff8d932b8cf163650e97154136dca9b3",
"blockHash": "0x7a6dc63e2f04cc40013f4359771038fbaebe9895568c93df122eb0c1aa2f0b32",
"height": "17925812",
"transactionTime": "1692169811000",
"from": "0x2e52f794dec462be6a05c7291b5d80326f953668",
"to": "0x5bea21c54bbb549c1c5fc3e451955878ed152dac",
"isFromContract": false,
"isToContract": false,
"amount": "0.9971",
"tokenId": "",
"symbol": "MKR",
"tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
The page number
limit
String
Number of cases returned per page,a default minimum of 20 to a maximum of 100
totalPage
String
Total number of pages
transactionList
Array
List of transactions
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
The integer block number where the transaction occurred
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> from
String
Sender's address, multiple addresses separated by ,
> to
String
Receiver's address, multiple addresses separated by ,
> isFromContract
Bol
Indicates if the sender's address is a contract address
> isToContract
Bol
Indicates if the receiver's address is a contract address
> amount
String
Token amount
> tokenId
String
NFT token ID, applicable for 721 and 1155 tokens
> symbol
String
Cryptocurrency symbol corresponding to the amount
> tokenContractAddress
String
Token contract address
Query token supply history
The API can be used to query historical supply of a token at specified block heights across various supported blockchains, including ETH, POLYGON, POLYGON_ZKEVM.
5 API calls per queryHTTP request
GET /api/v5/explorer/token/supply-history
Request Example
GET /api/v5/explorer/token/supply-history?chainShortName=polygon_zkevm&tokenContractAddress=0x1e4a5963abfd975d8c9021ce480b42188849d41d&height=946117
Request parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
tokenContractAddress
String
Yes
The token contract address
height
String
Yes
The block height
Response parameters
{
"code": "0",
"msg": "",
"data": [
{
"supply": "2495333.838249"
}
]
}
返回参数
Parameter
Type
Description
supply
String
The token supply at this block height
Log
Query log data by block and address, address and topic, address, and transaction.
Query log by block and address
Query the transaction event logs by block height and address, only returns nearly 1000 results. The supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 1HTTP Request
GET /api/v5/explorer/log/by-block-and-address
Request Example
GET /api/v5/explorer/log/by-block-and-address?chainShortName=ETH&startBlockHeight=18827085&endBlockHeight=18827085&address=0xa2e3356610840701bdf5611a53974510ae27e2e1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
startBlockHeight
String
Yes
The start block height for the search
endBlockHeight
String
Yes
The end block height for the search
address
String
Yes
The smart contract address that triggered the event log
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
Response Parameters
Parameter
Type
Description
height
String
Block height
address
String
The smart contract address that triggered the event log
topics
Array
The topics of the event log
data
String
The non-indexed parameter of the event
blockHash
String
Block hash
methodId
String
Method ID
transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
logIndex
String
The location index of the event log in the block
txId
String
Transaction hash
Query log by address and topic
Query the transaction event logs by address and topic0, only returns nearly 1000 results. The supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 1HTTP Request
GET /api/v5/explorer/log/by-address-and-topic
Request Example
GET /api/v5/explorer/log/by-address-and-topic?chainShortName=ETH&address=0xa2e3356610840701bdf5611a53974510ae27e2e1&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
The smart contract address that triggered the event log
topic0
String
Yes
The topic0 of the event log
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
Response Parameters
Parameter
Type
Description
height
String
Block height
address
String
The smart contract address that triggered the event log
topics
Array
The topics of the event log
data
String
The non-indexed parameter of the event
blockHash
String
Block hash
methodId
String
Method ID
transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
logIndex
String
The location index of the event log in the block
txId
String
Transaction hash
Query log by address
Query the transaction event logs by address, only returns nearly 1000 results. The supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 1HTTP Request
GET /api/v5/explorer/log/by-address
Request Example
GET /api/v5/explorer/log/by-address?chainShortName=ETH&address=0xa2e3356610840701bdf5611a53974510ae27e2e1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
The smart contract address that triggered the event log
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
Response Parameters
Parameter
Type
Description
height
String
Block height
address
String
The smart contract address that triggered the event log
topics
Array
The topics of the event log
data
String
The non-indexed parameter of the event
blockHash
String
Block hash
methodId
String
Method ID
transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
logIndex
String
The location index of the event log in the block
txId
String
Transaction hash
Query log by transaction
Query the transaction event logs by transaction hash, only returns nearly 1000 results. The supported chains are ETH, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, BASE, SCROLL, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 1HTTP Request
GET /api/v5/explorer/log/by-transaction
Request Example
GET /api/v5/explorer/log/by-transaction?chainShortName=ETH&txId=0x74e2d0404b073d043d5c9aac574fe6b354ca92c43bebfdb169e5136f4ff4393e
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
txId
String
Yes
Transaction hash
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"height": "18827085",
"address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000402b2bceb1415f48b413752cc0e27d76ff34ddeb"
],
"data": "0x00000000000000000000000000000000000000000000000a8f4e545c96c74dfd",
"methodId": "0x04b7962c",
"blockHash": "0xdbeab8d3ffb13f4dd738940388349c7cbf062d98da40f90066d9d59d794a9bff",
"transactionTime": "1703074871000",
"logIndex": "10",
"txId": "0xda476a00e3a22360ef8fdd1be6cfe9da1b97dc0af086ce9229ffefa24fae31d9"
}
]
}
Response Parameters
Parameter
Type
Description
height
String
Block height
address
String
The smart contract address that triggered the event log
topics
Array
The topics of the event log
data
String
The non-indexed parameter of the event
blockHash
String
Block hash
methodId
String
Method ID
transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
logIndex
String
The location index of the event log in the block
txId
String
Transaction hash
Stats
Access on-chain data, block information, and gas statistics across a wide range of public chains, including access to comprehensive historical data.
Query blockchain stats
The API can be used to query daily new addresses, overall transactions, contract calls, transaction fees, and network utilization across various supported blockchains, including ETH, POLYGON, POLYGON_ZKEVM, BSC, AVAXC, FTM, ARBITRUM, OP, BASE, TRON, X1_TEST, BTC.
Consumption per query 5HTTP Request
GET /api/v5/explorer/blockchain/stats
Request Example
GET /api/v5/explorer/blockchain/stats?chainShortName=eth
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
startTime
String
No
The Unix timestamp marking the start of data querying, in milliseconds format e.g., 1597026383085
endTime
String
No
The Unix timestamp marking the end of data querying, in milliseconds format e.g., 1597026383085
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3110",
"statsHistoryList": [
{
"time": "1706832000000",
"newAddressCount": "104106",
"totalTransactionCount": "1108185",
"totalContractCalls": "5065734",
"transactionFee": "2657.1239669484817",
"networkUtilization": "0.5048832665557917"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The number of results returned per page
totalPage
String
Total number of pages
statsHistoryList
Array
List of historical statistical data
> time
String
Date, unix timestamp format in milliseconds, e.g. 1597026383085
> newAddressCount
String
The daily number of new addresses
> totalTransactionCount
String
Total transaction count
> totalContractCalls
String
The total number of contract calls on the blockchain per day
> transactionFee
String
The total transaction fee paid to validators per day, measured in the chain's native token
> networkUtilization
String
Daily network utilization rate, calculated based on the daily total gas consumption divided by the daily total gas limit
Query block stats
Query information such as daily number of blocks produced, block size, mining rewards, and average block interval across a range of supported blockchains, including ETH, POLYGON, POLYGON_ZKEVM, BSC, AVAXC, FTM, ARBITRUM, OP, BASE, TRON, X1_TEST, BTC.
Consumption per query 5HTTP Request
GET /api/v5/explorer/block/block-stats
Request Example
GET /api/v5/explorer/block/block-stats?chainShortName=eth
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
startTime
String
No
The Unix timestamp marking the start of data querying, in milliseconds format e.g., 1597026383085
endTime
String
No
The Unix timestamp marking the end of data querying, in milliseconds format e.g., 1597026383085
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3110",
"blockHistoryList": [
{
"time": "1706832000000",
"blockCount": "7132",
"blockSize": "149949.05300056085",
"mineReward": "489.8858503788926",
"rewardSymbol": "ETH",
"avgBlockInterval": "12.114413909141895"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The number of results returned per page
totalPage
String
Total number of pages
blockHistoryList
Array
List of historical block data
> time
String
Date, unix timestamp format in milliseconds, e.g. 1597026383085
> blockCount
String
The total number of blocks produced per day
> blockSize
String
The daily average block size, measured in bytes
> mineReward
String
The total block rewards received per day
> rewardSymbol
String
The crypto type for the block reward
> avgBlockInterval
String
The daily average block production time, measured in seconds
Query gas stats
Retrieve information such as daily average gas limit, total gas consumption, average gas price, and maximum/minimum gas prices for supported blockchains, including ETH, POLYGON, POLYGON_ZKEVM, BSC, AVAXC, FTM, ARBITRUM, OP, BASE, X1_TEST.
Consumption per query 5HTTP Request
GET /api/v5/explorer/block/block-stats
Request Example
GET /api/v5/explorer/gas/stats?chainShortName=eth
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
startTime
String
No
The Unix timestamp marking the start of data querying, in milliseconds format e.g., 1597026383085
endTime
String
No
The Unix timestamp marking the end of data querying, in milliseconds format e.g., 1597026383085
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "3110",
"gasHistoryList": [
{
"time": "1706832000000",
"avgGasLimit": "29999675",
"totalGasUsed": "103886992668",
"avgGasPrice": "24498721911",
"maxGasPrice": "21010266430914",
"minGasPrice": "11688300977"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The number of results returned per page
totalPage
String
Total number of pages
gasHistoryList
Array
List of historical gas data
> time
String
Date, unix timestamp format in milliseconds, e.g. 1597026383085
> avgGasLimit
String
The daily average gas limit across all blocks
> totalGasUsed
String
The total gas consumption per day
> avgGasPrice
String
The daily average gas price, measured in wei
> maxGasPrice
String
The daily maximum gas price, measured in wei
> minGasPrice
String
The daily minimum gas price, measured in wei
UTXO
These endpoints from this module retrieve UTXO chain data and BRC20 data. The UTXO chains include BTC, BCH, LTC, DASH, and DOGE.
Query address UTXO transaction
Get UTXO transaction information on an address, only for chains with UTXO models including BTC, BCH, LTC, DASH, DOGE.
HTTP Request
GET /api/v5/explorer/address/unspent
Consumption per query 1
Request Example
GET /api/v5/explorer/address/unspent?chainShortName=btc&address=bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
address
String
Yes
Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"txId": "26270302d90b41ee6a7ac4521d520eb27ee7471cc946a229a07f2dd2c1a610dc",
"height": "812718",
"amount": "0.00011918",
"address": "bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2",
"confirm": "",
"index": "1831",
"transactionIndex": "",
"balance": "118300.20301158",
"symbol": "BTC",
"unspent": ""
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
txid
String
Transaction hash
height
String
Block height
amount
String
Number of transactions
address
String
Address
unspent
String
Unspent transaction output
confirm
String
Confirm
index
String
The position index of the transaction in the block
transactionIndex
String
The positional index of the UTXO in the transaction
balance
String
Address balance
symbol
String
Token symbol
Query address remaining UTXO
Get a breakdown of each UTXO remaining at the address, only for chains with UTXO models including BTC, BCH, LTC, DASH, DOGE.
HTTP Request
GET /api/v5/explorer/address/utxo
Consumption per query 1
Request Example
GET /api/v5/explorer/address/utxo?chainShortName=btc&address=bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
address
String
Yes
Address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 100. The default is 50.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "172",
"utxoList": [
{
"txid": "d11638ea2cf68c4b49c1d97ef681a9e7e4658ba6cb7290dd73d476db371b9037",
"height": "796599",
"blockTime": "1688150365",
"address": "bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2",
"unspentAmount": "0.0003",
"index": "0"
}
]
}
]
}
Response ParametersResponse Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
utxoList
Array
Remaining UTXO list
> txid
String
Transaction hash
> height
String
Block height
> blockTime
String
Block time
> address
String
Address
> unspentAmount
String
Unspent transaction output
> index
String
The position index of the transaction in the block
BRC20
These endpoints from this module retrieve BRC20 data such as token lists, token inscriptions, token details, and token balance.
Query inscriptions list
Get the list of inscriptions for the BTC chain
HTTP Request
GET /api/v5/explorer/btc/inscriptions-list
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/inscriptions-list
Request Parameters
Parameter
Type
Required
Description
token
String
No
Token name, tick
inscriptionId
String
No
Inscription ID
inscriptionNumber
String
No
Inscription Number
state
String
No
State success, fail. Default returns success
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"totalInscription": "31126135",
"inscriptionsList": [
{
"inscriptionId": "92780ef845a5190a1027724c24b5adbe6713abdaa43c5f273ff8a87d41f6cc8ci0",
"inscriptionNumber": "9999999",
"location": "92780ef845a5190a1027724c24b5adbe6713abdaa43c5f273ff8a87d41f6cc8c:0:0",
"token": "10MM",
"state": "success",
"msg": "",
"tokenType": "BRC20",
"actionType": "mint",
"logoUrl": "",
"ownerAddress": "bc1p53rrfs7l3fdyd60wzsk9gphnjm6y9hr4vhfrp207tsltyxjatfqqj9ly8k",
"txId": "92780ef845a5190a1027724c24b5adbe6713abdaa43c5f273ff8a87d41f6cc8c",
"blockHeight": "792013",
"contentSize": "",
"time": "1685401405000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
totalInscription
String
Total number of inscriptions
inscriptionsList
Array
Inscriptions list
> inscriptionId
String
Inscription id
> inscriptionNumber
String
Inscription number
> token
String
Token name, tick
> state
String
State, success, fail
> msg
String
Transaction prompt: Error message for failures, and other messages for prompts
> tokenType
String
Token type, BRC20
> actionType
String
Action Type; deploy, mint, inscribeTransfer, transfer
> logoUrl
String
Logo URL
> ownerAddress
String
Address of the owner of the inscription
> txId
String
Latest transaction hash
> location
String
Location, in the format txid: out: offset
> blockHeight
String
Block height
> contentSize
String
The size of the stored information. Unit: Bytes
> time
String
Inscription creation time
Query token list
Get a list of BRC20 tokens for the BTC chain
HTTP Request
GET /api/v5/explorer/btc/token-list
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/token-list
Request Parameters
Parameter
Type
Required
Description
token
String
No
Token name, tick
orderBy
String
No
deployTimeAsc: Return in ascending order of deployTime, from far to near deployTimeDesc: Return in descending order of deployTime, from near to farThe default is deployTimeAsc
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"tokenList": [
{
"token": "ordi",
"deployTime": "1678248991000",
"inscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"inscriptionNumber": "348020",
"totalSupply": "21000000",
"mintAmount": "21000000",
"transactionCount": "484169",
"holder": "13080",
"mintRate": "1"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
> token
String
Token name, tick
> deployTime
String
Deploy Time
> inscriptionId
String
Inscription id
> inscriptionNumber
String
Inscription number
> totalSupply
String
Total supply
> mintAmount
String
Mint amount
> transactionCount
String
Number of transactions
> holder
String
THe number of holders
> mintRate
String
Mint ratio, displayed as a decimal, e.g. 0.9543; retains four decimal places
Query token details
Get token details, including number of holder addresses, number of minted, etc.
HTTP Request
GET /api/v5/explorer/btc/token-details
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/token-details?token=sats
Request Parameters
Parameter
Type
Required
Description
token
String
Yes
Tick
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"token": "sats",
"precision": "18",
"totalSupply": "2100000000000000",
"mintAmount": "2100000000000000",
"limitPerMint": "100000000",
"holder": "35825",
"deployAddress": "bc1prtawdt82wfgrujx6d0heu0smxt4yykq440t447wan88csf3mc7csm3ulcn",
"logoUrl": "https://static.oklink.com/cdn/web3/currency/token/btc-sats-9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0.png/type=png_350_0",
"txId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333",
"inscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
"deployHeight": "779971",
"deployTime": "1678339934000",
"inscriptionNumber": "357097",
"state": "success",
"tokenType": "BRC20",
"msg": ""
}
]
}
Response Parameters
Parameter
Type
Description
token
String
Token name, tick
precision
String
Precision
totalSupply
String
Total supply
mintAmount
String
Mint amount
limitPerMint
String
Maximum number of casts per time
holder
String
Number of token addresses held
deployAddress
String
Deploy address
logoUrl
String
Logo url
txId
String
Transaction hash
inscriptionId
String
Inscription id
deployHeight
String
Deployment block height
deployTime
String
Deploy time
inscriptionNumber
String
Inscription number
state
String
State: success、fail
tokenType
String
Token type, BRC20
msg
String
Msg
Query token position Address List
Get a list of token Holder addresses and view token distribution details.
HTTP Request
GET /api/v5/explorer/btc/position-list
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/position-list?token=sats&limit=2
Request Parameters
Parameter
Type
Required
Description
token
String
Yes
Token name, tick
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "5000",
"positionList": [
{
"holderAddress": "bc1plff0sqm6ym55eak9vjljghd55h7hkheg22c84w55w646l857elqsfzmfdv",
"amount": "31740686608926",
"rank": "1"
},
{
"holderAddress": "bc1pun3whtlzac75f2vcznxmpfc09dnzyp0luw8tpfwc7wrruwav30pqsu6l9u",
"amount": "22651199774504",
"rank": "2"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
positionList
Array
List of addresses for token positions
> holderAddress
String
Holder address
> amount
String
Holding amount
> rank
String
Holding rank
Query token transfer list
Query transfer list by address, transaction hash, block height. No data on pending transactions.
HTTP Request
GET /api/v5/explorer/btc/transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/transaction-list
Request Parameters
Parameter
Type
Required
Description
address
String
No
BTC Address
token
String
No
Token name, tick
inscriptionNumber
String
No
Inscription number
actionType
String
No
Action type：deploy, mint、inscribeTransfer、transfer
toAddress
String
No
Sender BTC address
fromAddress
String
No
Receiver BTC address
txId
String
No
Transaction hash
blockHeight
String
No
Block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"totalTransaction": "31124061",
"inscriptionsList": [
{
"txId": "af6bb18c64c57296ae07b8f4b1857c655160402a8d332fdb523915d7887476e2",
"blockHeight": "812873",
"state": "fail",
"tokenType": "BRC20",
"actionType": "mint",
"fromAddress": "",
"toAddress": "bc1qx2l6pzt7aknazsgdnvf5vnhp8ezx38ykg2wvfz",
"amount": "",
"token": "$ORC",
"inscriptionId": "af6bb18c64c57296ae07b8f4b1857c655160402a8d332fdb523915d7887476e2i0",
"inscriptionNumber": "35346117",
"index": "0",
"location": "af6bb18c64c57296ae07b8f4b1857c655160402a8d332fdb523915d7887476e2:0:0",
"msg": "tick: $ORC has been minted",
"time": "1697695573000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
totalTransaction
String
Total number of transactions
transactionList
Array
Transaction list
> txid
String
Transaction hash
> blockHeight
String
Block height
> state
String
State: success, fail
> tokenType
String
Token Type, BRC20
> actionType
String
Action Type：deploy, mint, inscribeTransfer, transfer
> fromAddress
String
Sender BTC address
> toAddress
String
Receiver BTC address
> amount
String
Transaction amount
> index
String
The index of vout. When the type is coinbase, this field has no numerical value
> location
String
Location, in the format txid: out: offset; When the type is coinbase, this field has no numerical value
> token
String
Token name, tick
> inscriptionId
String
Inscription id
> inscriptionNumber
String
Inscription number
> msg
String
Transaction prompt: Error message for failures, and other messages for prompts
> time
String
Transaction time
Query address balance list
Query the balance of BRC20 tokens held by BTC address, transferable balance, available balance.
HTTP Request
GET /api/v5/explorer/btc/address-balance-list
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/address-balance-list?address=bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
BTC Chain Address
token
String
No
Token name, tick
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "12",
"balanceList": [
{
"token": "sats",
"tokenType": "BRC20",
"balance": "1350000000000",
"availableBalance": "1350000000000",
"transferBalance": "0"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
balanceList
Array
List of token balances held by BTC address
> token
String
Token name, tick
> tokenType
String
Token type, BRC20
> balance
String
Token balance
> availableBalance
String
Available balance
> transferBalance
String
Transfer balance
Query address balance details
Query the detailed list of the transferable balance of a token at an address.
HTTP Request
GET /api/v5/explorer/btc/address-balance-details
Consumption per query 1
Request Example
GET /api/v5/explorer/btc/address-balance-details?address=bc1ph0057nc25ka94z8ydg43j8tnnp38u3hxpadutnt4n3jyfrmjzmcqw99mk2&token=meme
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
BTC chain address
token
String
Yes
Token name, tick
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "6",
"token": "meme",
"tokenType": "BRC20",
"balance": "18",
"availableBalance": "0",
"transferBalance": "18",
"transferBalanceList": [
{
"inscriptionId": "a1002519472f9a1d45db5a3df30ea521ecd5425e546a63a79f3a4a9ff4e6e582i0",
"inscriptionNumber": "4615101",
"amount": "3"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
token
String
Token name, tick
tokenType
String
Token type, BRC20
balance
String
Token balance
availableBalance
String
Available balance
transferBalance
String
Transfer balance
transferBalanceList
Array
Transfer balance list
> inscriptionId
String
Inscription id
> inscriptionNumber
String
Inscription Number
> amount
String
Token amount
EVM
These endpoints from this module retrieve data on ETH deflation, beacon chain data, StarkNet data, and more.
ETH Deflation
These endpoints from this module retrieve ETH data such as circulating supply, staking and gas consumption.
Query the ETH supply change overview
Check the latest deflation data overview of ETH
HTTP Request
GET /api/v5/explorer/deflation/supply
Consumption per query 5
Request Example
GET /api/v5/explorer/deflation/supply
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"circulatingSupply": "120404650.2518",
"totalBurnt": "3640484.712",
"inflationRate": "0.004",
"stakingAmount": "30739208",
"stakingApy": "0.027"
}
]
}
Response Parameters
Parameter
Type
Description
circulatingSupply
String
Circulation supply of ETH
totalBurnt
String
Total amount of ETH burned
stakingApy
String
Annual percentage yield for staking ETH
stakingAmount
String
Total staking amount of ETH
inflationRate
String
Current annual inflation rate, displayed as a decimal, example: 0.1 = 10%
Query the ETH supply and burn
Historical data on the daily supply and destruction of Eth through this interface.
HTTP Request
GET /api/v5/explorer/deflation/supply-burn
Consumption per query 5
Request Example
GET /api/v5/explorer/deflation/supply-burn
Request Parameters
Parameter
Type
Required
Description
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "2246",
"inflationHistoryList": [
{
"supply": "2328.5755",
"burnt": "992.0577",
"netInflation": "1336.5177",
"circulatingSupply": "120404650.2518",
"inflationRate": "0.004",
"time": "1697558400000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
inflationHistoryList
Array
Inflation history list
> circulatingSupply
String
Eth circulating supply
> burnt
String
Daily amount of ETH burnt
> netInflation
String
Daily net inflation of ETH quantity, positive value indicates an increase, negative value indicates a decrease
> supply
String
Daily amount of ETH supplied
> inflationRate
String
Current annualized inflation rate of ETH, displayed as a decimal, example: 0.1 = 10%
> time
String
The time when the data was last updated. Unix timestamp format in milliseconds, e.g. 1597026383085
Query the ETH staking
Get ETH pledge history details
HTTP Request
GET /api/v5/explorer/deflation/pos-staking
Consumption per query 5
Request Example
GET /api/v5/explorer/deflation/pos-staking
Request Parameters
Parameter
Type
Required
Description
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "1052",
"stakingHistoryList": [
{
"time": "1697558400000",
"totalValidator": "979417",
"totalStaked": "30739208",
"stakingRatio": "0.2588",
"validatorDailyIncome": "2328.5755",
"apy": "0.027",
"nonEip1559Fee": "58.5716",
"baseRewards": "992.0577",
"priorityFee": "294.1105"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
stakingHistoryList
Array
ETH staking history list
> apy
String
Annual percentage yield
> baseRewards
String
Base rewards
> priorityFee
String
Priority fee
> totalStaked
String
Total amount of ETH staked
> stakingRatio
String
ETH staking ratio
> nonEip1559Fee
String
Non eip1559 fee
> totalValidator
String
Total number of validators
> validatorDailyIncome
String
Validator daily income
> time
String
The time when the data was last updated. Unix timestamp format in milliseconds, e.g. 1597026383085
Query the gas consumption
Get ETH historical gas data through this interface
HTTP Request
GET /api/v5/explorer/deflation/gas
Consumption per query 5
Request Example
GET /api/v5/explorer/deflation/gas
Request Parameters
Parameter
Type
Required
Description
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "805",
"gasHistoryList": [
{
"nonEip1559Fee": "58.5716",
"eip1559BaseFee": "992.0577",
"eip1559Tip": "294.1105",
"totalTransactionCount": "994388",
"maxGasPrice": "101",
"minGasPrice": "4.7883",
"avgGasPrice": "9.9651",
"time": "1697558400000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
gasHistoryList
Array
Gas historical data
> avgGasPrice
String
Average gas price
> maxGasPrice
String
Max gas price
> minGasPrice
String
Min gas price
> eip1559BaseFee
String
Eip1559 base fee
> eip1559Tip
String
Eip1559 tip
> totalTransactionCount
String
Total number of transactions
> nonEip1559Fee
String
Non eip1559 fee
> time
String
The time when the data was last updated. Unix timestamp format in milliseconds, e.g. 1597026383085
Beacon
The Beacon data module supports querying data related to withdrawals and staking on the beacon chain.
Beacon chain basic information
Retrieve the basic information of the beacon chain, including an overview of the validators and staking data.
Consumption per query 1HTTP Request
GET /api/v5/explorer/beacon/beacon-summary
Sample Request
GET /api/v5/explorer/beacon/beacon-summary
Response Sample
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Beacon Chain",
"chainShortName": "BEACON",
"issueDate": "1606824023000",
"consensus": "PoS",
"finalizedEpoch": "236649",
"finalizedSlot": "7572768",
"lastCheckpoint": "7572833",
"validators": {
"totalValidators": "980088",
"newTotalValidators": "1808",
"activeValidators": "862463",
"newActiveValidators": "-1473",
"pendingValidators": "696",
"newPendingValidators": "620",
"exitedValidators": "3749",
"newExitedValidators": "1234",
"totalValidatorIncome": "1498841.462357212"
},
"staking": {
"totalDeposits": "31414348",
"newTotalDeposits": "37458",
"beaconDepositsReceived": "31433146",
"newBeaconDepositsReceived": "57143",
"depositAddresses": "981304",
"newDepositAddresses": "1157",
"beaconDepositsPubKeys": "980093",
"newBeaconDepositsPubKeys": "1808",
"votedStakes": "27538741",
"effectiveStakes": "27598587"
}
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g., Beacon Chain
chainShortName
String
The abbreviated name of the blockchain network, e.g., BEACON
issueDate
String
Issue date
consensus
String
Consensus algorithm, e.g., PoS
finalizedEpoch
String
Final epoch
finalizedSlot
String
Final slot
lastCheckpoint
String
Latest checkpoint slot
validators
Array
Validator overview
> totalValidators
String
Total number of validators
> newTotalValidators
String
Number of new validators, positive for increase, negative for decrease
> activeValidators
String
Number of active validators
> newActiveValidators
String
Number of new active validators, positive for increase, negative for decrease
> pendingValidators
String
Number of validators pending review
> newPendingValidators
String
Number of new validators pending review, positive for increase, negative for decrease
> exitedValidators
String
Number of validators that have exited
> newExitedValidators
String
Number of new exited validators, positive for increase, negative for decrease
> totalValidatorIncome
String
Cumulative income of validators
staking
Array
Staking overview
> totalDeposits
String
Number of ETH staked on the ETH1.0 chain
> newTotalDeposits
String
New amount of ETH staked on the ETH1.0 chain, positive for increase, negative for decrease
> beaconDepositsReceived
String
Total staked amount received by the beacon chain
> newBeaconDepositsReceived
String
New staked amount received by the beacon chain, positive for increase, negative for decrease
> depositAddresses
String
Address list for ETH staked on the ETH1.0 chain
> newDepositAddresses
String
New addresses for ETH staked on the ETH1.0 chain, positive for increase, negative for decrease
> beaconDepositsPubKeys
String
Number of public keys for staking on the beacon chain
> newBeaconDepositsPubKeys
String
Number of new public keys for staking on the beacon chain, positive for increase, negative for decrease
> votedStakes
String
Active staked amount, valid ETH staked on the beacon chain for voting or block production, updated every hour
> effectiveStakes
String
Effective staked amount, ETH deposits visible and accepted by beacon chain nodes, updated every hour
Beacon chain slot list
Retrieve the validator details of the Beacon Chain.
Consumption per query 1HTTP Request
GET /api/v5/explorer/beacon/beacon-slot-list
Request Example
GET /api/v5/explorer/beacon/beacon-slot-list
Request Parameters
Parameter
Type
Required
Description
slot
String
no
Slot number, if none are filled in, default to slot order, with the latest at the top
epoch
String
no
Epoch number
index
String
no
Index of the validator
limit
String
no
The number of results returned per request. The maximum is 100. The default is 20.
page
String
no
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"slotList": [
{
"epoch": "236651",
"slot": "7572839",
"state": "proposed",
"index": "960171",
"time": "1697698091000",
"slotIndex": "8",
"attestationCount": "128",
"parentRoot": "0xab67fff2294a6a76e1dda77d0cc65dd183bd3574ff58ea4ffede84e4fc81fabd",
"root": "0xf8a24b30de4f066fcca8a423c619cff5c3217501cbc8e82f68a5934674bcbed4",
"signature": "0x8e103c3f3c8c9453d7c1aa89eed7b20808f78097ac4607db0877fee91db39126ff10e07d4dacfa34fb5adc9764fa3027064d1377ada3055074b2f1dc26c5bb4fc40e63bd080bf5ae39278908fd9ece292339108dd619ecc2fbf440c1939983c2",
"randaoReveal": "0x904c3f03c7ca03750168d362f57f7ea58d32ee57d7d8a53a035dddd37cb3790c94d3a5f332823f069116386750b788d3133e6aedc92354db0d865b1b6d42bb9f4068407cbee4a0a6276c379ba5e561b720a5edd67b01fd7ef5e7f1b63371d041",
"graffiti": "0x0000000000000000000000000000000000000000000000000000000000000000",
"voluntaryExitsCount": "0",
"attesterSlashingCount": "0",
"l1BlockHash": "0xe06cf95360ff87f350b2681a93d7220239a218da2edff3dca4732d72cd856446",
"l1DepositCount": "1011590",
"l1DepositRoot": "0xcc10e96d2ef785919c78bd249ff0af6d93c83919595f63b57ac101c9352ea905",
"pubkey": "0x80b3fae29e4ea97d81f97578453f44b2a30b54eb1c8e176c3c0b933a797510f123a70457301cb967f070e2ef173d51d3"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of data items on the current page
totalPage
String
Total number of pages
slotList
Array
List of slot
> epoch
String
Epoch to which the slot belongs
> slot
String
Slot number
> state
String
Status; proposed, skipped, forked
> index
String
Corresponding validator number
> pubkey
String
Public key of the corresponding validator
> time
String
Start time of this slot
> slotIndex
String
Position of the current slot in the epoch; slotIndex/32
> attestations
String
Verifications provided by the designated validator committee for the slot
> parentRoot
String
Root of the previous slot
> root
String
Root hash
> signature
String
Signature
> randaoReveal
String
Random number
> graffiti
String
Signature
> voluntaryExitsCount
String
Number of validator exits
> attestationCount
String
Verification count
> attesterSlashingCount
String
Number of penalties for validators
> l1BlockHash
String
ETH chain block height hash for this proposal
> l1DepositCount
String
Number of ETH staked
> l1DepositRoot
String
Root of the ETH stake
Beacon chain validator list query
Retrieve the validator list from the Beacon Chain, including active validators, validators pending for approval, and those who have exited. The data is updated every hour.
Consumption per query 1HTTP Request
GET /api/v5/explorer/beacon/beacon-validator-list
Sample Request
GET /api/v5/explorer/beacon/beacon-validator-list
Request Parameters
Parameter
Type
Required
Description
type
String
No
Types of validators: Active: active Pending: pending Exited: exited All: all Defaults to All if not specified
limit
String
No
Number of records returned. Default is the most recent 20 entries, with a maximum of 100.
page
String
No
Page number
Sample Response
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"validatorList": [
{
"index": "21958",
"pubkey": "0x91104f28e17de8c6bec26c5a8e64a149ba3ed2a35273197c33ed2f2bc74b8dbda96f9098517a6e946247c169c89deb34",
"holdingAmount": "68.7918",
"state": "online",
"totalIncome": "4.7918",
"proposals": "27",
"activationEpoch": "268",
"exitEpoch": "",
"withdrawalAmountEpoch": "",
"isSlashed": false
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
Number of records on the current page
totalPage
String
Total number of pages
validatorList
Array
List of validators
> index
String
Validator number
> pubkey
String
Validator's public key
> state
String
Validator's status - online: active in the last 2 Epochs, offline: inactive in the last 2 Epochs
> holdingAmount
String
Validator's balance in ETH
> totalIncome
String
Total income of the validator
> proposals
String
Number of blocks proposed
> activationEpoch
String
Epoch when the validator was activated; "0" for genesis block, "" if not activated
> exitEpoch
String
Epoch when the validator exited
> withdrawalAmountEpoch
String
Epoch when the balance was withdrawn
> isSlashed
Bol
Whether the validator was penalized; true for yes, false for no
Beacon chain validator details
Retrieve details of the validator on the beacon chain.
Consumption per query 1HTTP Request
GET /api/v5/explorer/beacon/beacon-validator-details
Sample Request
GET /api/v5/explorer/beacon/beacon-validator-details?index=21958
Request Parameters
Parameter
Type
Required
Description
index
String
Choose one
Validator index number
pubkey
String
Choose one
Validator public key
Response Sample
{
"code": "0",
"msg": "",
"data": [
{
"index": "21958",
"pubkey": "0x91104f28e17de8c6bec26c5a8e64a149ba3ed2a35273197c33ed2f2bc74b8dbda96f9098517a6e946247c169c89deb34",
"type": "active",
"beaconDepositsReceived": "64",
"holdingAmount": "68.79185725",
"totalIncome": "4.79185725",
"effectiveStakes": "32",
"address": "0x6282085170b2f3396fdccc2b5164fa70ee7c5192",
"deposits": "64",
"activationEpoch": "268",
"exitEpoch": "",
"eligibleEpoch": "41"
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of data items on the current page
totalPage
String
Total number of pages
validatorList
Array
List of validators
> index
String
Validator index number
> pubkey
String
Validator public key
> type
String
Types of validators: Active: active Pending: pending Exited: exited All: all Defaults to All if not specified
> beaconDepositsReceived
String
Total staked amount received by the beacon chain
> holdingAmount
String
Validator balance in ETH
> totalIncome
String
Total income of the validator
> effectiveStakes
String
Effective staked amount, ETH deposits visible and accepted by beacon chain nodes, updated every hour
> address
String
Validator address
> deposits
String
ETH deposits
> activationEpoch
String
Epoch when the validator was activated; "0" for genesis block, "" if not activated
> exitEpoch
String
Epoch when the validator exited
> eligibleEpoch
String
Epoch when the validator was eligible
|
Staking record list of the Beacon chain
Retrieve the staking record data of the beacon chain.
HTTP Request
GET /api/v5/explorer/beacon/beacon-deposit-list
Consumption per query 1
Request Example
GET /api/v5/explorer/beacon/beacon-deposit-list?index=21958&limit=1
Request Parameters
Parameter
Type
Required
Description
index
String
No
Corresponding validator number.
pubkey
String
No
Corresponding validator public key.
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "2",
"depositList": [
{
"epoch": "40",
"slot": "1293",
"state": "active",
"index": "21958",
"pubkey": "0x91104f28e17de8c6bec26c5a8e64a149ba3ed2a35273197c33ed2f2bc74b8dbda96f9098517a6e946247c169c89deb34",
"time": "1606839539000",
"beaconDepositsReceived": "32",
"withdrawalCredential": "0x00f2c769bafa58cd7e973c597e69d73f9cc6624296f5ff6bb3aa359cb3db5a04"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of records on the current page
totalPage
String
Total number of pages
depositList
Array
List of staking records
> epoch
String
Epoch to which the slot belongs
> slot
String
Slot number
> state
String
Validator status deposited: Staking, user staked 32 or more ETH in the ETH 1.0 staking contractpending: Waiting for confirmation. After Beacon receives the deposit, based on the total number of deposits, users have to wait in a queue for approval. Six validators are approved per epoch.active: The user is activated and can serve as a validator to verify slots in the Beacon network.exited: The user has exited. Either due to a previous violation or because they chose to exit (voluntarily), they cant continue verifying slots in the Beacon network.
> index
String
Corresponding validator number
> pubkey
String
Corresponding validator public key
> time
String
Time of staking
> beaconDepositsReceived
String
Total staked amount received by the beacon chain
> withdrawalCredential
String
Withdrawal certificate
Beacon chain withdrawal record query
Retrieve withdrawal record data from the Beacon Chain.
Consumption per query 1HTTP Request
GET /api/v5/explorer/beacon/beacon-withdrawal-list
Sample Request
GET /api/v5/explorer/beacon/beacon-withdrawal-list?index=535309&limit=1
Request Parameters
Parameter Name
Type
Required
Description
index
String
No
Corresponding validator number.
pubkey
String
No
Corresponding validator's public key.
limit
String
No
Number of records returned. Default is the last 20, up to 100.
page
String
No
Page number.
Sample Response
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "35",
"withdrawalList": [
{
"epoch": "236653",
"slot": "7572896",
"state": "active",
"index": "535309",
"pubkey": "0xb54d8183c989e51259ba93695a0b4584fec1b839b8ffbbc9e1925c8aa68221fbbe036657a2b409d03b2f4df85bb1afa9",
"time": "1697698775000",
"beaconWithdrawalReceived": "0.01681278",
"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
"withdrawalCredential": "0x010000000000000000000000b9d7934878b5fb9610b3fe8a5e441e8fad7e293f"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
Number of records on the current page
totalPage
String
Total number of pages
withdrawalList
Array
List of staking records
> epoch
String
Epoch to which the slot belongs
> slot
String
Slot number
> state
String
Validator status: deposited: Staked on the ETH1.0 staking contract with 32+ ETHpending: Waiting for confirmation after Beacon received the deposit. Based on the total deposit amount, users need to queue for approval. Six validators are approved per epoch.active: The user has been activated and can serve as a validator on the Beacon network to validate slots.exited: The user has exited due to past violations or voluntary exit and cannot continue to validate slots on the Beacon network.
> index
String
Corresponding validator number
> pubkey
String
Corresponding validators public key
> time
String
Time of staking
> beaconWithdrawalReceived
String
Total withdrawal amount received by the beacon chain
> address
String
Validator address
> withdrawalCredential
String
Withdrawal credential
Beacon Chain Withdrawal Credentials Information
Get the basic information by withdrawal credentials on the beacon chain.
Consumption per query 1HTTP Request
GET /api/v5/explorer/beacon/beacon-withdrawal-credentials
Sample Request
GET /api/v5/explorer/beacon/beacon-withdrawal-credentials?withdrawalCredential=0x0100000000000000000000004f13d70f72292e699fbb420003caff2778c18f70
Request Parameters
Parameter
Type
Required
Description
withdrawalCredentials
String
Yes
Withdrawal credential.
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Sample
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "2324",
"validatorList": [
{
"index": "19782",
"pubkey": "0x8313ce1237ff07c6afed630608e339034e76a9a396ab146401ed34abb957a30079d5f2b4d126e8a8e3f1c5c415361ec3",
"activationEpoch": "0",
"balance": "32.00239377",
"effectiveBalance": "32.00239377",
"voteEpoch": "237771",
"exitEpoch": "",
"slashed": "false",
"proposal": "38",
"status": "active_ongoing",
"withdrawalCredential": "0x010000000000000000000000347a70cb4ff0297102dc549b044c41bd61e22718"
}
]
}
]
}
Return Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
validatorList
Array
ValidatorList
> index
String
Validator index number
> pubkey
String
Number of data items on the current page
> withdrawalCredential
String
Withdrawal credential.
> activationEpoch
String
Epoch when the validator was activated; "0" for genesis block, "" if not activated
> exitEpoch
String
Epoch when the validator exited
> balance
String
balance
> effectiveBalance
String
Effective balance
> voteEpoch
String
Vote epoch
> proposals
String
Number of blocks produced
> status
String
status
> slashed
Bol
Whether the validator was penalized: true for yes, false for no
StarkNet
These endpoints from this module retrieve transaction data and token data for the StarkNet chain
Query StarkNet block header details
Get the block details of StarkNet chain.
HTTP Request
GET /api/v5/explorer/block/detail-starknet
Consumption per query 1
Request Example
GET /api/v5/explorer/block/detail-starknet?chainShortName=starknet&height=305653
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
height
String
Yes
Block height
Response Example
{
"code": "0",
"msg": "",
"data": {
"blockHash": "0x0077befc73fba1983eeb0cc421266af52c63cdaece8a49c2e5c91cb4942ec16f",
"height": "305653",
"status": "ACCEPTED_ON_L1",
"parentBlockHash": "0x0714623a72e27a1631ec9acac8f46e31409327913388c9a46b6fb88e95f040c1",
"blockTime": "1696831933",
"stateRoot": "0x372db6f7b7bd72396215035b7ff7f6eb7589a4f9cb249b5ae4fedd0ab1fbf5e",
"sequencerAddress": "0x01176a1bd84444c89232ec27754698e5d2e7e1a7f1539f12027f28b23ec9f3d8",
"l1TransactionHash": "0x98c5cf7d0c457ecc238a9e75a688e715c11be3bdbf0b0d89bc216d7a5e91aae3",
"transactionAmount": "156",
"messageAmount": "3",
"eventAmount": "792"
}
}
Response Parameters
Parameter
Type
Description
blockHash
String
Block hash
height
String
Block height
blockTime
String
The Unix timestamp for when the block was validated, in milliseconds format, e.g., 1597026383085.
parentBlockHash
String
The parent block hash of thin block
stateRoot
String
State commitment after the block
sequencerAddress
String
The address of sequencer
status
String
The status of block
transactionAmount
String
The number of transactions contained in the block
messageAmount
String
The number of message contained in the block
eventAmount
String
The number of event contained in the block
l1TransactionHash
String
L1 transaction hash
Query StarkNet block transaction list
Get the list of transactions in a block under the StarkNet.
HTTP Request
GET /api/v5/explorer/block/transaction-list-starknet
Consumption per query 1
Request Example
GET /api/v5/explorer/block/transaction-list-starknet?chainShortName=starknet&height=305653&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
height
String
Yes
Block height
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "156",
"transactionList": [
{
"txId": "0x04e055fb82640d74576b107135e69535aa26ca17f1d1071c77281b5121bee531",
"blockHash": "0x0077befc73fba1983eeb0cc421266af52c63cdaece8a49c2e5c91cb4942ec16f",
"height": "305653",
"transactionTime": "1696831933",
"transactionType": "INVOKE",
"transactionStatus": "ACCEPTED_ON_L1",
"address": "0x05dd2e71e9f4627b79e115e2c2267c1d528735faf870fe5e8e3a584577b40707"
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Block transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> address
String
The address in the transaction
> transactionType
String
The type of transaction
> transactionStatus
String
The status of transaction
Query StarkNet address token balance
Get Token Balance Detail for an StarkNet address to get information about the balance of all tokens on that address.（Currently only supports ERC20 tokens）
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/token-balance-starknet
Request Example
GET /api/v5/explorer/address/token-balance-starknet?address=0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0&chainShortName=starknet&protocolType=token_20
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
address
String
Yes
Address
protocolType
String
Yes
Contract protocol type token_20 token_721 token_1155
tokenContractAddress
String
No
Token Contract Address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "20",
"totalPage": "1",
"tokenList": [
{
"symbol": "ETH",
"holdingAmount": "0.09338760014159263",
"tokenContractAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7"
},
{
"symbol": "zETH",
"holdingAmount": "0.01200306543397489",
"tokenContractAddress": "0x01b5bd713e72fdc5d63ffd83762f81297f6175a5e0a4771cdadbc1dd5fe72cb1"
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenList
Array
Token list
> symbol
String
Token symbol
> tokenContractAddress
String
Token contract address
> holdingAmount
String
The holding amount of the token
Query StarkNet address normal transaction list
Get a list of common transactions associated with an StarkNet address.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/normal-transaction-list-starknet
Request Example
GET /api/v5/explorer/address/normal-transaction-list-starknet?limit=1&address=0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0&chainShortName=starknet
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
address
String
Yes
Address
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "23",
"transactionList": [
{
"txId": "0x008f40e4973d54ce0be584a851bd8dc9855c9b17277ea2cd3345ae73590af1ba",
"blockHash": "0x0394c76b5148ef928302baadf1ad981126a8c7861ba6cc0d7a245aa0041a9d24",
"height": "305222",
"transactionTime": "1696820202",
"transactionType": "INVOKE",
"transactionStatus": "ACCEPTED_ON_L2"
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txid
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> transactionType
String
The type of the transaction
> transactionStatus
String
The status of the transaction
Query StarkNet address token transaction list
Get a list of token trading transactions associated with the StarkNet address.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/token-transaction-list-starknet
Request Example
GET /api/v5/explorer/address/token-transaction-list-starknet?limit=1&address=0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0&chainShortName=starknet&protocolType=token_20
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
address
String
Yes
Address
protocolType
String
Yes
Contract protocol type token_20 token_721 token_1155
tokenContractAddress
String
No
Token contract address
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "66",
"transactionList": [
{
"txId": "0x008f40e4973d54ce0be584a851bd8dc9855c9b17277ea2cd3345ae73590af1ba",
"blockHash": "0x0394c76b5148ef928302baadf1ad981126a8c7861ba6cc0d7a245aa0041a9d24",
"height": "305222",
"transactionTime": "1696820202",
"from": "0x04270219d365d6b017231b52e92b3fb5d7c8378b05e9abc97724537a80e93b0f",
"to": "0x044a33f085b5ef75bde5df11d188e4c16db6c090f8c9c38c6020fbe6e24fcbc0",
"amount": "0.03156615266324224",
"symbol": "ETH"
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> from
String
Sender address
> to
String
Recipient address
> amount
String
Transaction amount
> symbol
String
Token symbol
Cosmos
Query basic information, block, address, transaction, and token data for COSMOS, KAVA, and EVMOS.
Query blockchain info
Query blockchain basic information. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/blockchain
Request Example
GET /api/v5/explorer/cosmos/blockchain?chainShortName=COSMOS
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"symbol": "ATOM",
"chainCosmosId": "cosmoshub-4",
"consensus": "POS",
"marketCap": "2964931888.81",
"tps": "0.88",
"lastBlockTime": "1703587500000",
"lastBlockHeight": "18446784",
"totalTransactionCount": "47637956",
"totalTransactionValue": "5134936965.921793",
"transactionValue24h": "124615822260.29991",
"totalAddresses": "2070187",
"activeValidators": "180",
"totalSupply": "380237029.903674",
"totalStaked": "242415216.719547",
"totalAsset": "13108",
"ibcTokens": "954"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. COSMOS HUB
chainShortName
String
The abbreviated name of the blockchain network, e.g. COSMOS
symbol
String
The native token symbol, e.g. ATOM
chainCosmosId
String
The ID of the blockchain network in the Cosmos ecosystem
consensus
String
Consensus algorithm, e.g. PoS
marketCap
String
Market cap of the chain
tps
String
Transactions per second, calculated with the average of nearly 10 blocks
lastBlockTime
String
The Unix timestamp for when the latest block was validated, in milliseconds format, e.g., 1597026383085.
lastBlockHeight
String
The latest block height
totalTransactionCount
String
Total number of transactions
totalTransactionValue
String
Total transaction value of transfers of on-chain native tokens
transactionValue24h
String
Transaction value of transfers of on-chain native tokens in the past 24 hours
totalAddresses
String
Total number of addresses on the blockchain
activeValidators
String
Total number of active addresses on the blockchain
totalSupply
String
Total supply of the native token
totalStaked
String
The amount of staked native token
totalAsset
String
Total number of assets on this blockchain
ibcTokens
String
Total number of assets received from other blockchain via IBC
Query block fills
Query block details of the public chains. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/block-fills
Request Example
GET /api/v5/explorer/cosmos/block-fills?chainShortName=COSMOS&height=17872234
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
height
String
Yes
Block height
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"hash": "81788E1AD853DB23EF1650A8EC270D6FEFE87B47116B75870214C53F3B8DA3AA",
"height": "17872234",
"validator": "cosmosvaloper14k4pzckkre6uxxyd2lnhnpp8sngys9m6hl6ml7",
"blockTime": "1700102295000",
"txnCount": "2",
"round": "0",
"mineReward": "12.274384",
"gasUsed": "615684",
"gasLimit": "666684",
"totalFee": "0.0028330000000000004"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. COSMOS HUB
chainShortName
String
The abbreviated name of the blockchain network, e.g. COSMOS
hash
String
Block hash
height
String
Block height
validator
String
Validator/Producer
blockTime
String
Time when the block was produced, Unix timestamp in millisecond format, e.g. 1597026383085
txnCount
String
The number of normal transactions contained in the block
round
String
Voting round
mineReward
String
Block reward
gasUsed
String
Actual amount of gas used
gasLimit
String
Gas limit
totalFee
String
The sum of all fees in the block, the unit is the native token of the chain
Query block transaction list
Get the list of transactions in a block under the blockchain. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/block-transaction-list
Request Example
GET /api/v5/explorer/cosmos/block-transaction-list?chainShortName=COSMOS&height=17872234
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
height
String
Yes
Block height
transactionListType
String
No
Transaction list type cosmos: cosmos transaction list of the block evm: EVM transaction list of the blockThe default is cosmos
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"cosmosTransactionList": [
{
"txId": "617533FA5F0BE0773E3AD2CA5665C90203DC5279D64FF879F2A68CFC335A268A",
"txType": "ibc.core.client.v1.MsgUpdateClient,ibc.core.channel.v1.MsgRecvPacket",
"state": "success",
"txFee": "0.000577"
},
{
"txId": "D7FD67D5CD73CC53F980122085AB859B27F26B1ADA2653777AA5D782A4945FB4",
"txType": "cosmos.gov.v1beta1.MsgVote",
"state": "success",
"txFee": "0.002256"
}
],
"evmTransactionList": []
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. COSMOS HUB
chainShortName
String
The abbreviated name of the blockchain network, e.g. COSMOS
cosmosTransactionList
Array
Cosmos transaction list of the block
> txId
String
Transaction hash
> txType
String
Transaction type, multiple transaction types are separated by comma
> state
String
Transaction state success fail
> txFee
String
Transaction fee, the unit is the native token of the chain
evmTransactionList
Array
EVM transaction list of the block, only for Kava and Evmos
> txId
String
Transaction hash
> methodId
String
Method ID
> state
String
Transaction state success fail
> from
String
From address
> isFromContract
Bol
Whether the from address is a contract address
> to
String
To address
> isToContract
Bol
Whether the to address is a contract address
> amount
String
The transaction amount of the native token
> txFee
String
Transaction fee, the unit is the native token of the chain
Query validator list
Get the list of validators. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/validator-list
Request Example
GET /api/v5/explorer/cosmos/validator-list?chainShortName=COSMOS&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
validatorAddress
String
Yes
Validator operator address
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "573",
"validatorList": [
{
"rank": "1",
"validatorName": "Coinbase Custody",
"validatorAddress": "cosmosvaloper1c4k24jzduc365kywrsvf5ujz4ya6mwympnc4en",
"votingPower": "0.0923",
"weight": "22371898.089718",
"blocks": "500896",
"participateProposals": "0",
"proposals": "152",
"uptime": "1",
"commission": "0.2",
"ownerAddress": "cosmos1c4k24jzduc365kywrsvf5ujz4ya6mwymy8vq4q",
"state": "active",
"bondedHeight": "0",
"website": "custody.coinbase.com",
"descriptions": "Coinbase Custody Cosmos Validator"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
validatorList
Array
Validator list
> rank
String
Voting power ranking of the validator
> validatorName
String
Validator name
> validatorAddress
String
Validator operator address
> votingPower
String
Voting power, the total amount of native tokens delegated by the validator accounts for the proportion of the total amount of native tokens delegated by all validators
> weight
String
The total amount of native tokens delegated by the validator
> blocks
String
The number of blocks generated
> participateProposals
String
The number of proposals that the validator participated in
> proposals
String
Total number of proposals
> uptime
String
The percentage of time the validator has been actively functioning in the last 100 blocks
> commission
String
Commission percentage
> ownerAddress
String
Owner address of the validator
> state
String
Validator status active, jailed, inactive
> bondedHeight
String
Delegation effective height
> website
String
Website of the validator
> descriptions
String
Description of the validator
Query address native token balance
Query the native token balance of an address. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/balance-cosmos
Request Example
GET /api/v5/explorer/address/balance-cosmos?chainShortName=cosmos&address=cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network,
address
String
Yes
Address
Response Example
{
"code": "0",
"msg": "",
"data": {
"address": "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8",
"availableBalance": "0.571788",
"delegated": "0",
"delegatedReward": "0",
"rewardRecipientAddress": "cosmos1gn52hszvhmhu64hs2mywfj7tr4ps6nwz0snht8",
"unbonding": "0",
"symbol": "ATOM",
"commission": "0",
"incentive": "",
"ethereumCoChainAddress": ""
}
}
Response Parameters
Parameter
Type
Description
address
String
Ordinary address
availableBalance
String
Available balance of the address
delegated
String
Delegated balance
delegatedReward
String
Delegated reward
rewardRecipientAddress
String
Reward recipient address
unbonding
String
Unbonding balance
symbol
String
Native token symbol of the chain
commission
String
Validator commission
incentive
String
Number of incentive tokens, only for Kava and Evmos
ethereumCoChainAddress
String
The contract address for interacting with the Ethereum main chain, only for Kava and Evmos
Query address token balance
Query for the token balance of an address. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/token-balance-detail-cosmos
Request Example
GET /api/v5/explorer/address/token-balance-detail-cosmos?chainShortName=kava&address=kava1wq9ts6l7atfn45ryxrtg4a2gwegsh3xha9e6rp&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network,
address
String
Yes
Address
tokenType
String
No
Token type, all Cosmos tokens are returned by default (including native tokens, LP tokens, IBC tokens, and BEP-3 bridged tokens). You can also filter by: nativeToken: native token lp: LP token ibc: IBC token bep: BEP-3 bridged token token_20: ERC-20 token, only for Kava and Evmos token_721: ERC-721 token, only for Kava and Evmostoken_1155: ERC-1155 token, only for Kava and Evmos
ibcDenom
String
No
Cross-chain token identifier, only for IBC token
denom
String
No
The smallest unit of a transaction request, only for Cosmos token
tokenContractAddress
String
No
Token contract address, only for ERC-20, ERC-721, ERC-1155 token
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "8",
"tokenList": [
{
"token": "debt",
"tokenType": "nativeToken",
"holdingAmount": "21618717436640",
"denom": "debt",
"ibcDenom": ""
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenList
Array
Token list
> token
String
Token symbol
> tokenType
String
nativeToken: native token lp: LP token ibc: IBC token bep: BEP-3 bridged token token_20: ERC-20 token, only for Kava and Evmos token_721: ERC-721 token, only for Kava and Evmostoken_1155: ERC-1155 token, only for Kava and Evmos
> holdingAmount
String
The holding amount of the token
> denom
String
The smallest unit of a transaction request, only for Cosmos token
> ibcDenom
String
Cross-chain token identifier, only for IBC token
Query address Cosmos transaction
Query for the Cosmos transactions of an address. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/address/normal-transaction-cosmos
Request Example
GET /api/v5/explorer/address/normal-transaction-cosmos?chainShortName=cosmos&address=cosmos1nvcgd368m4pm5mm3ppzawhsq6grra4ejnppplx&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network,
address
String
Yes
Address
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": {
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"symbol": "ATOM",
"txId": "779D81F33632B91EC2A58CDF79221FAAF357B89EFFA14300D1102DE8A7445DF6",
"blockHash": "1C1672F41EDAA2E1A8E816E885162658D178E0B28691715B97CA927EFF7E3F46",
"height": "18461766",
"transactionTime": "1703678689",
"from": [
"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl",
"cosmos1nvcgd368m4pm5mm3ppzawhsq6grra4ejnppplx"
],
"to": [
"cosmos1nvcgd368m4pm5mm3ppzawhsq6grra4ejnppplx"
],
"txFee": "0.004",
"gasLimit": "700000",
"gasUsed": "644948",
"type": [
"cosmos.staking.v1beta1.MsgDelegate"
],
"value": "0",
"state": "0"
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Page number
limit
String
Number of records per page, default min 20, max 100
totalPage
String
Total number of pages
transactionList
Array
List of transactions
> symbol
String
Symbol of the transaction token
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height of the transaction
> transactionTime
String
Transaction timestamp
> from
Array
Transaction sender's address
> to
Array
Transaction receiver's address
> txFee
String
Transaction fee
> gasLimit
String
Maximum gas amount
> gasUsed
String
Actual amount of gas used
> type
String
Transaction type
> value
String
Transaction value
> state
String
Transaction status: 0 for success, others for failed
Query transaction list
Get the list of transactions, only return the latest 10,000 transactions. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/transaction-list
Request Example
GET /api/v5/explorer/cosmos/transaction-list?chainShortName=cosmos&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
height
String
No
Block height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"transactionList": [
{
"txId": "8169A9D244F5D2478FA8C2D3496BB5BCE5B0D728A6BAA1E33DED085117569CF5",
"blockHash": "86177ABDBC145BFD4C4B3E71DF194866ADB95F716F3549655AAD9E6C8162A3A7",
"height": "18470022",
"transactionTime": "1703729095000",
"from": "cosmos13rsacl9a3r272fqhtw59zeawdpuxkj64cw9myq",
"to": "cosmos1j8pp7zvcu9z8vd882m284j29fn2dszh05cqvf9",
"isFromContract": false,
"isToContract": false,
"amount": "266.85",
"transactionSymbol": "ATOM",
"txFee": "0.002",
"transactionType": "cosmos.bank.v1beta1.MsgSend",
"state": "success"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. COSMOS HUB
chainShortName
String
The abbreviated name of the blockchain network, e.g. COSMOS
transactionList
Array
Transaction list
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height of the transaction
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> from
String
From address
> to
String
To address
> isFromContract
Bol
Whether the from address is a contract address
> isToContract
Bol
Whether the to address is a contract address
> amount
String
The transaction amount of the native token
> transactionSymbol
String
Token symbol of the transaction
> txFee
String
Transaction fee
> transactionType
String
Transaction type
> state
String
Transaction state success fail
Query token list
Get the list of tokens. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/token-list
Request Example
GET /api/v5/explorer/cosmos/token-list?chainShortName=cosmos&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
protocolType
String
No
Token type, all Cosmos tokens are returned by default (including native tokens, LP tokens, IBC tokens, and BEP-3 bridged tokens). You can also filter by: nativeToken: native token lp: LP token ibc: IBC token bep: BEP-3 bridged token token_20: ERC-20 token, only for Kava and Evmos token_721: ERC-721 token, only for Kava and Evmostoken_1155: ERC-1155 token, only for Kava and Evmos
denom
String
No
Cross-chain token identifier for IBC token, the smallest unit of a transaction request for other Cosmos tokens
tokenContractAddress
String
No
Token contract address, only for ERC-20, ERC-721, ERC-1155 token
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"tokenList": [
{
"tokenFullName": "ATOM",
"token": "ATOM",
"precision": "6",
"tokenContractAddress": "",
"protocolType": "nativeToken",
"addressCount": "1139570",
"totalSupply": "351129538.440699",
"circulatingSupply": "372198329",
"price": "12.064",
"website": "",
"totalMarketCap": "4597411775.6",
"transactionAmount24h": "7865935.1198792",
"denom": "uatom"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. COSMOS HUB
chainShortName
String
The abbreviated name of the blockchain network, e.g. COSMOS
tokenList
Array
Token list
> tokenFullName
String
Full name of the token
> token
String
Token name
> precision
String
Precision
> tokenContractAddress
String
Token contract address
> protocolType
String
Protocol type
> addressCount
String
The number of holders of the token
> totalSupply
String
Total supply
> circulatingSupply
String
Circulating supply
> price
String
Price, the unit is USD
> website
String
Website
> totalMarketCap
String
Total market cap
> transactionAmount24h
String
Transaction amount in the past 24 hours, the unit is USD, only for ERC-20 token and IBC token
> denom
String
Cross-chain token identifier for IBC token, the smallest unit of a transaction request for other Cosmos tokens
Query token position list
Get the list of token position. The supported chains are COSMOS, KAVA, EVMOS.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/token-position-list
Request Example
GET /api/v5/explorer/cosmos/token-position-list?chainShortName=cosmos&denom=uatom&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
denom
String
Either denom or tokenContractAddress must be chosen
Cross-chain token identifier for IBC token, the smallest unit of a transaction request for other Cosmos tokens
tokenContractAddress
String
Either denom or tokenContractAddress must be chosen
Token contract address, only for ERC-20, ERC-721, ERC-1155 token
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "COSMOS HUB",
"chainShortName": "COSMOS",
"circulatingSupply": "",
"positionList": [
{
"holderAddress": "cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh",
"amount": "241846712.302262",
"valueUsd": "2892970372.559658",
"positionChange24h": "-167045.82778599858",
"rank": "1"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. COSMOS HUB
chainShortName
String
The abbreviated name of the blockchain network, e.g. COSMOS
circulatingSupply
String
Circulating Supply
positionList
Array
Position List
> holderAddress
String
Holder Address
> amount
String
Holding amount
> valueUsd
String
Value of positions, unit: USD
> positionChange24h
String
24 hour position changes
> rank
String
Position ranking
Batch query token price
Batch query the price of up to 100 tokens. The price is the result of a comprehensive calculation of prices from multiple CEX and DEX. The supported chains are COSMOS, KAVA.
Consumption per query 1HTTP Request
GET /api/v5/explorer/cosmos/token-price-multi
Request Example
GET /api/v5/explorer/cosmos/token-price-multi?denom=uatom&chainShortName=cosmos
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. COSMOS, KAVA, EVMOS
denom
String
Either denom or tokenContractAddress must be chosen
Cross-chain token identifier for IBC token, the smallest unit of a transaction request for other Cosmos tokens
tokenContractAddress
String
Either denom or tokenContractAddress must be chosen
Token contract address, only for ERC-20, ERC-721, ERC-1155 token
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"lastPrice": "11.92",
"tokenContractAddress": "",
"denom": "uatom",
"priceAbnormal": []
}
]
}
Response Parameters
Parameter
Type
Description
lastPrice
String
The latest price of the token, updated every minute.
tokenContractAddress
String
Token Contract Address
denom
String
Cross-chain token identifier for IBC token, the smallest unit of a transaction request for other Cosmos tokens
priceAbnormal
String
Abnormal price typeLow Liquidity, Disparity Between Sources, Abnormal Fluctuation
Inscription
Query inscription token data, address holding data, and inscription transaction details of BRC-20, SRC-20, ARC-20 on the BTC chain. More public chains and inscription token protocols will be supported in the future.
Get list of inscription tokens
Query the list of inscription tokens, return a maximum of 10,000 data. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/token-list
Consumption per query 1
Request Example
GET api/v5/explorer/inscription/token-list?chainShortName=btc&protocolType=brc20&limit=1
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
tokenInscriptionId
String
No
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDFor ARC-20 tokens, enter the token's Atomical IDThis field is not required for other inscription tokens
symbol
String
No
For SRC-20 tokens, enter the token name
startTime
String
No
Query tokens issued after the Unix timestamp, in milliseconds format, e.g., 1597026383085. The "startTime" and "endTime" difference should not exceed one year.
endTime
String
No
Query tokens issued before the Unix timestamp, in milliseconds format, e.g., 1597026383085. The "startTime" and "endTime" difference should not exceed one year.
orderBy
String
No
deployTimeAsc: Sort results by ascending order, from oldest to newest based on deployment timedeployTimeDesc: Sort results by descending order, from newest to oldest based on deployment timeThe default is "deployTimeAsc"
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"tokenList": [
{
"symbol": "XTML",
"tokenInscriptionId": "e28210f430a66e68f1ac5a87a11701cd7062f191dcd67ca79b924d72413101f1i0",
"protocolType": "BRC20",
"totalSupply": "900000000",
"mintAmount": "18000",
"deployTime": "1708751674000",
"holder": "1",
"transactionCount": "3",
"circulatingSupply": "",
"mintBitwork": ""
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
tokenList
Array
List of tokens
> symbol
String
The token name
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor ARC-20 tokens, return the token's Atomical IDFor other inscription tokens, this field returns empty
> protocolType
String
Protocol type of the inscription token
> totalSupply
String
The maximum total supply
> mintAmount
String
The total quantity of tokens already minted
> deployTime
String
Token deployment date
> transactionCount
String
Total number of transactions
> holder
String
Number of addresses holding the token
> circulatingSupply
String
Circulating supply
> mintBitwork
String
Bitwork mining difficulty
Get list of addresses holding inscription tokens
Query a list of addresses holding inscription tokens, return a maximum of 10,000 data. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/token-position-list
Consumption per query 1
Request Example
GET api/v5/explorer/inscription/token-position-list?chainShortName=btc&protocolType=brc20&tokenInscriptionId=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0&limit=3
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
tokenInscriptionId
String
Yes when protocolType is BRC20 or ARC20
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDFor ARC-20 tokens, enter the token's Atomical IDThis field is not required for other inscription tokens
symbol
String
Yes when protocolType is SRC20
For SRC-20 tokens, enter the token name
holderAddress
String
No
Holder address
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "3",
"totalPage": "3334",
"positionList": [
{
"holderAddress": "bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d",
"amount": "8704276.68038247",
"rank": "1"
},
{
"holderAddress": "bc1qggf48ykykz996uv5vsp5p9m9zwetzq9run6s64hm6uqfn33nhq0ql9t85q",
"amount": "1675781.3938851",
"rank": "2"
},
{
"holderAddress": "bc1qm64dsdz853ntzwleqsrdt5p53w75zfrtnmyzcx",
"amount": "1121981.97971559",
"rank": "3"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
> holderAddress
String
Holder address
> amount
String
Holding quantity
> rank
String
Rank by holding quantity
Get list of inscription token transfers
Query the list of inscription token transfers based on transaction time, sorted from newest to oldest, with a maximum of 10,000 data. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/token-transaction-list
Consumption per query 1
Request Example
GET api/v5/explorer/inscription/token-transaction-list?chainShortName=btc&protocolType=brc20&tokenInscriptionId=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0&limit=1
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
tokenInscriptionId
String
Yes when protocolType is BRC20 or ARC20
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDFor ARC-20 tokens, enter the token's Atomical IDThis field is not required for other inscription tokens
symbol
String
Yes when protocolType is SRC20
For SRC-20 tokens, enter the token name
startTime
String
No
Query transactions after the Unix timestamp, in milliseconds format, e.g., 1597026383085. The "startTime" and "endTime" difference should not exceed one year.
endTime
String
No
Query transactions before the Unix timestamp, in milliseconds format, e.g., 1597026383085. The "startTime" and "endTime" difference should not exceed one year.
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"totalTransfer": "269839",
"transactionList": [
{
"txId": "0cf990907ef51eb0607f7fc6bb81809137d5750f4b64de9a8fc7917770bd1ad5",
"blockHash": "00000000000000000000256813d252f532a57f5473f2e723d8c7483a7df4d42f",
"height": "832486",
"transactionTime": "1709177741000",
"from": "",
"to": "bc1pqjwg8673seyk0t8jtz9j9g78uddps3cppd6nmnvjpp42sn22fqkqy8h700",
"amount": "141",
"symbol": "ordi",
"action": "inscribeTransfer",
"tokenInscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "0cf990907ef51eb0607f7fc6bb81809137d5750f4b64de9a8fc7917770bd1ad5i0",
"inscriptionNumber": "62753536"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g., Bitcoin.
chainShortName
String
The abbreviated name of the blockchain network, e.g., BTC.
transactionList
Array
List of transactions
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height at which the transaction occurred
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender(s), multiple addresses separated by commas
> to
String
Recipient(s), multiple addresses separated by commas
> amount
String
Transaction quantity.
> symbol
String
The token name
> action
String
Transaction type: "deploy", "mint", "inscribeTransfer", "transfer"
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor ARC-20 tokens, return the token's Atomical IDFor other inscription tokens, this field returns empty
> protocolType
String
Protocol type of the inscription token
> state
String
Transaction status types include: "success" and "fail".
> inscriptionId
String
Inscription ID involved in the transaction
> inscriptionNumber
String
Inscription number involved in the transaction
Get list of inscriptions
Query the list of inscriptions, returned in descending order based on the "inscriptionNumber", with a maximum of 10,000 data. The supported tokens are BRC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/inscription-list
Consumption per query 1
Request Example
GET /api/v5/explorer/inscription/inscription-list?chainShortName=btc&protocolType=brc20&limit=1
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20
tokenInscriptionId
String
No
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDThis field is not required for other inscription tokens
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"inscriptionList": [
{
"inscriptionId": "03fbeb834260fed03f87f0a09e06339379efc5fd3d6d08cc0a87451e509c32f1i0",
"inscriptionNumber": "62752328",
"tokenInscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"symbol": "ordi",
"state": "success",
"protocolType": "BRC20",
"action": "inscribeTransfer",
"ownerAddress": "bc1q6fh6ll49efsjrgcdwh7hp3cswt8faw85agghkk"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
inscriptionList
Array
List of inscriptions
> inscriptionId
String
Inscription ID
> inscriptionNumber
String
Inscription number
> symbol
String
The token name
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor other inscription tokens, this field returns empty
> state
String
Inscription status types include: "success" and "fail".
> protocolType
String
Protocol type of the inscription token
> action
String
Transaction type: "deploy", "mint", "inscribeTransfer", "transfer"
> ownerAddress
String
Address of the inscription owner
Get list of inscription tokens held by an address
Query the list of inscription tokens held by a specific address, return a maximum of 10,000 data. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET GET /api/v5/explorer/inscription/address-token-list
Consumption per query 1
Request Example
GET api/v5/explorer/inscription/address-token-list?chainShortName=btc&protocolType=brc20&address=bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d&limit=2
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
address
String
Yes
Address
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
tokenInscriptionId
String
No
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDFor ARC-20 tokens, enter the token's Atomical IDThis field is not required for other inscription tokens
symbol
String
No
For SRC-20 tokens, enter the token name
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "48",
"tokenList": [
{
"symbol": "GPTu",
"tokenInscriptionId": "b7456b7e688edea8fb814df146a83a062260b596616bfceff3ae2b9ceb8dbab2i0",
"holdingAmount": "8188888888888889300",
"inscriptionAmount": "2",
"availableAmount": "8188888888888889300",
"transferableAmount": "0"
},
{
"symbol": "arkg",
"tokenInscriptionId": "25e7f4ca11734aa1d1d8c9d9be262b8ea8b09a660a93a826084f7b21b3b41518i0",
"holdingAmount": "8000000000000000000",
"inscriptionAmount": "2",
"availableAmount": "8000000000000000000",
"transferableAmount": "0"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
tokenList
Array
List of tokens
> symbol
String
The token name
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor ARC-20 tokens, return the token's Atomical IDFor other inscription tokens, this field returns empty
> holdingAmount
String
Token holding amount = transferable balance + available balance
> availableAmount
String
The available balance represents the balance of mint-type tokens that are not directly transferable, which can be made transferable using the "inscribeTransfer" function. This parameter only applies to BRC-20 tokens.
> transferableAmount
String
The transferable balance. For "Transfer" type tokens, this balance is directly transferable. This parameter only applies to BRC-20 tokens.
> inscriptionAmount
String
Token inscription quantity
Get list of inscriptions held by an address
Query the list of inscriptions held by a specific address, returned in descending order based on the "inscriptionNumber", with a maximum of 10,000 data. The supported tokens are BRC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/address-inscription-list
Consumption per query 1
Request Example
GET /api/v5/explorer/inscription/address-inscription-list?chainShortName=btc&protocolType=brc20&address=bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d&limit=2
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
address
String
Yes
Address
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20
tokenInscriptionId
String
No
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDThis field is not required for other inscription tokens
symbol
String
No
The token name
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "2205",
"totalInscription": "4409",
"inscriptionList": [
{
"inscriptionId": "bca21f193e5f16a3fa1207df8021a5923539175e7bab92235c8a7e6ef9cf8db7i0",
"tokenInscriptionId": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"inscriptionNumber": "62748365",
"symbol": "ordi",
"state": "success",
"protocolType": "BRC20",
"action": "inscribeTransfer"
},
{
"inscriptionId": "e5bc024b23d6e3a2cb499300b34234a625ff2c1d70fa43a28d50250efba5c7d1i0",
"tokenInscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
"inscriptionNumber": "62748359",
"symbol": "sats",
"state": "success",
"protocolType": "BRC20",
"action": "inscribeTransfer"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
totalInscription
String
Total amount of inscriptions
inscriptionList
Array
List of inscriptions
> inscriptionId
String
Inscription ID
> inscriptionNumber
String
Inscription number
> symbol
String
The token name
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDThis field is not required for other inscription tokens
> state
String
Inscription status types include: "success" and "fail".
> protocolType
String
Protocol type of the inscription token
> action
String
Transaction type: "deploy", "mint", "inscribeTransfer", "transfer"
Get inscription token transfers by address
Query inscription token transfers for a specific address, returned in descending order based on transaction time, with a maximum of 10,000 data. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/address-token-transaction-list
Consumption per query 1
Request Example
GET /api/v5/explorer/inscription/address-token-transaction-list?chainShortName=btc&protocolType=brc20&address=bc1qvwqt8vtn2k7vrjqrsct63pkfw9ufqjldmjm439&limit=1
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
tokenInscriptionId
String
No
Inscription ID of the inscription tokenFor BRC-20 tokens, enter the token's Inscription IDFor ARC-20 tokens, enter the token's Atomical IDThis field is not required for other inscription tokens
symbol
String
No
For SRC-20 tokens, enter the token name
startTime
String
No
Query transactions after the Unix timestamp, in milliseconds format, e.g., 1597026383085. The "startTime" and "endTime" difference should not exceed one year.
endTime
String
No
Query transactions before the Unix timestamp, in milliseconds format, e.g., 1597026383085. The "startTime" and "endTime" difference should not exceed one year.
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "71",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"totalTransfer": "71",
"transactionList": [
{
"txId": "4cf9aefbc9febf80b68376fa773849aabfdd8e3f7a5254ad11fd7ec6c32d3e89",
"blockHash": "000000000000000000001765a54bc80e84b856d70a77884544839256b42e9a4e",
"height": "832015",
"transactionTime": "1708885500000",
"from": "",
"to": "bc1qvwqt8vtn2k7vrjqrsct63pkfw9ufqjldmjm439",
"amount": "5000",
"symbol": "SHNT",
"action": "inscribeTransfer",
"tokenInscriptionId": "4f54d82160bf08bab83bbe89276b2fd9bed514ce843c91a796daa07bafb85239i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "4cf9aefbc9febf80b68376fa773849aabfdd8e3f7a5254ad11fd7ec6c32d3e89i0",
"inscriptionNumber": "62377691"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g., Bitcoin.
chainShortName
String
The abbreviated name of the blockchain network, e.g., BTC.
totalTransfer
String
The total number of transfers for the token by the address
transactionList
Array
List of transactions
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height at which the transaction occurred
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender(s), multiple addresses separated by commas
> to
String
Recipient(s), multiple addresses separated by commas
> amount
String
Transaction quantity
> symbol
String
The token name
> action
String
Transaction type: "deploy", "mint", "inscribeTransfer", "transfer"
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor ARC-20 tokens, return the token's Atomical IDFor other inscription tokens, this field returns empty
> protocolType
String
Protocol type of the inscription token
> state
String
Transaction status types include: "success" and "fail".
> inscriptionId
String
Inscription ID involved in the transaction
> inscriptionNumber
String
Inscription number involved in the transaction
Get inscription token transaction details by transaction hash
Query details of inscription token transactions based on transaction hash. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/transaction-detail
Consumption per query 1
Request Example
GET /api/v5/explorer/inscription/transaction-detail?chainShortName=btc&protocolType=brc20&txId=c29fc5f33756c572fc55152435d9314059f8639797708b39471330536b94ed0c
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
txId
String
Yes
Transaction hash
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"transactionList": [
{
"txId": "c29fc5f33756c572fc55152435d9314059f8639797708b39471330536b94ed0c",
"blockHash": "0000000000000000000159cea4e78229ccffab8ecfa94354729ee2b0c52b7a3f",
"height": "831823",
"transactionTime": "1708779611000",
"from": "",
"to": "bc1qhuv3dhpnm0wktasd3v0kt6e4aqfqsd0uhfdu7d",
"amount": "2198220440",
"action": "inscribeTransfer",
"tokenInscriptionId": "9b664bdd6f5ed80d8d88957b63364c41f3ad4efb8eee11366aa16435974d9333i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "c29fc5f33756c572fc55152435d9314059f8639797708b39471330536b94ed0ci0",
"inscriptionNumber": "62184839",
"symbol": "sats"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
transactionList
Array
List of transactions
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height at which the transaction occurred
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender(s), multiple addresses separated by commas
> to
String
Recipient(s), multiple addresses separated by commas
> amount
String
Transaction quantity
> symbol
String
The token name
> action
String
Transaction type: "deploy", "mint", "inscribeTransfer", "transfer"
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor ARC-20 tokens, return the token's Atomical IDFor other inscription tokens, this field returns empty
> protocolType
String
Protocol type of the inscription token
> state
String
Transaction status types include: "success" and "fail".
> inscriptionId
String
Inscription ID involved in the transaction
> inscriptionNumber
String
Inscription number involved in the transaction
Get inscription token transaction details by block
Query inscription token transaction details based on block height, return a maximum of 10,000 data. The supported tokens are BRC-20, SRC-20, ARC-20 on the BTC chain.
HTTP Request
GET /api/v5/explorer/inscription/block-token-transaction
Consumption per query 1
Request Example
GET /api/v5/explorer/inscription/block-token-transaction?chainShortName=btc&protocolType=brc20&height=831823&limit=1
Request Parameters
Parameter Name
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g., BTC.
height
String
Yes
Block height
protocolType
String
Yes
Protocol type of the inscription tokenBRC-20 token: brc20SRC-20 token: src20ARC-20 token: arc20
page
String
No
Page number
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "559",
"totalTransfer": "559",
"transactionList": [
{
"txId": "5ac740cad1c29266bf3615fc4f108c082431c7c0be74944e352edd75eed471ff",
"blockHash": "0000000000000000000159cea4e78229ccffab8ecfa94354729ee2b0c52b7a3f",
"height": "831823",
"from": "",
"to": "bc1pnad2fk3fw6q3d20mhyacdekl7wf96rpg5yqxhtchzvpwet989lpsmvuc9n",
"amount": "1000",
"action": "mint",
"tokenInscriptionId": "4865f05b9132f12bb09d6215f13da5a304a502a95315d0a49463d6f8c0bb7740i0",
"protocolType": "BRC20",
"state": "success",
"inscriptionId": "5ac740cad1c29266bf3615fc4f108c082431c7c0be74944e352edd75eed471ffi0",
"inscriptionNumber": "62196529",
"symbol": "LABS",
"transactionTime": "1708779611000"
}
]
}
]
}
Response Parameters
Parameter Name
Type
Description
page
String
Current page number
limit
String
The number of results returned on the current page
totalPage
String
Total number of pages
totalTransfer
String
The total number of transfers for the token by this address
transactionList
Array
List of transactions
> txId
String
Transaction hash
> blockHash
String
Block hash
> height
String
Block height at which the transaction occurred
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085.
> from
String
Sender(s), multiple addresses separated by commas
> to
String
Recipient(s), multiple addresses separated by commas
> amount
String
Transaction quantity
> symbol
String
The token name
> action
String
Transaction type: "deploy", "mint", "inscribeTransfer", "transfer"
> tokenInscriptionId
String
Inscription ID of the inscription tokenFor BRC-20 tokens, return the token's Inscription IDFor ARC-20 tokens, return the token's Atomical IDFor other inscription tokens, this field returns empty
> protocolType
String
Protocol type of the inscription token
> state
String
Transaction status types include: "success" and "fail".
> inscriptionId
String
Inscription ID involved in the transaction
> inscriptionNumber
String
Inscription number involved in the transaction
Tether
These endpoints from this module retrieve issuance and redemption records for USDT on ETH, TRON and BTC.
Query USDT printing/destruction list
Get the issuance records of USDT on TRX, BTC, and ETH public chain networks
HTTP Request
GET /api/v5/explorer/stablecoin/printing-record
Consumption per query 1
Request Example
GET /api/v5/explorer/stablecoin/printing-record?stablecoinName=USDT&network=btc&type=printing&limit=1
Request Parameters
Parameter
Type
Required
Description
stablecoinName
String
Yes
Stablecoin name, e.g. USDT
network
String
Yes
The abbreviated name of the blockchain network all TRX ETH BTC USDT
type
String
Yes
Type printing destruction
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "83",
"recordList": [
{
"stablecoinName": "USDT",
"txid": "0c8c22ee5cd69649ff36c0396bb9ce951425614a32129d8d54c0144895ef4e7a",
"network": "BTC",
"height": "573063",
"amount": "300000000",
"sendAddress": "32TLn1WLcu8LtfvweLzYUYU6ubc2YV9eZs",
"receiveAddress": "1NTMakcgVwQpMdGxRQnFKyb3G1FAJysSfz",
"transactionTime": "1556131281000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
recordList
String
Printing/destruction list
> stablecoinName
String
Stablecoin name
> txid
String
Transaction hash
> network
String
The abbreviated name of the blockchain network
> height
String
Block height
> amount
String
The amount of stablecoin
> sendAddress
String
Send address
> receiveAddress
String
Receive address
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
POR
These endpoints from this module retrieve exchange reserve details, historical reserve records, and reserve breakdowns for top exchanges.
The supported exchanges for querying: Binance, OKX, Huobi, Bitget, KuCoin, Crypto.com, Bybit, Deribit, Bitfinex
Query proof of reserves
Get the latest proof of reserves data from centralized exchanges
HTTP Request
GET /api/v5/explorer/por/proof-of-reserves
Consumption per query 5
Request Example
GET /api/v5/explorer/por/proof-of-reserves
Request Parameters
Parameter
Type
Required
Description
institutionName
String
No
Exchange Name
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"institutionName": "OKX",
"totalBalance": "6502554504.391312",
"balanceDetails": [
{
"symbol": "ETH",
"balance": "1077119.4731584482",
"balanceUsd": "1354434652.7178226",
"change": "1"
},
{
"symbol": "USDT",
"balance": "3006224032.2949777",
"balanceUsd": "3006930041.122987",
"change": "1"
},
{
"symbol": "BTC",
"balance": "102951",
"balanceUsd": "1745781287.4",
"change": "1"
},
{
"symbol": "USDC",
"balance": "395343687.173071",
"balanceUsd": "395391628.917477",
"change": "1"
},
{
"symbol": "BUSD",
"balance": "16889.72009695",
"balanceUsd": "16894.233026629954",
"change": "1"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
institutionName
String
Exchange Name
totalBalance
String
Total exchange assets, unit: USDT
balanceDetails
Array
Asset detail list
> symbol
String
Token symbol
> balance
String
Token balance
> change
String
Last 7 days fund movement up or down, 0.1 means 10%
> balanceUsd
String
Token balance, unit: USDT
Query proof of reserves history
Get the history of the exchange proof of reserve.
HTTP Request
GET /api/v5/explorer/por/institution-history-asset
Consumption per query 5
Request Example
GET /api/v5/explorer/por/institution-history-asset?institutionName=Huobi
Request Parameters
Parameter
Type
Required
Description
institutionName
String
Yes
Exchange Name
time
String
No
History time, e.g:1670601600000
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"institutionName": "Huobi",
"balanceList": [
{
"chainShortName": "ETH",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"symbol": "USDT",
"balance": "583066271.058834",
"balanceUsd": "583066271.058834",
"time": "1670601600000"
},
{
"chainShortName": "ETH",
"tokenContractAddress": "0xb8c77482e45f1f44de1745f52c74426c631bdd52",
"symbol": "BNB",
"balance": "0.3",
"balanceUsd": "86.51097014666489",
"time": "1670601600000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
institutionName
String
Exchange name
balanceList
Array
Balance details
> chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
> tokenContractAddress
String
Token contract address
> symbol
String
Token symbol
> balance
String
Token balance
> balanceUsd
String
Token balance, unit: USDT
> time
String
History time
Query POR address list
Query the publicly disclosed POR address lists of a specific exchange on different chains, returning a maximum of 1000 addresses in descending order of asset amount. The supported chains are BTC, ETH, BSC, POLYGON, AVAXC, OP, ARBITRUM, BEACON, TRON.
Consumption per query 5HTTP Request
GET /api/v5/explorer/por/address-list
Request Example
GET /api/v5/explorer/por/address-list?institutionName=Binance
请求参数
Parameter
Type
Required
Description
institutionName
String
Yes
Exchange name
chainShortName
String
No
The abbreviated name of the blockchain network, e.g. BTC
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainShortName": "BTC",
"address": "3Jxc4zsvEruEVAFpvwj818TfZXq5y2DLyF"
}
]
}
Response Parameters
Parameter
Type
Description
chainShortName
String
The abbreviated name of the blockchain network,
address
String
POR address
Query address balance details
Query the asset details of the top 50 addresses in terms of capital volume of a specific exchange
HTTP Request
GET /api/v5/explorer/por/address-balance-details
Consumption per query 5
Request Example
GET /api/v5/explorer/por/address-balance-details?institutionName=Huobi
Request Parameters
Parameter
Type
Required
Description
institutionName
String
Yes
Exchange Name
page
String
No
Page
limit
String
No
Number of returned data, 10 by default, 50 at most
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "50",
"addressDetails": [
{
"balance": "248597.39260212",
"balanceUsd": "7658614453.111291",
"chainShortName": "BTC",
"symbol": "BTC",
"address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
"updateTime": "1698037200000"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
addressDetails
Array
Address details
> chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
> symbol
String
Token symbol
> balance
String
Token balance
> balanceUsd
String
Token balance, unit: USDT
> address
String
Address
> updateTime
String
The time when the data was last updated
Query asset flow of exchanges
Get the asset flow of exchanges in the past 30 days
HTTP Request
GET /api/v5/explorer/por/asset-flow
Consumption per query 1
Request Example
GET /api/v5/explorer/por/asset-flow?institutionName=Binance
Request Parameters
Parameter
Type
Required
Description
institutionName
String
No
Exchange name
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"institutionName": "Binance",
"startTime": "1698163200000",
"endTime": "1700755200000",
"symbol": "BTC,USDT,ETH,USDC",
"inFlow": [
{
"entities": "Binance",
"totalValue": 4895055579.856456080721,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 105218.90925652136260,
"usdValue": 6826324.548780690122
},
{
"symbol": "ETH",
"value": 230384927.744176925,
"usdValue": 455318082.704016072
},
{
"symbol": "USDT",
"value": 4124675775.9757988826,
"usdValue": 4126567904.5649451159
},
{
"symbol": "USDC",
"value": 306337238.601268376465,
"usdValue": 306343268.038714202699
}
]
},
{
"entities": "Kraken",
"totalValue": 2894665874.143568113741,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 52334363.306053193576688,
"usdValue": 2894665874.143568113741
}
]
},
{
"entities": "Coinbase",
"totalValue": 1944412213.245690277,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 33499351.06362882384,
"usdValue": 1944412213.245690277
}
]
},
{
"entities": "Non institutional",
"totalValue": 61097057433.775659899517,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 378177025.504197862,
"usdValue": 22381646937.37760093
},
{
"symbol": "ETH",
"value": 420463853.748517634609,
"usdValue": 6353422752.5202973257
},
{
"symbol": "USDT",
"value": 26476640510.29366205403,
"usdValue": 26486442857.38710407426
},
{
"symbol": "USDC",
"value": 5875372621.385650664061,
"usdValue": 5875544886.490657569557
}
]
},
{
"entities": "OTHER",
"totalValue": 5925062015.982478217526750,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 96695995.98055366673561927,
"usdValue": 5629851813.752190546446854
},
{
"symbol": "ETH",
"value": 4235.11820857,
"usdValue": 1888578.92583743166001
},
{
"symbol": "USDT",
"value": 253435373.5741789998,
"usdValue": 253514589.37770223841989
},
{
"symbol": "USDC",
"value": 39806633.34,
"usdValue": 39807033.926748000999996
}
]
}
],
"outflow": [
{
"entities": "Binance",
"totalValue": 25880519279.34233794684659,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 446979843.069527148,
"usdValue": 25758813304.31752274
},
{
"symbol": "ETH",
"value": 241651.542300100004,
"usdValue": 102488438.639715334575
},
{
"symbol": "USDT",
"value": 9683786.116047718969,
"usdValue": 9687369.62429497364399
},
{
"symbol": "USDC",
"value": 9529232.797039480002,
"usdValue": 9530166.7608048986276
}
]
},
{
"entities": "OKX",
"totalValue": 1778131903.198936031468086,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 27229581.83959817462,
"usdValue": 1625828865.799360377
},
{
"symbol": "ETH",
"value": 27502583.2804187682,
"usdValue": 40166453.3014638396
},
{
"symbol": "USDT",
"value": 109012875.6836676494974,
"usdValue": 109066623.358723094326326
},
{
"symbol": "USDC",
"value": 3069684.019895000061435,
"usdValue": 3069960.73938872054176
}
]
},
{
"entities": "Bybit",
"totalValue": 165499102.316852054127908,
"tokenFlowDetailList": [
{
"symbol": "ETH",
"value": 1154670.49264628987,
"usdValue": 5261706.95908915983
},
{
"symbol": "USDT",
"value": 125986732.81877199220003,
"usdValue": 126032425.899575876057908
},
{
"symbol": "USDC",
"value": 34203788.99158674844,
"usdValue": 34204969.45818701824
}
]
},
{
"entities": "Non institutional",
"totalValue": 43553300007.536882798703,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 32883243.02858405587,
"usdValue": 1876226041.101757367
},
{
"symbol": "ETH",
"value": 380488212.12212643767,
"usdValue": 6943686548.344351922
},
{
"symbol": "USDT",
"value": 28554661639.94832429986,
"usdValue": 28565426281.90919205095
},
{
"symbol": "USDC",
"value": 6167752794.3580837402978,
"usdValue": 6167961136.181581458753
}
]
},
{
"entities": "OTHER",
"totalValue": 505335352.4121178055108002,
"tokenFlowDetailList": [
{
"symbol": "BTC",
"value": 10008.386152673052149,
"usdValue": 561052.14232849779361
},
{
"symbol": "ETH",
"value": 5476601.371627149954682053,
"usdValue": 26217318.248646359432310
},
{
"symbol": "USDT",
"value": 460278302.522870445258762,
"usdValue": 460468089.9823136189277595
},
{
"symbol": "USDC",
"value": 18087770.97845448987203,
"usdValue": 18088892.0388293293571207
}
]
}
]
}
]
}
Response Parameters
Parameter
Type
Description
institutionName
String
Exchange name
startTime
String
Start time
endTime
String
End time
symbol
String
Symbols participating in the calculation
inFlow
Array
inflow list
> entities
String
Entity name
> totalValue
String
Total usd value
> tokenFlowDetailList
Array
Token flow list
>> symbol
String
Symbol
>> value
String
The amount of tokens
>> usdValue
String
The USD value of tokens
NFT API
These endpoints from this module retrieve NFT data such as NFT's attributes, NFT rarity, floor price and other related information.
Chain list
Get the list of public chains supported by the API interface of the NFT module
HTTP Request
GET /api/v5/explorer/nft/chain-list
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/chain-list
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
No
The abbreviated name of the blockchain network
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Ethereum",
"chainShortName": "ETH"
},
{
"chainFullName": "Polygon",
"chainShortName": "POLYGON"
},
{
"chainFullName": "Optimism",
"chainShortName": "OPTIMISM"
},
{
"chainFullName": "OKT Chain",
"chainShortName": "OKTC"
},
{
"chainFullName": "Avalanche-C",
"chainShortName": "AVAXC"
},
{
"chainFullName": "ARBITRUM",
"chainShortName": "ARBITRUM"
},
{
"chainFullName": "BNB Chain",
"chainShortName": "BSC"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
NFT market overview
Get chain-wide NFT market data overview data.
HTTP Request
GET /api/v5/explorer/nft/nft-stats-overview
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/nft-stats-overview
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"totalMarketCap": "25854298568.561043",
"totalHolder": "14315586",
"dailyTradingVolume": "8816152.74027341",
"dailyTransaction": "30656"
}
]
}
Response Parameters
Parameter
Type
Description
totalMarketCap
String
Total NFT market value of all the network, in USD
totalHolder
String
Total number of addresses held NFT of all the network
dailyTradingVolume
String
Total daily transaction volume of all the network, in USD
dailyTransaction
String
Number of NFT daily transactions of all the network
Collection info
Gets the overview information of the collection. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/collection-info
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/collection-info?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"collectionName": "BoredApeYachtClub",
"token": "BAYC",
"protocolType": "token_721",
"website": "",
"createContractAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
"collectionType": "top_collectibles",
"totalSupply": "10000",
"collectionLogoUrl": "https://static.coinall.ltd/cdn/nft/files/collection/205-logo.webp"
}
]
}
Response Parameters
Parameter
Type
Description
collectionName
String
Collection name
collectionLogoUrl
String
Collection logo
tokenContractAddress
String
Contract address for the collection
token
String
Token name
protocolType
String
Protocol type: token_721, token_1155
website
String
Official website of the collection
creatContractAddress
String
Creat contract address
collectionType
String
Collection type: art sports music domain_names virtual_places trading_cards top_collectibles utility_nfts
totalSupply
String
NFT total supply
Collection details
Get detailed information about the collection, including the floor price, etc. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/collection-details
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/collection-details?chainShortName=ETH&tokenContractAddress=0xed5af388653567af2f388e6224dc7c4b3241c544
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"collectionName": "BoredApeYachtClub",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"totalSupply": "10000",
"holder": "5537",
"avgPrice": "39335.9037",
"transactionNumber": "156",
"activeUser": "67",
"transactionVolume": "1927459.2813000001",
"transactionVolumeUsd": "2992611829.332006",
"floorPrice": "24.38995001",
"lastPrice": "26.9",
"collectionLogoUrl": "https://static.coinall.ltd/cdn/nft/files/collection/205-logo.webp"
}
]
}
Response Parameters
Parameter
Type
Description
collectionName
String
Collection name
tokenContractAddress
String
Contract address for the collection
totalSupply
String
Total supply
holder
String
Number of NFT holders
avgPrice
String
Avg price
transactionNumber
String
Daily Number of transactions
activeUser
String
Number of daily active users
transactionVolume
String
Daily transaction amount
transactionVolumeUsd
String
Daily transaction amount in USDT
floorPrice
String
Floor price
lastPrice
String
Last price
collectionLogoUrl
String
Collection logo
Collection NFT list
Get the NFT list of the collection. The supported chains are ETH, OKTC, BSC, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/collection-nft-list
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/collection-nft-list?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
filterType
String
No
Filter type: maximum_number_of_transfer price_high price_low latest_transaction_time maximum_number_of_transfer
tokenId
String
No
NFT token ID
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10002",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"totalSupply": "10000",
"nftList": [
{
"tokenId": "2779",
"holdingAddressAmount": "1",
"logoUrl": "/nft/files/c34da970-16ba-44b0-8892-bd05d24a350c.webp",
"protocolType": "token_721",
"lastTransactionTime": "1697631959000",
"lastPrice": "24",
"lastPriceUnit": "ETH",
"transactionCount": "202",
"mintTime": "1631463135000",
"title": "Bored Ape Yacht Club #2779"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenContractAddress
String
Contract address for the collection
totalSupply
String
NFT total supply
nftList
Array
NFT list
> tokenId
String
NFT token id
> holdingAddressAmount
String
Number of addresses holding this NFT
> logoUrl
String
NFT logo
> protocolType
String
NFT protocol type
> lastTransactionTime
String
Latest transaction time, Unix timestamp in millisecond format, e.g. 1597026383085
> lastPrice
String
The latest price of this NFT
> lastPriceUnit
String
The price corresponds to the counting unit
> transactionCount
String
Number of times this NFT has been traded
> mintTime
String
Mint time for this NFT
> title
String
The 'name' attribute in the metadata of this NFT, which can obtain ENS or DID.
Position list
List of position addresses in the collection. ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/token/position-list
Consumption per query 1
Request Example
GET /api/v5/explorer/token/position-list?chainShortName=eth&tokenContractAddress=0x495f947276749ce646f68ac8c248420045cb7b5e
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
holderAddress
String
No
Collection holder address
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"chainFullName": "Ethereum",
"chainShortName": "ETH",
"circulatingSupply": "1005858",
"positionList": [
{
"holderAddress": "0x000000000000000000000000000000000000dead",
"amount": "1109086708481",
"valueUsd": "",
"positionChange24h": "",
"rank": "1"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
circulatingSupply
String
Collection circulating supply
positionList
Array
Collection position list
> holderAddress
String
Holder address
> amount
String
Number of NFTs held by the address
> valueUsd
String
Position value in usd
> positionChange24h
String
24-hour position change
> rank
String
Holding amount rank
Collection floor price
Retrieve the floor price of the collection across various NFT marketplaces. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/collection-floor-price
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/collection-floor-price?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
tokenContractAddress
String
Yes
Contract address for the collection
marketplace
String
No
Project's NFT marketplace OpenSea LooksRare X2Y2 Blur CryptoPunks okx
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"marketplace": "OKX",
"floorPrice": "200",
"priceSymbol": "ETH",
"updateTime": "1697542101000"
},
{
"marketplace": "X2Y2",
"floorPrice": "26.98",
"priceSymbol": "ETH",
"updateTime": "1697470407000"
},
{
"marketplace": "LooksRare",
"floorPrice": "26.349",
"priceSymbol": "ETH",
"updateTime": "1697701282000"
},
{
"marketplace": "Blur",
"floorPrice": "24.65",
"priceSymbol": "ETH",
"updateTime": "1697701832000"
},
{
"marketplace": "OpenSea",
"floorPrice": "26.349",
"priceSymbol": "ETH",
"updateTime": "1697701278000"
}
]
}
Response Parameters
Parameter
Type
Description
marketplace
String
Project's NFT marketplace
floorPrice
String
Floor price of the project
priceSymbol
String
Unit of the floor price
update
String
Update time for the floor price data
NFT details
Get detailed information about a particular NFT, including the floor price, attributes and rarity of the attributes. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/nft-details
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/nft-details?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
tokenId
String
Yes
NFT token ID
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"collectionName": "BoredApeYachtClub",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "3481",
"protocolType": "token_721",
"token": "BAYC",
"ownerAddress": "0x7285e8f0186a0a41e73cef7603ad7b80a2d5a793",
"logoUrl": "https://static.oklink.com/cdn/nft/files/d7169236-7cbb-4776-8a4c-3ef358f01fc9.webp",
"lastPrice": "0",
"lastPriceUnit": "ETH",
"lastTransactionTime": "1628951146000",
"lastHeight": "13023815",
"lastTxid": "0x7e91013ab5bc0b336f57696dc6cbc7b631127fc0996bab9e10c6657ff09eec9a",
"transactionCount": "66",
"minterAddress": "0xee402489d83e2b22d496910f8c810d35a3ad7b25",
"mintTime": "1619853826000",
"floorPrice": "24.38995001",
"title": "Bored Ape Yacht Club #3481",
"attributes": [
{
"traitType": "Background",
"value": "Gray",
"prevalence": "0.117"
},
{
"traitType": "Clothes",
"value": "Striped Tee",
"prevalence": "0.0412"
},
{
"traitType": "Eyes",
"value": "Bloodshot",
"prevalence": "0.0846"
},
{
"traitType": "Fur",
"value": "Gray",
"prevalence": "0.0496"
},
{
"traitType": "Hat",
"value": "Halo",
"prevalence": "0.0324"
},
{
"traitType": "Mouth",
"value": "Bored Unshaven",
"prevalence": "0.1551"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
collectionName
String
Collection name
tokenContractAddress
String
Contract address for the collection
tokenId
String
NFT token id
protocolType
String
Protocol type of the collection
token
String
Token name
ownerAddress
String
NFT owner address
logoUrl
String
NFT logo url
lastPrice
String
NFT last price
floorPrice
String
Floor price
lastPriceUnit
String
Unit of measurement of last prices\
lastTransactionTime
String
Latest transaction time, Unix timestamp in millisecond format, e.g. 1597026383085
lastHeight
String
Block height of the latest transaction
lastTxid
String
Last transaction hash of the NFT
transactionCount
String
Transaction count of this NFT
minterAddress
String
The mint address of this NFT
storageMethod
String
The storage method of this NFT
mintTime
String
Mint time of this NFT
attributes
Array
Attributes of this NFT
title
String
The 'name' attribute in the metadata of this NFT, which can obtain ENS or DID.
> traitType
String
Trait type
> value
String
Trait value
> prevalence
String
Rarity of the attribute, expressed as a decimal, 0.1 = 10%
Historical transactions of the NFT
Get the list of NFT holder addresses. ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/nft-owner-address
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/nft-owner-address?chainShortName=ETH&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
tokenId
String
Yes
NFT token id
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"positionList": [
{
"ownerAddress": "0x7285e8f0186a0a41e73cef7603ad7b80a2d5a793",
"logoUrl": "https://static.oklink.com/cdn/nft/files/d7169236-7cbb-4776-8a4c-3ef358f01fc9.webp",
"amount": "1"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
positionList
Array
List of addresses holding this nft
> ownerAddress
String
Holder address of this nft
> logoUrl
String
NFT's logo
> amount
String
Number of NFTs held by this address
NFT trader history
Get nft trade history. ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/nft-trade-history
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/nft-trade-history?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481&activeType=sale&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Contract address for the collection
tokenId
String
Yes
NFT token id
activeType
String
Yes
Type of transaction: mint (creation), transfer, sale (completion)
page
String
No
Page number
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "0",
"collectionName": "Bored Ape Yacht Club",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "3481",
"token": "BAYC",
"historyList": [
{
"amount": "1",
"createTime": "1685730899000",
"fromAddress": "0x4341f1bdd076760013ffc1aeff9fcf1c2c815fab",
"toAddress": "0x5f90dc9735d752e8ef296c045f66efc788a01126",
"price": "45.8640199999999965",
"priceSymbol": "ETH",
"usdPrice": "86760.5079937999981",
"marketplace": "LooksRare",
"actveType": "sale",
"txId": "0x2e925d817680ca70eb46e49f919b1406b86470fa10d50ce1649f57d3615a7bd9",
"invalid": false
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of results on the current page
totalPage
String
Total number of pages
collectionName
String
Full collection name
tokenContractAddress
String
Project contract address
tokenId
String
NFT token ID
token
String
Token name
logoUrl
String
Image link for the NFT
historyList
Array
Historical transaction list
> amount
String
Transaction amount
> createTime
String
Transaction creat time. Timestamp in milliseconds
> fromAddress
String
NFT sending address
> toAddress
String
NFT receiving address
> price
String
Transaction price
> priceSymbol
String
Price unit (e.g., ETH)
> usdPrice
String
Price in USD
> marketplace
String
Trading platform, e.g., LooksRare
> activeType
String
Type of transaction: mint, transfer, sale
> txId
String
Transaction hash
> invalid
Bool
Whether the transaction has expired (true or false)
Retrieve NFT offer list
Fetches the offer list for a specific NFT, displaying the order data of the specified NFT in various marketplaces. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/nft-offers-list
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/nft-offers-list?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=3481&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Collection contract address.
tokenId
String
Yes
NFT token ID.
marketplace
String
No
NFT trading platforms (e.g., OpenSea, LooksRare, etc.)
page
String
No
Page number
limit
String
No
Number of results returned, max 100 per page, default is 20
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "140",
"collectionName": "Bored Ape Yacht Club",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "3481",
"token": "BAYC",
"offerList": [
{
"amount": "1",
"createTime": "1683990533000",
"validTime": "1699542522000",
"price": "1",
"priceSymbol": "WETH",
"priceSymbolContractAddress": "",
"orderHash": "0x9fe5e206029ad24c077ca696b43218b7e236d0c871d07aa94f5367208bb9989e",
"ownerAddress": "0xf0ae1a04481a894ecd3dd231af914572bc289935",
"marketplace": "OKX",
"usdPrice": "1919.76"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of entries on the current page
totalPage
String
Total number of pages
collectionName
String
Full collection name
tokenContractAddress
String
Collection contract address
tokenId
String
NFT token ID
token
String
Token name
offerList
Array
List of bids
> amount
String
Offer amount
> createTime
String
Order create time (timestamp in milliseconds)
> validTime
String
Expiry time of the bid
> price
String
Bid price
> priceSymbol
String
Price unit
> priceSymbolContractAddress
String
Contract address of the price unit
> orderHash
String
Order hash
> ownerAddress
String
Bid order address
> marketplace
String
Trading platform (e.g., LooksRare)
> usdPrice
String
Value of the bid in USD
Retrieve NFT listing list
Fetches the listing list for a specific NFT, displaying the order data of the specified NFT in various marketplaces. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/nft-listing-list
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/nft-listing-list?chainShortName=eth&tokenContractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&tokenId=6137
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
tokenContractAddress
String
Yes
Collection's contract address.
tokenId
String
Yes
NFT token ID.
marketplace
String
No
NFT trading platforms (e.g., OpenSea, LooksRare, etc.)
page
String
No
Page number
limit
String
No
Number of results returned, max 100 per page, default is 20
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "2",
"collectionName": "Bored Ape Yacht Club",
"tokenContractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"tokenId": "6137",
"token": "BAYC",
"listingList": [
{
"amount": "1",
"createTime": "1697470407000",
"validTime": "1697729593000",
"price": "26.98",
"priceSymbol": "ETH",
"priceSymbolContractAddress": "",
"orderHash": "0xce44938ed7af8565835b6bc2e57368093bba1fd29d05aa223f1a382d5d62a8d5",
"ownerAddress": "0x65a837220bddc55b67010adec2125e136ed19444",
"marketplace": "X2Y2",
"usdPrice": "41935.5536"
},
{
"amount": "1",
"createTime": "1697530292000",
"validTime": "2147443200000",
"price": "26.98",
"priceSymbol": "ETH",
"priceSymbolContractAddress": "",
"orderHash": "0x478e6e8ee59adfbd81d546af6757df6642e6e9d66b816306dc5305c668997d29",
"ownerAddress": "0x65a837220bddc55b67010adec2125e136ed19444",
"marketplace": "Blur",
"usdPrice": "41935.5536"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
Number of entries on the current page
totalPage
String
Total number of pages
collectionName
String
Full collection name
tokenContractAddress
String
Collection contract address
tokenId
String
NFT token ID
token
String
Token name
listingList
Array
List of listings
> amount
String
Listing amount
> createTime
String
Order listing time (timestamp in milliseconds)
> validTime
String
Expiry time of the listing
> price
String
Listing price
> priceSymbol
String
Price unit
> priceSymbolContractAddress
String
Contract address of the price unit
> orderHash
String
Order hash
> ownerAddress
String
Listing order address
> marketplace
String
Trading platform (e.g., LooksRare)
> usdPrice
String
Value of the listing in USD
The NFTs held by the address
Get the list of NFTs held by the specified address. The supported chains are ETH, OKTC, BSC, POLYGON, AVAXC, OP, ARBITRUM.
HTTP Request
GET /api/v5/explorer/nft/address-balance-fills
Consumption per query 1
Request Example
GET /api/v5/explorer/nft/address-balance-fills?chainShortName=oktc&address=0xda0d7f342b9c0f7f5f456e0c0a3ec6fe925eaef3&protocolType=token_721&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
address
String
Yes
address
protocolType
String
Yes
Protocol type token_721 token_1155
tokenContractAddress
String
No
Contract address for the collection
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "224",
"tokenList": [
{
"tokenContractAddress": "0x1e0e008eec6d04c52a3945d3df33d04e06a9c46f",
"tokenId": "5158",
"protocolType": "token_721",
"amount": "1",
"token": "GPF",
"logoUrl": "https://static.oklink.com/cdn/nft/files/65964236-8bd0-4985-9548-440c7953bc8c.webp"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenList
Array
Token list
> tokenContractAddress
String
The contract address of the collection
> tokenId
String
NFT id
> protocolType
String
Protocol type
> amount
String
The number of this NFT held by the address
> token
String
Token name
> logoUrl
String
NFT logo Url
Defi API
Get Defi lending (access, borrowing, and liquidation) transaction data, APY and TVL data of different Defi protocols on different chains.
Query Defi lending access transactions
Query Defi lending access transactions, and only return the latest 10,000 transaction data. The supported chain is ETH.
Consumption per query 5HTTP Request
GET /api/v5/explorer/defi/lending-access
Request Example
GET /api/v5/explorer/defi/lending-access?chainShortName=ETH&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
tokenContractAddress
String
No
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
maxAmount
String
No
Transaction quantity range, maximum amount
minAmount
String
No
Transaction quantity range, minimum amount
page
String
No
Page
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x2fbb7b6c205851dff82fb27a8a9515fa032a5b6b69845ac6f4ba189967a87653",
"height": "18632143",
"transactionTime": "1700714831000",
"action": "supply",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"quantity": "1900000",
"amount": "1900000",
"project": "Aave V2",
"from": "0xf4dfcd61c36fc3ac374e52206c43253e14c2ffe2"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> height
String
Block height of the transaction
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> action
String
Transaction action: supply, redeem
> tokenContractAddress
String
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
> quantity
String
The supplied or redeemed quantity of the token
> amount
String
The transaction amount of the token. It is equal to the transaction quantity multiplied by the token price. The unit is USD.
> project
String
Defi lending project
> from
String
Sender address, multiple addresses separated by commas
Query Defi lending borrowing transactions
Query Defi lending borrowing transactions, and only return the latest 10,000 transaction data. The supported chain is ETH.
Consumption per query 5HTTP Request
GET /api/v5/explorer/defi/lending-borrow
Request Example
GET /api/v5/explorer/defi/lending-borrow?chainShortName=ETH&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
tokenContractAddress
String
No
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
maxAmount
String
No
Transaction quantity range, maximum amount
minAmount
String
No
Transaction quantity range, minimum amount
page
String
No
Page
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0xf370eb39e628abf10e120ee2af353fdb48172884495be5fa03065e51cebf1ae1",
"height": "18624454",
"transactionTime": "1700621867000",
"action": "repay",
"tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"quantity": "25.22281301849709",
"amount": "49671.2295389268",
"project": "Aave V2"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> height
String
Block height of the transaction
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> action
String
Transaction action: loan, repay
> tokenContractAddress
String
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
> quantity
String
The borrowed or repaid quantity of the token
> amount
String
The transaction amount of the token. It is equal to the transaction quantity multiplied by the token price. The unit is USD.
> project
String
Defi lending project
Query Defi lending liquidation transactions
Query Defi lending liquidation transactions, and only return the latest 10,000 transaction data. The supported chain is ETH.
Consumption per query 5HTTP Request
GET /api/v5/explorer/defi/lending-liquidate
Request Example
GET /api/v5/explorer/defi/lending-liquidate?chainShortName=ETH&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
tokenContractAddress
String
No
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
startBlockHeight
String
No
The starting block height
endBlockHeight
String
No
The end block height
maxAmount
String
No
Transaction quantity range, maximum amount
minAmount
String
No
Transaction quantity range, minimum amount
page
String
No
Page
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x1120c5ec58e4c5b7565bae56f916845b266213bac2be079607add92bbe51b4a2",
"height": "18623731",
"transactionTime": "1700613095000",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"quantity": "792.439819",
"amount": "792.439819",
"rewards": "828.09961",
"rewardsSymbol": "USDC",
"liquidator": "0xb6569481dccddd527c2b0e8ba32f494e52224ca1",
"project": "Aave V2"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> height
String
Block height of the transaction
> transactionTime
String
The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085
> tokenContractAddress
String
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
> quantity
String
The liquidation quantity of the token
> amount
String
The liquidation amount of the token. It is equal to the liquidation quantity multiplied by the token price. The unit is USD.
> rewards
String
The liquidation rewards
> rewardsSymbol
String
The symbol of the liquidation reward token
> liquidator
String
The liquidator
> project
String
Defi lending project
Defi APY and TVL
Query the Annual Percentage Yield (APY) or Annual Percentage Rate (APR), as well as the Total Value Locked (TVL) data of multiple Defi protocols on multiple public chains.
Supported Defi protocols and chains
Get the list of Defi protocols and chains supported in this module. Return in alphabetical order based on the first letter of Defi protocol by default.
Consumption per query 0HTTP Request
GET /api/v5/explorer/defi/support-protocol
Request Example
GET /api/v5/explorer/defi/support-protocol
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
No
The abbreviated name of the blockchain network, e.g. ETH
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainShortName": "AVAX",
"protocol": "Aave V2"
},
{
"chainShortName": "ETH",
"protocol": "Aave V2"
},
{
"chainShortName": "MATIC",
"protocol": "Aave V2"
}
]
}
Response Parameters
Parameter
Type
Description
chainShortName
String
The abbreviated name of the blockchain network, e.g. ETH
protocol
String
Defi protocol name
Query by tokens
Query the real-time and daily Annual Percentage Yield (APY) or Annual Percentage Rate (APR), as well as the Total Value Locked (TVL) data for different tokens on different public chains in various liquidity pools; only single-token pool queries are supported.
You can query the Defi protocols and chains we support by /api/v5/explorer/defi/support-protocol
Consumption per query 3HTTP Request
GET /api/v5/explorer/defi/token-pool-data
Request Example
GET /api/v5/explorer/defi/token-pool-data?tokenContractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&chainShortName=ETH&protocol=Aave v3&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
tokenContractAddress
String
Yes
Token contract address; 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token
protocol
String
Yes
Defi protocol name
startTime
String
No
Query the historical DeFi data of the token later than this date. Unix timestamp format in milliseconds, e.g. 1597026383085
endTime
String
No
Query the historical DeFi data of the token earlier than this date. Unix timestamp format in milliseconds, e.g. 1597026383085
page
String
No
Page
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"limit": "1",
"page": "1",
"totalPage": "30",
"chainShortName": "ETH",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"protocol": "Aave V3",
"rateType": "0",
"rate": "0.04003",
"borrowRateType": "1",
"borrowRate": "0.0491",
"tvl": "46893689.20997",
"poolHistory": [
{
"time": "1702828800000",
"historyRate": "0.05477",
"historyTvl": "39603860.76729802",
"historyBorrowRate": "0.06569"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainShortName
String
The abbreviated name of the blockchain network, e.g. ETH
tokenContractAddress
String
Token contract address
protocol
String
Defi protocol name
rateType
Array
Supply rate type, 0 APY, 1 APR
rate
String
The current supply APY or APR of the token in this liquidity pool, data updated every hour
borrowRateType
Array
Borrow rate type, 0 APY, 1 APR, only applicable to Defi lending protocols
borrowRate
String
The current borrow APY or APR of the token in this liquidity pool, only applicable to Defi lending protocols, data updated every hour
tvl
String
The current TVL of the token in this liquidity pool, data updated every hour
poolHistory
Array
The historical APY and TVL data of the token in the liquidity pool
> time
String
Date, unix timestamp format in milliseconds, e.g. 1597026383085
> historyRate
String
The historical supply APY or APR data of the token in this liquidity pool, data updated daily
> historyTvl
String
The historical TVL data of the token in this liquidity pool, data updated daily
> historyBorrowRate
String
The historical borrow APY or APR data of the token in this liquidity pool, only applicable to Defi lending protocols, data updated daily
Query by pool address
Query the Annual Percentage Yield (APY) or Annual Percentage Rate (APR), as well as the Total Value Locked (TVL) data by pool address or LP token contract address.
Consumption per query 3HTTP Request
GET /api/v5/explorer/defi/defi-pool-data
Request Example
GET /api/v5/explorer/defi/defi-pool-data?chainShortName=ETH&poolAddress=0x12392f67bdf24fae0af363c24ac620a2f67dad86
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. ETH
poolAddress
String
Yes
Defi pool contract address, or LP token contract address
startTime
String
No
Query the historical DeFi data later than this date. Unix timestamp format in milliseconds, e.g. 1597026383085
endTime
String
No
Query the historical DeFi data earlier than this date. Unix timestamp format in milliseconds, e.g. 1597026383085
page
String
No
Page
limit
String
No
The number of results returned per request. The default is 20 and the maximum is 100.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"limit": "20",
"page": "1",
"totalPage": "2",
"chainShortName": "ETH",
"investmentName": "TUSD",
"protocol": "Compound",
"rateType": "0",
"rate": "0.11277",
"borrowRateType": "1",
"borrowRate": "0.12144",
"tvl": "769606.55705",
"poolHistory": [
{
"time": "1705334400000",
"historyRate": "0.05377",
"historyTvl": "630785.3408479508",
"historyBorrowRate": "0.06957"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainShortName
String
The abbreviated name of the blockchain network, e.g. ETH
protocol
String
Defi protocol name
investmentName
String
Investment name
rateType
Array
Supply rate type, 0 APY, 1 APR
rate
String
The current supply APY or APR of the token in this liquidity pool, data updated every hour
borrowRateType
Array
Borrow rate type, 0 APY, 1 APR, only applicable to Defi lending protocols
borrowRate
String
The current borrow APY or APR of the token in this liquidity pool, only applicable to Defi lending protocols, data updated every hour
tvl
String
The current TVL of the token in this liquidity pool, data updated every hour
poolHistory
Array
The historical APY and TVL data of the token in the liquidity pool
> time
String
Date, unix timestamp format in milliseconds, e.g. 1597026383085
> historyRate
String
The historical supply APY or APR data of the token in this liquidity pool, data updated daily
> historyTvl
String
The historical TVL data of the token in this liquidity pool, data updated daily
> historyBorrowRate
String
The historical borrow APY or APR data of the token in this liquidity pool, only applicable to Defi lending protocols, data updated daily
Market Data
The Market Data function module interface provides full currency token market data for 200+ public chains. Based on the powerful parsing ability of the underlying layer, real-time parsing of the prices in the token pool provides users with the most comprehensive token market data.
Supported chains
Get the list of public chains supported in this module, which can be used to query the chainID of a specific chain. Return in alphabetical order based on the first letter of chainShortName by default.
HTTP Request
GET /api/v5/explorer/tokenprice/chain-list
Consumption per query 1
Request Example
GET /api/v5/explorer/tokenprice/chain-list
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainId": "260",
"chainFullName": "Arkblock",
"chainShortName": "ABT"
},
{
"chainId": "787",
"chainFullName": "Acala Network",
"chainShortName": "ACA"
}
]
}
Response Parameters
Parameter
Type
Description
chainList
Array
Supported chain list
> chainId
String
Unique identifier of the public chain.
> chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
> chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
Token list
Query the list of 200+ public chain tokens to obtain their unique IDs.
HTTP Request
GET /api/v5/explorer/tokenprice/token-list
Consumption per query 1
Request Example
GET /api/v5/explorer/tokenprice/token-list?token=ordi
Request Parameters
Parameter
Type
Required
Description
tokenUniqueId
String
No
Chain id
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
token
String
No
Token
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "20",
"totalPage": "1",
"tokenList": [
{
"tokenUniqueId": "18135625983068672",
"tokenFullName": "ordi",
"token": "ordi",
"network": [
{
"chainId": "56",
"chainFullName": "BNB Smart Chain",
"chainShortName": "BNB",
"tokenContractAddress": "0xf06aed41437f9e6d5b21812bb5d41fd709bc4f78"
}
]
},
{
"tokenUniqueId": "18684748417958401",
"tokenFullName": "ordi",
"token": "ordi",
"network": [
{
"chainId": "0",
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"tokenContractAddress": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0"
}
]
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
tokenList
Array
Token list
> tokenUniqueId
String
Token id
> tokenFullName
String
Full name of the token
> token
String
token
> network
Array
The network issued by this token
>> chainId
String
Chain id
>> chainFullName
String
The full name of the blockchain network, e.g, Bitcoin
>> chainShortName
String
The abbreviated name of the blockchain network, e.g, BTC
>> tokenContractAddress
String
Token contract address
Kline
Support querying the historical price data of over 200+ public chain tokens.
HTTP Request
GET /api/v5/explorer/tokenprice/historical
Consumption per query 1
Request Example
GET /api/v5/explorer/tokenprice/historical?chainId=0&tokenContractAddress=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0&limit=2
Request Parameters
Parameter
Type
Required
Description
chainId
String
Yes
Chain id, you can query the chainId of the chains we support by /api/v5/explorer/tokenprice/chain-list
tokenContractAddress
String
No
Token contract address, do not fill in this parameter, default to querying the historical data of this token.
limit
String
No
Returns the number of data entries, with a default of 50 entries. A maximum of 200 entries can be returned for a single request
after
String
No
Request the pagination content before this timestamp (older data), and the value passed is the time of the corresponding interface
before
String
No
Request the pagination content after this timestamp (new data), and the value passed is the time of the corresponding interface
period
String
No
Filter time granularity, default value of 1d [1m/5m/30m/1h/1D]
If you query the price of inscription tokens on Facet-VM, you need to add 'facet_' in front of the contract address, such as 'facet_0x55ab0390a89fed8992e3affbf61d102490735e24'.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"price": "3.271",
"time": "1697644800000",
"priceAbnormal": []
},
{
"price": "3.129",
"time": "1697558400000",
"priceAbnormal": []
}
]
}
Response Parameters
Parameter
Type
Description
price
String
Price
time
String
The time when the data was last updated
priceAbnormal
String
Abnormal price typeLow Liquidity, Disparity Between Sources, Abnormal Fluctuation
Batch query token price
You can batch query the price of up to 100 tokens. The price is the result of a comprehensive calculation of prices from multiple CEX and DEX. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, SCROLL, OMEGA.
Consumption per query is 10HTTP Request
GET /api/v5/explorer/tokenprice/price-multi
Request Example
GET /api/v5/explorer/token/tokenprice/price-multi?chainShortName=eth&tokenContractAddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2,0x8d983cb9388eac77af0474fa441c4815500cb7bb
Request Parameters
Parameter
Type
Required
Description
chainId
String
No
Unique identifier of the public chain, you can query the chainId of the chains we support by /api/v5/explorer/tokenprice/chain-list. Either chainId or chainShortName must be chosen.
chainShortName
String
No
The abbreviated name of the blockchain network, e.g, BTC, ETH. Either chainId or chainShortName must be chosen.
tokenContractAddress
String
Yes
Token Contract Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"lastPrice": "6.397",
"tokenContractAddress": "0x8d983cb9388eac77af0474fa441c4815500cb7bb",
"priceAbnormal": []
},
{
"lastPrice": "1395.5956462884245",
"tokenContractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"priceAbnormal": []
}
]
}
Response Parameters
Parameter
Type
Description
lastPrice
String
The latest price of the token, updated every minute.
tokenContractAddress
String
Token Contract Address
priceAbnormal
String
Abnormal price typeLow Liquidity, Disparity Between Sources, Abnormal Fluctuation
Token market data
It supports the query of Market data information of 200+ public chain tokens and provides details of all currencies in the market.
HTTP Request
GET /api/v5/explorer/tokenprice/market-data
Consumption per query 2
Request Example
GET /api/v5/explorer/tokenprice/market-data?chainId=0&tokenContractAddress=b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0
Request Parameters
Parameter
Type
Required
Description
chainId
String
Yes
Chain id, you can query the chainId of the chains we support by /api/v5/explorer/tokenprice/chain-list
tokenContractAddress
String
No
Token contract address, do not fill in this parameter, default to querying the historical data of this token.
If you query the price of inscription tokens on Facet-VM, you need to add 'facet_' in front of the contract address, such as 'facet_0x55ab0390a89fed8992e3affbf61d102490735e24'.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"lastPrice": "3.412",
"totalSupply": "71946000",
"circulatingSupply": "21000000",
"volume24h": "10030.84212626599936",
"marketCap": "71946000",
"high24h": "3.546",
"low24h": "3.193",
"priceAbnormal": []
}
]
}
Response Parameters
Parameter
Type
Description
lastPrice
String
Last price
totalSupply
String
Total supply
maxSupply
String
Max supply
circulatingSupply
String
Supply
volume24h
String
24-hour trading volume
marketCap
String
Market cap
high24h
String
24-hour maximum price
low24h
String
24-hour minimum price
priceAbnormal
String
Abnormal price typeLow Liquidity, Disparity Between Sources, Abnormal Fluctuation
Tracker
Obtain transaction by transaction data from a certain Dex, up to 10000 entries can be queried.
HTTP Request
GET /api/v5/explorer/tokenprice/tracker
Consumption per query 1
Request Example
GET /api/v5/explorer/tokenprice/tracker?chainId=1&limit=2
Request Parameters
Parameter
Type
Required
Description
chainId
String
Yes
Chain id, you can query the chainId of the chains we support by /api/v5/explorer/tokenprice/chain-list
poolAddress
String
No
Pool address
tokenContractAddress
String
No
Token contract address
dexName
String
No
Dex
height
String
No
height
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "2",
"totalPage": "5000",
"transactionList": [
{
"txId": "0x7bc10ebc1a151e1d13117edcca38f1e0c28f2faf4b4205970ac2005d181235b1",
"poolAddress": "0x42bc8892085648c1d4b647e405a947f1e0badd38",
"tokenInAmount": "0.04",
"tokenInContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenOutAmount": "2315878.592885542",
"tokenOutContractAddress": "0x857f4fe9426f48526efccf55e7528f6dd5ece6fd",
"dexName": "Balancer V2",
"factoryAddress": "0xba12222222228d8ba445958a75a0704d566bf2c8",
"transactionAmountUsd": "62.08102743967378",
"transactionTime": "1697703791000",
"height": "18383165",
"index": "237",
"traderAddress": "0x2461d9eafa23ffcfe242ed501c1687616a3ec95f"
},
{
"txId": "0xd2689e38ba03a8465046ae2154f0d3407d5e5eb9f021bdee0542337abefaeb9c",
"poolAddress": "0x10027efa7bfd14ac56de5c7e3427efa857d182ee",
"tokenInAmount": "0.007",
"tokenInContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenOutAmount": "1274359.422601473",
"tokenOutContractAddress": "0xa49f4dc8101c84678ac6f0f15c2676d3d8362bd0",
"dexName": "Uniswap V2",
"factoryAddress": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
"transactionAmountUsd": "10.864179801942912",
"transactionTime": "1697703791000",
"height": "18383165",
"index": "234",
"traderAddress": "0x8b6d9e300d29bd349f5bdf1fbcac02ba8b97b083"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
transactionList
Array
Transaction list
> txId
String
Transaction hash
> poolAddress
String
Pool address
> tokenInAmount
String
Amount of tokens transferred in
> tokenInContractAddress
String
Token contract address of tokens transferred in
> tokenOutAmount
String
Amount of tokens transferred out
> tokenOutContractAddress
String
Token contract address of tokens transferred out
> dexName
String
Dex
> factoryAddress
String
Factory address
> transactionAmountUsd
String
Transaction amount, in USD
> transactionTime
String
Transaction time
> height
String
Height
> index
String
index
> traderAddress
String
Trader address
On-chain Tools
Verify contract, retrieve authorization list for an address, scan the internet domain risk, and broadcast transactions.
Contract verification
Source code verification provides a way for projects to open source their smart contract code for end users to inspect and verify that it does what it claims to do and improve the transparency.
Endpoints of the "Contract verification" module support submitting contract source code for contract verification, verifying proxy contracts, and querying the contract ABI and source code of already verified contracts.
The supported chains are: ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Verify source code
By uploading the contract source code, OKLink explorer will match the compiled contract bytecode with the bytecode on the blockchain and display it on the contract page of the explorer.
You can use this endpoint to quickly verify contracts and improve verification efficiency. The average processing time for contract verification is between 30-60 seconds.
The supported chains are: ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 0HTTP Request
POST /api/v5/explorer/contract/verify-source-code
Request Example
POST /api/v5/explorer/contract/verify-source-code
body
{
"chainShortName":"ETH",
"contractAddress":"0x9Dca580D2c8B8e19e9d77345a5b4C2820B25b386",
"contractName":"HelloWorld",
"sourceCode":"pragma solidity ^0.7.6;↵contract HelloWorl {↵ string public greet = 'Hello Worl!';↵}",
"codeFormat":"solidity-single-file",
"compilerVersion":"v0.7.6+commit.7338295f",
"optimization":"1",
"optimizationRuns":"200",
"contractAbi":"0xfce353f66162630000000000000000000000000",
"evmVersion":"tangerineWhistle",
"viaIr":false,
"libraryInfo":[
{
"libraryName":"libraryName1",
"libraryAddress":"0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc"
},
{
"libraryName":"libraryName2",
"libraryAddress":"0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc"
},
{
"libraryName":"libraryName3",
"libraryAddress":"0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc"
}
]
}
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
contractAddress
String
Yes
Contract address
contractName
String
Yes
Contract name
sourceCode
String
Yes
Source code of the contract. If your contract uses "imports", you will need to concatenate the code into one file (otherwise known as "flattening") as we do not support "imports" in separate files. You can use Solidity flatteners like SolidityFlattery(by@DaveAppleton)
codeFormat
String
Yes
Code format, we support solidity-single-file, solidity-standard-json-input, Vyper
compilerVersion
String
Yes
Compiler version used, e.g., v0.7.6+commit.7338295f, vyper:0.2.11. You can check the supported compiler versions for contract verification in the OKLink Explorer under the Verify Contract section
optimization
String
Yes
Whether optimization was used when compiling the contract, 0 for no optimization, 1 if optimization was used
optimizationRuns
String
No
The number of runs if optimization was used, e.g., 200
contractAbi
String
No
Contract ABI
evmVersion
String
No
EVM version of contract compilation, leave blank for default compiler, specify if others such as tangerineWhistle, spuriousDragon, byzantium
licenseType
String
No
Open source license type, leave blank for default No License
viaIr
Bol
No
Whether to introduce an IR-based code generator, should be consistent with your compiling setting; true / false, false by default
libraryInfo
Array
No
Library info used in contract. The libraryName and libraryAddress must be matched one by one. We support up to 10 different libraries.
> libraryName
String
No
Library name
> libraryAddress
String
No
Library address, e.g., 0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc
Response Example
{
"code": "0",
"msg": "",
"data": [
"eb5c06099d3841359d398541166343fe"
]
}
Response Parameters
Parameter
Type
Description
guid
String
A GUID is returned upon successful submission, which can be used to query the verification result
Check source code verification result
After submitting the source code verification, you can query the result with the GUID returned.
The supported chains are: ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 0HTTP Request
POST /api/v5/explorer/contract/check-verify-result
Request Example
POST /api/v5/explorer/contract/check-verify-result
body
{
"chainShortName":"ETH",
"guid":"eb5c06099d3841359d398541166343fe"
}
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
guid
String
Yes
Query the source code verification result with the GUID returned
Response Example
{
"code": "0",
"msg": "",
"data": [
"Success"
]
}
Response Parameters
Parameter
Type
Description
result
String
Contract source code verification result Success,Fail,Pending
Verify source code with hardhat
To verify a contract using hardhat plugin, you need to make the following modifications to the hardhat.config.js file:
Set the apiKey to your OKLink API key, which can be obtained from My account - API management on https://www.oklink.com/.
Set the network to the blockchain network you have added.
Set the chainId to the ID of the public chain.
Set the apiURL in the urls to https://www.oklink.com/api/explorer/v1/contract/verify/async/api/{chainName}, and set the browserURL to https://www.oklink.com/{chainName}. You can find the supported public chains and their corresponding URLs on https://www.oklink.com/.
Take the ETH chain as an example:
module.exports = {
...
etherscan: {
apiKey: {OKLink API key},
customChains: [
{
network: "eth",
chainId: 1,
urls: {
apiURL: "https://www.oklink.com/api/explorer/v1/contract/verify/async/api/eth",
browserURL: "https://www.oklink.com/eth",
}
}
]
}
};
Verify proxy contract
Verify whether a proxy contract implements the contract as expected.
The supported chains are: ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 0HTTP Request
POST /api/v5/explorer/contract/verify-proxy-contract
Request Example
POST /api/v5/explorer/contract/verify-proxy-contract
body
{
"chainShortName": "ETH",
"proxyContractAddress": "0xfeee12d53ddb7ce61ee467ddf7243212a953174a",
"expectedImplementation": "0x0ecbefc71524068cf18f9d4e50d787e134ee70b8"
}
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
proxyContractAddress
String
Yes
Proxy contract address
expectedImplementation
String
No
Verify whether the implementation contract for the proxy contract is this address
Response Example
{
"code": "0",
"msg": "",
"data": [
"4f2e75682f75410f958c0a3bbf754358"
]
}
Response Parameters
Parameter
Type
Description
guid
String
A GUID is returned upon successful submission, which can be used to query the verification result
Check proxy contract verification result
After submitting the proxy contract verification, you can query the result with the GUID returned.
The supported chains are: ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 0HTTP Request
POST /api/v5/explorer/contract/check-proxy-verify-result
Request Example
POST /api/v5/explorer/contract/check-proxy-verify-result
body
{
"chainShortName":"ETH",
"guid":"4f2e75682f75410f958c0a3bbf754358"
}
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
guid
String
Yes
Query the proxy contract verification result with the GUID returned
Response Example
{
"code": "0",
"msg": "The proxy's (0x826427966fb2e7edee940c5d99b7d66062faef2e) implementation contract is found at 0xd4a2dca4e03713d5bf7d2173237058466a9c1be4 and is successfully updated.",
"data": []
}
Response Parameters
Parameter
Type
Description
result
String
Proxy contract verification result. If the verification is successful, return the address of the implementation contract. If the verification fails, return "A corresponding implementation contract was unfortunately not detected for the proxy address."
Query info for verified contract
Query the contract ABI, source code and other basic information of the verified contract, or query the implementation contract address information of the verified proxy contract.
The supported chains are: ETH, X1_TEST, BSC, POLYGON, AVAXC, FTM, OP, ARBITRUM, LINEA, MANTA, CANTO, POLYGON_ZKEVM, SEPOLIA_TESTNET, GOERLI_TESTNET, AMOY_TESTNET, MUMBAI_TESTNET, POLYGON_ZKEVM_TESTNET
Consumption per query 0HTTP Request
GET /api/v5/explorer/contract/verify-contract-info
Request Example
/api/v5/explorer/contract/verify-contract-info?chainShortName=ETH&contractAddress=0xcF80631b469A54dcba8c8ee1aF84505f496ed248
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
contractAddress
String
Yes
Contract address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"sourceCode": "// proxy.sol - execute actions atomically through the proxy's identity\r\n\r\n// Copyright (C) 2017 DappHub, LLC\r\n\r\n// This program is free software: you can redistribute it and/or modify\r\n// it under the terms of the GNU General Public License as published by\r\n// the Free Software Foundation, either version 3 of the License, or\r\n// (at your option) any later version.\r\n\r\n// This program is distributed in the hope that it will be useful,\r\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\r\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\r\n// GNU General Public License for more details.\r\n\r\n// You should have received a copy of the GNU General Public License\r\n// along with this program. If not, see
"contractName": "DSProxy",
"compilerVersion": "v0.4.23+commit.124ca40d",
"optimization": "1",
"optimizationRuns": "200",
"contractAbi": "[{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"owner_\",\"type\":\"address\"}],\"name\":\"setOwner\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_target\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_data\",\"type\":\"bytes\"}],\"name\":\"execute\",\"outputs\":[{\"name\":\"response\",\"type\":\"bytes32\"}],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_code\",\"type\":\"bytes\"},{\"indexed\":false,\"name\":\"_data\",\"type\":\"bytes\"}],\"name\":\"execute\",\"outputs\":[{\"name\":\"target\",\"type\":\"address\"},{\"name\":\"response\",\"type\":\"bytes32\"}],\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"cache\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"authority_\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_cacheAddr\",\"type\":\"address\"}],\"name\":\"setCache\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_cacheAddr\",\"type\":\"address\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"constant\":false,\"payable\":true,\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"sig\",\"type\":\"bytes4\"},{\"indexed\":true,\"name\":\"guy\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"foo\",\"type\":\"bytes32\"},{\"indexed\":true,\"name\":\"bar\",\"type\":\"bytes32\"},{\"indexed\":false,\"name\":\"wad\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"fax\",\"type\":\"bytes\"}],\"name\":\"LogNote\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"LogSetAuthority\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"owner\",\"type\":\"address\"}],\"name\":\"LogSetOwner\",\"payable\":false,\"type\":\"event\"}]",
"evmVersion": "Default",
"licenseType": "No License (None)",
"libraryInfo": "",
"proxy": "0",
"implementation": "",
"swarmSource": "bzzr://e498874c9ba9e75028e0c84f1b1d83b2dad5de910c59b837b32e5a190794c5e1"
}
]
}
Response Parameters
Parameter
Type
Description
sourceCode
String
Source code of the contract
contractName
String
Contract name
compilerVersion
String
Compiler version used
optimization
String
Whether optimization was used when compiling the contract, 0 for no optimization, 1 if optimization was used
optimizationRuns
String
The number of runs if optimization was used
contractAbi
String
Contract ABI
evmVersion
String
EVM version of contract compilation
licenseType
String
Open source license type
libraryInfo
Array
Library info used in contract
> libraryName
String
Library name
> libraryAddress
String
Library address, e.g., 0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc
proxy
String
Whether it is a proxy contract, 0 means it is not a proxy contract, 1 means it is a proxy contract
implementation
String
The implementation contract address of the proxy contract
swarmSource
String
Swarm hash of contract source code
Token authorized list
Use this API to query the authorization list for a token. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, OPBNB.
HTTP Request
GET /api/v5/tracker/contractscanner/token-authorized-list
Consumption per query 1
Request Example
GET /api/v5/tracker/contractscanner/token-authorized-list?chainShortName=eth&address=0xb011c3F34edbDE3703C25B7eDF2E22a3b4fed08b
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH
address
String
Yes
Token contract address
protocolType
String
No
Protocol type: token_20 token_721 token_1155 Default query 20 tokens authorization information
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainShortName": "ETH",
"protocolType": "token_20",
"tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"authorizationAddress": "0xb011c3f34edbde3703c25b7edf2e22a3b4fed08b",
"precision": "6",
"tokenFullName": "USD Coin",
"token": "USDC",
"holdingAmount": "6.284591",
"authorizedList": [
{
"approvedContractAddress": "0xb45a2dda996c32e93b8c47098e90ed0e7ab18e39",
"approvedAmount": "unlimited",
"tokenId": "",
"approvedTime": "1673422055000",
"approvedTxId": "0x1fc39113ffb410dd40d8bddaf2efe8a935720f5c8c9b8b5013ef98d912a3a4d6",
"approvedProjectName": ""
}
]
}
]
}
Response Parameters
Parameter
Type
Description
chainShortName
String
The abbreviated name of the blockchain network
protocolType
String
Protocol type: token_20 token_721 token_1155
tokenContractAddress
String
Token contract address
authorizationAddress
String
Authorization address
precision
String
Precision
tokenFullName
String
Full name of the token
token
String
Token name
holdingAmount
String
The holding amount of the token for the address being examined
authorizedList
Array
Authorized list
> approvedContractAddress
String
Approved contract address
> tokenId
String
NFT token id
> approvedAmount
String
Approved amount: unlimited or amount
> approvedTime
String
Approved time
> approvedTxId
String
Approved transaction hash
> approvedProjectName
String
Approved collection name, e.g., uniswap V3
Address authorized list
Use this API interface to query the history of token contracts authorized for an address, including authorization information for 20 tokens and 721 tokens. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, OPBNB.
HTTP Request
GET /api/v5/tracker/contractscanner/address-authorized-list
Consumption per query 1
Request Example
GET /api/v5/tracker/contractscanner/address-authorized-list?chainShortName=eth&address=0x7Bf5d8EB050F8cc78BD056BF74047337893B51b0&limit=1
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network
address
String
Yes
Address you want to query
protocolType
String
No
Protocol type: token_20 token_721 token_1155 Default query 20 tokens authorization information
limit
String
No
The number of results returned per request. The maximum is 100. The default is 20.
page
String
No
Page
Response Example
{
"code": "0",
"msg": "",
"data": {
"limit": "1",
"page": "1",
"totalPage": "4",
"chainShortName": "ETH",
"authorizedList": [
{
"address": "0x7bf5d8eb050f8cc78bd056bf74047337893b51b0",
"approvedContractAddress": "0x881d40237659c251811cec9c364ef91dc08d300c",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"symbol": "USDT",
"protocolType": "token_20",
"approvedTxId": "0x11a7bc38c0fa9a400ec47a95c94d47b3e5cb0fa0c673b913ffde4ed46adc578f",
"approvedTxHeight": "16720553",
"approvedTime": "1677513299000",
"approvedAmount": "unlimited",
"tokenId": "",
"type": "approval"
}
]
}
}
Response Parameters
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
chainShortName
String
The abbreviated name of the blockchain network,
authorizedList
Array
Authorized list
> address
String
Address
> approvedContractAddress
String
Approved contract address
> tokenContractAddress
String
Token contract address
> symbol
String
symbol
> protocolType
String
Protocol type: token_20 token_721 token_1155
> approvedTxId
String
Approved transaction hash
> approvedTxHeight
String
Approved transaction height
> approvedTime
String
Approved time
> approvedAmount
String
Approved amount: unlimited or amount
> tokenId
String
NFT token id
> type
String
Type approval approval_all cancel_approval Usually, for 20 tokens, only approval type is available. For 721 tokens, there are three types of authorization. And for 1155 tokens, there are approval_all and cancel_approval types.
Domain risk scanner
This endpoint scans the internet domain risk and retrieves risk level and detail information associated with specific domain address.
Risk Levels
Risk Levels
Rules
Description
SEVERE
Hit Blacklist Domain Database
We consider the domain you tested to have a high level of risk. We recommend that you take appropriate measures.
HIGH
Precision Matching Strategy for Keyword Matching
We believe that the domain you tested shares key words with official domain names, indicating a potential phishing website. Please exercise caution.
MEDIUM
Fuzzy Matching Strategy for Keyword Matching
We believe that the tested domain poses a risk and may require attention.
LOW
Matched White List or No Rule Matched
Our assessment does not guarantee that the domain is completely risk-free. It is possible that our risk detection strategies or domain databases do not have any records for it.
By using this interface, you can screen domain name risks and reduce the risk of users falling victim to phishing websites through an extensive black domain name database and the identification of risk features associated with phishing.
HTTP Request
GET /api/v5/tracker/domainscanner/domain-risk-scanning
Consumption per query 1
Request Example
GET /api/v5/tracker/domainscanner/domain-risk-scanning?domain=www.oklink.com
Request Parameters
Parameter
Type
Required
Description
domain
String
Yes
Domain name, e.g., www.oklink.com Batch query supports up to 5 domains, separated by commas.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"domain": "www.oklink.com",
"level": "LOW"
}
]
}
Response Parameters
Parameter
Type
Description
domain
String
Domain
level
String
Risk Level: SEVERE; HIGH; MEDIUM; LOW
Send raw transaction
Broadcast your completed signed transaction to the specified blockchain through this interface, sending it to the node to verify this transaction. The supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BASE, OPBNB, MANTA, CANTO, SEPOLIA_TESTNET, GOERLI_TESTNET.
HTTP Request
POST /api/v5/explorer/transaction/publish-tx
Consumption per query 5
Request Example
POST /api/v5/explorer/transaction/publish-tx
body
{
"chainShortName":"eth",
"signedTx":"12232323"
}
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g, BTC, ETH. Request the /api/v5/explorer/blockchain/summary interface to query the chains supported by OKLink
signedTx
String
Yes
Transaction signature
Response Example
{
"code":"0",
"msg":"",
"data":[
{
"chainFullName":"Bitcoin",
"chainShortName":"BTC",
"txid":"5e95ebfe52c50758e69bbac1d2cc4224dc520498e38505bc958fae8bcd5e8366"
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The full name of the blockchain network, e.g. Bitcoin
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
txid
String
Transaction hash
Webhook
'Webhook Service' function module interface, used to subscribe to addresses or events occurring on the chain, you can add Webhook urls to receive your subscribed event push, and quickly integrate into your application.
The supported chains are ETH, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM.
Webhook Retry rule
If the callback to your service fails and we get a response with https status code other than 200, we will retry. If we fail 50 times within an hour, we will stop pushing. Every time, the interval is 5 seconds.
Subscription limits
Free version of the account rights: Support to subscribe to 50 tasks, each task up to 20 addresses, the maximum number of push messages per day 1000.
Paid account rights: Support for subscribing to 100 tasks with up to 100 addresses per task.
Creat webhook task
Create webhook task and set the subscription criteria
Consumption per query 5, message 1HTTP Request
POST /api/v5/explorer/webhook/update-address-activity-tracker
Request Example
POST /api/v5/explorer/webhook/create-address-activity-tracker
{
"event":"tokenTransfer",
"chainShortName":"eth",
"webhookUrl":"your own rul",
"trackerName":"name",
"addresses":[
"0xceb69f6342ece283b2f5c9088ff249b5d0ae66ea",
"0x21a31ee1afc51d94c2efccaa2092ad1028285549"
],
"tokenContractAddress":[
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"
],
"valueUsdFilter":{
"minValueUsd":"50000",
"maxValueUsd":"100000"
},
"amountFilter":{
"minAmount":"23",
"maxAmount":"40"
}
}
Request Parameters
Parameter
Type
Required
Description
event
String
Yes
Event type, tokenTransfer：token transfer, 'nativeTokenTransfer'：native token transfer including normal transaction & internal transaction
chainShortName
String
Yes
The abbreviated name of the blockchain network
webhookUrl
String
Yes
Webhook Url，Return status code "200"
trackerName
String
Yes
Tracker name
addresses
Array
Yes
Address
tokenContractAddress
Array
No
Token contract address
amountFilter
Array
No
Amount restriction .
> minAmount
String
No
minimum amount
> amountFilter
String
No
maximum amount
valueUsdFilter
Array
No
Value restriction
> minValueUsd
String
No
minimum value
> amountFilter
String
No
maximum value
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
Response Example
Parameter
Type
Description
trackerId
String
tracker ID，Unique identification of the task
Message
{
'blockHash': ""0x0b7a9422898ccebf1bf075338c55f0959a506a140992ba3c7f5a896a0e86a7e5",
'symbol': "WETH",
'amount': "'"0.7086312210942441",
'tokenId': "",
'txId': "0x4535e911613107e39dac30f726356a949947b2883bf4af80c977de821675cfb9",
'methodId': "",
'transactionTime': "1697115527000",
'transactionType': "tokenTransfer",
'tokenContractAddress': "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
'from': "0x99dfde431b40321a35deb6aeb55cf338ddd6eccd",
'to': "0x98c3d3183c4b8a650614ad179a1a98be0a8d6b8e",
'event': "tokenTransfer",
'operation': "",
'trackerId': "1481",
'chainShortName': "eth",
'height': "18334488",
'status': "success"
}
Response Parameters
Parameter
Type
Description
event
String
Yes
chainShortName
String
Yes
height
String
Block height of the transaction
transactionTime
String
Transaction timestamp
blockHash
String
Block hash
txId
String
Transaction hash
from
Array
Transaction sender's address
to
Array
Transaction receiver's address
amount
String
Transaction amount
symbol
String
Token symbol
tokenId
String
NFT token ID
methodId
String
Method
status
String
Transaction status success fail pending
operation
String
Operation
trackerId
String
The Tracker ID is the unique identifier for each monitoring task
Update webhook task
Update webhook task and set the subscription criteria
Consumption per query 3HTTP Request
POST /api/v5/explorer/webhook/create-address-activity-webhook
Request Example
POST /api/v5/explorer/webhook/create-address-activity-webhook
body
{
"event":"nativeTokenTransfer",
"trackerId":"your trackerId",
"chainShortName":"eth",
"webhookUrl":"your own rul",
"trackerName":"name",
"addresses":[
"0xceb69f6342ece283b2f5c9088ff249b5d0ae66ea",
"0x21a31ee1afc51d94c2efccaa2092ad1028285549"
],
"tokenContractAddress":[
"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"0xa0b73e1ff0b80914ab6fe0444e65848c4c34450b"
],
"valueUsdFilter":{
"minValueUsd":"500000",
"maxValueUsd":"1000000"
},
"amountFilter":{
"minAmount":"23",
"maxAmount":"40"
}
}
Request Parameters
Parameter
Type
Required
Description
event
String
Yes
Event type, tokenTransfer：token transfer, 'nativeTokenTransfer'：native token transfer including normal transaction & internal transaction
trackerId
String
Yes
The Tracker ID is the unique identifier for each monitoring task
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
webhookUrl
String
Yes
Webhook url, return status code "200"
trackerName
String
Yes
Tracker name
tokenContractAddress
Array
No
Token contract address
amountFilter
Array
No
Amount restriction
> minAmount
String
No
Minimum amount
> amountFilter
String
No
Maximum amount
valueUsdFilter
Array
No
Value restriction
> minValueUsd
String
No
Minimum USD value
> maxValueUsd
String
No
Maximum USD value
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
Response Example
Parameter
Type
Description
trackerId
String
The Tracker ID is the unique identifier for each monitoring task
Update webhook task status
Update webhook task status
Consumption per query 3HTTP Request
POST /api/v5/explorer/webhook/update-tracker-status
Request Example
POST /api/v5/explorer/webhook/update-tracker-status
body
{
"trackerId": "xxxx",
"isActive": true
}
Request Parameters
Parameter
Type
Required
Description
trackerId
String
Yes
The Tracker ID is the unique identifier for each monitoring task
isActive
String
Yes
Tracker status
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
Response Example
Parameter
Type
Description
trackerId
String
The Tracker ID is the unique identifier for each monitoring task
Delete webhook task
Delete webhook task status
Consumption per query 3HTTP Request
POST /api/v5/explorer/webhook/delete-tracker
Request Example
POST /api/v5/explorer/webhook/delete-tracker
body
{
"trackerId": "xxxx"
}
Request Parameters
Parameter
Type
Required
Description
trackerId
String
Yes
The Tracker ID is the unique identifier for each monitoring task
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
Response Example
Parameter
Type
Description
trackerId
String
The Tracker ID is the unique identifier for each monitoring task
Edit webhook task addresses list
Edit webhook task addresses list
Consumption per query 3HTTP Request
POST /api/v5/explorer/webhook/add-and-remove-tracker-addresses
Request Example
POST /api/v5/explorer/webhook/add-and-remove-tracker-addresses
{
"trackerId": "xxxx",
"action": "...",
"chainShortName": "eth",
"addresses":[
"",
""
]
}
Request Parameters
Parameter
Type
Required
Description
trackerId
String
Yes
The Tracker ID is the unique identifier for each monitoring task
action
String
Yes
Action type: 'add' add address, 'remove' remove address, 'replace' replace address
chainShortName
String
Yes
The abbreviated name of the blockchain network, e.g. BTC
addresses
Array
Yes
Address
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"trackerId": "xxxx"
}
]
}
Response Example
Parameter
Type
Description
trackerId
String
The Tracker ID is the unique identifier for each monitoring task
Get webhook trakcer list
Get webhook tracker list
Consumption per query 0HTTP Request
GET /api/v5/explorer/webhook/get-tracker-list
Request Example
GET /api/v5/explorer/webhook/get-tracker-list
Request Parameters
Parameter
Type
Required
Description
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "1",
"trackerList": [
{
"trackerId": "xxxx",
"event": "tokenTransfer",
"trackerName": "xxxxxxx",
"chainShortName": "ETH",
"webhookUrl": " xxxxxx",
"isActive": true,
"updateTime": "1697105146000"
}
]
}
]
}
Response Example
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
trackerList
Array
Tracker list
> trackerId
String
The Tracker ID is the unique identifier for each monitoring task
> event
String
Event type
> trackerName
String
Tracker name
> chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
> webhookUrl
String
Webhook url
> isActive
String
The status of webhook task
> updateTime
String
Last update time of the task
Get webhook task address list
Get webhook task addresses list
Consumption per query 0HTTP Request
GET /api/v5/explorer/webhook/get-tracker-addresses
Request Example
GET /api/v5/explorer/webhook/get-tracker-addresses?trackerId=xxxx
Request Parameters
Parameter
Type
Required
Description
trackerId
String
Yes
The Tracker ID is the unique identifier for each monitoring task
page
String
No
Page
limit
String
No
The number of results returned per request. The maximum is 50. The default is 20.
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"page": "1",
"limit": "1",
"totalPage": "1",
"addressList": [
{
"address": "0xa7efae728d2936e78bda97dc267687568dd593f3",
"eventCount": "0",
"createTime": "1697180588000"
}
]
}
]
}
Response Example
Parameter
Type
Description
page
String
Current page number
limit
String
The amount of data
totalPage
String
Total number of pages
addressList
Array
Address list
> address
String
Address
> eventCount
String
Event count number
> createTime
String
Create time of the task
Get webhook task detail
Get webhook task detail
Consumption per query 0HTTP Request
GET /api/v5/explorer/webhook/get-tracker-details
Request Example
GET /api/v5/explorer/webhook/get-tracker-details?trackerId=xxxx
Request Parameters
Parameter
Type
Required
Description
trackerId
String
Yes
The Tracker ID is the unique identifier for each monitoring task
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"event": "tokenTransfer",
"chainShortName": "ETH",
"trackerId": "1490",
"webhookUrl": " https://c78c-112-10-213-160.ngrok-free.app/webhook",
"trackerName": "wethtestweth112",
"addressCount": "4",
"updateTime": "1697179310000",
"tokenContractAddress": [
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
],
"amountFilter": {
"minAmount": "5",
"maxAmount": "10"
},
"valueUsdFilter": {
"minValueUsd": "",
"maxValueUsd": ""
}
}
]
}
Response Example
Parameter
Type
Description
event
String
Event type, tokenTransfer：token transfer, 'nativeTokenTransfer'：native token transfer including normal transaction & internal transaction
trackerId
String
The Tracker ID is the unique identifier for each monitoring task
chainShortName
String
The abbreviated name of the blockchain network, e.g. BTC
webhookUrl
String
Webhook url, return status code "200"
trackerName
String
Tracker name
addresses
Array
Address
tokenContractAddress
Array
Token contract address
amountFilter
Array
Amount restriction: minAmount, minimum amount; maxAmount, maximum amount
valueUsdFilter
Array
Value restriction, minValueUsd, minimum value; maxValueUsd, maximum value
webhook test demo
Tests whether the webhook monitoring task can receive data
Test webhooks with Ngrok
Sign-up for a free Ngrok account.
Install Ngrok using the Ngrok guide。On macOS run 'brew install ngrok'
Connect your Ngrok account.'ngrok authtoken YOUR_AUTH_TOKEN'
Start your local forwarding tunnel ：get webhook url (Forwarding)
Python Code Demo
from flask import Flask, request
app = Flask(__name__)
@app.route('/webhook', methods=['POST'])
def webhook():
data = request.get_json()
print(data)
return 'suucess'
if __name__ == '__main__':
app.run(port=8001, debug=True)
Once you have a URL to test your webhook,follow the steps below:
1.Create webhook listeners （use the url get from Ngrok）
2.Creat webhook monitoring task
Create webhook listeners,use the starter code
Notice
As an added security measure, you can ensure your webhook notification originates from OKLink by using one of the following IP addresses:
'47.52.206.222'
RPC API
The RPC API module interface is fully compatible with Etherscan, aiding developers from various EVM-based blockchains in migrating to OKLink swiftly and cost-effectively. It supports both GET and POST requests.
Currently, the module supports three chains: ETH, POLYGON, and X1_TEST, and will continue to extend support to more EVM-based public chains in the future.
API Request URL:
https://www.oklink.com/api/v5/explorer/{chainShortName}/api
The OKLink Explorer API supports multiple blockchains. Therefore, when querying data from different blockchains, you need to include the abbreviation of the respective chain in the Base URL. You can refer to the Supported Chains section to find the short name for each chain.
https://www.oklink.com/api/v5/explorer/eth/api
?module=transaction
&action=gettxreceiptstatus
&txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76
Request Parameters:
All module names, action names, and other request parameters are consistent with Etherscan.
How to use API Key:
For each API request, you need to add ("Ok-Access-Key", followed by your API key) in the HTTP Request Headers.
AccountGet native token balance for an address
Query the native token balance for an address. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=balance
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
Response Example
{
"status": "1",
"message": "OK",
"result": "311273596438144883191969"
}
Response Parameters
Parameter
Type
Description
result
String
The current native token balance for the address, measured in wei
Get native token balance for multiple addresses
Query native token balances for up to 20 addresses. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 3
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=balancemulti
&address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Addresses, up to a maximum of 20, separated by commas
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"balance": "332567136222827062478",
"account": "0x63a9975ba31b0b9626b34300f7f627147df1f526"
},
{
"balance": "40891626854930000000999",
"account": "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a"
}
]
}
Response Parameters
Parameter
Type
Description
account
String
Addresses
balance
String
The current native token balance of each address, measured in wei
Get normal transactions by address
Query a list of transactions for a specific address, returning a maximum of 10,000 transactions. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlist
&address=0x75fa7ed2996e3d430c8fc670a1c6fc4da4d91c9d
&startblock=19166650
&endblock=19166650
&page=1
&offset=1
&sort=asc
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
startblock
String
No
The starting block for the query
endblock
String
No
The ending block for the query
page
String
No
Page
offset
String
No
The number of results returned per page
sort
String
No
The parameter "asc" indicates ascending order, while "desc" indicates descending order. The default order is ascending (asc).
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "19166650",
"timeStamp": "1707191639",
"hash": "0xc3ff0eba575456c7db192ac96d9fe663795e061494b8ac9242166ebe1418d846",
"nonce": "9",
"blockHash": "0xf93f6d21b9ccf9ffb96981239be6cee55d3b5a9ee3ada004b7f6faf54154bae9",
"transactionIndex": "189",
"from": "0x75fa7ed2996e3d430c8fc670a1c6fc4da4d91c9d",
"to": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
"value": "0",
"gas": "105356",
"gasPrice": "17465509927",
"isError": "0",
"input": "0xde0e9a3e00000000000000000000000000000000000000000000000000d275d8b2e31159",
"contractAddress": "",
"cumulativeGasUsed": "19090928",
"gasUsed": "90310",
"confirmations": "4",
"methodId": "0xde0e9a3e",
"functionName": "unwrap(uint256 tokenId)",
"txreceipt_status": "1"
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
nonce
String
The sequence number of transactions initiated by the sender's address
blockHash
String
Block hash
transactionIndex
String
The transaction index within the block
from
String
Sender address
to
String
Recipient address
value
String
Transaction value, measured in wei
gas
String
Gas limit
gasPrice
String
Gas price, measured in wei
isError
String
Indicates whether an error occurred in the contract execution during transaction, where 0 indicates no errors, while 1 indicates an error
txreceipt_status
String
Transaction status, where 1 indicates success, while 0 indicates failure
input
String
Transaction input data
contractAddress
String
If the transaction involves the creation of a new contract, it returns the address of the created contract
cumulativeGasUsed
String
The total amount of gas consumed by all transactions executed within the current block
gasUsed
String
Actual amount of gas used
confirmations
String
The number of confirmed blocks
methodId
String
Short hash identifying the smart contract function
functionName
String
The function of the contract called
Get internal transactions by block height
Query a list of internal transactions for a specific address, returning a maximum of 10,000 transactions. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlistinternal
&address=0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3
&startblock=0
&endblock=19153162
&page=1
&offset=1
&sort=asc
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
startblock
String
No
The starting block for the query
endblock
String
No
The ending block for the query
page
String
No
Page
offset
String
No
The number of results returned per page
sort
String
No
The parameter "asc" indicates ascending order, while "desc" indicates descending order. The default order is ascending (asc).
Response Example
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"2535368",
"timeStamp":"1477837690",
"hash":"0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",
"from":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
"to":"",
"value":"0",
"contractAddress":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
"input":"",
"type":"create",
"gas":"254791",
"gasUsed":"46750",
"traceId":"0",
"isError":"0",
"errCode":""
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
from
String
Sender address
to
String
Recipient address
value
String
Transaction value, measured in wei
contractAddress
String
If internal transactions involve the creation of a new contract, it returns the address of the created contract
input
String
Transaction input data
type
String
The type of internal transaction
gas
String
Gas limit
gasUsed
String
The amount of gas used when executing the step
traceId
String
The tracking identifier for internal transactions
isError
String
Indicates whether an error occurred during the transaction, where 0 indicates no errors, while 1 indicates an error
errCode
String
An error code is returned if an error occurs, otherwise, it returns empty
Get internal transactions by transaction hash
Query a list of internal transactions within a specific transaction, returning a maximum of 10,000 transactions. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlistinternal
&txhash=0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170
Request Parameters
Parameter
Type
Required
Description
txhash
String
Yes
Transaction hash
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "1743059",
"timeStamp": "1466489498",
"hash": "0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170",
"from": "0x2cac6e4b11d6b58f6d3c1c9d5fe8faa89f60e5a2",
"to": "0x66a1c3eaf0f1ffc28d209c0763ed0ca614f3b002",
"value": "7106740000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "",
"traceId": "2",
"isError": "0",
"errCode": "0"
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
from
String
Sender address
to
String
Recipient address
value
String
Transaction value, measured in wei
contractAddress
String
If internal transactions involve the creation of a new contract, it returns the address of the created contract
input
String
Transaction input data
type
String
The type of internal transaction
gas
String
Gas limit
gasUsed
String
The amount of gas used when executing the step
traceId
String
The tracking identifier for internal transactions
isError
String
Indicates whether an error occurred during the transaction. 0 represents no errors, while 1 represents an error
errCode
String
An error code is returned if an error occurs, otherwise, it returns empty
Get internal transactions by block height
Query a list of internal transactions within a specified range of block heights, returning a maximum of 10,000 transactions. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=txlistinternal
&startblock=13481773
&endblock=13491773
&page=1
&offset=1
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startblock
String
Yes
The starting block for the query
endblock
String
Yes
The ending block for the query
page
String
No
Page
offset
String
No
The number of results returned per page
sort
String
No
The parameter "asc" indicates ascending order, while "desc" indicates descending order. The default order is ascending (asc).
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "13481773",
"timeStamp": "1635100060",
"hash": "0x4ee28cc6a573f745b693a2571300c4e0eb2027c8f7275a5f3b37f3ead7f6b32d",
"from": "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
"to": "0x5b3256965e7c3cf26e11fcaf296dfc8807c01073",
"value": "38000000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2300",
"gasUsed": "0",
"traceId": "4",
"isError": "0",
"errCode": ""
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
from
String
Sender address
to
String
Recipient address
value
String
Transaction value, measured in wei
contractAddress
String
If internal transactions involve the creation of a new contract, it returns the address of the created contract
input
String
Transaction input data
type
String
The type of internal transaction
gas
String
Gas limit
gasUsed
String
The amount of gas used when executing the step
traceId
String
The tracking identifier for internal transactions
isError
String
Indicates whether an error occurred during the transaction, where 0 indicates no errors, while 1 indicates an error
errCode
String
An error code is returned if an error occurs, otherwise, it returns empty
Get ERC-20 token transfers by address
Query a list of ERC-20 token transfers for a specific address or contract. The supported chains include ETH, POLYGON, X1_TEST.
If theaddress parameter is provided: Query the ERC-20 token transfer list for that address
If the contract addressparameter is provided: Query the token transfer list for the ERC-20 token corresponding to that contract address
If both address and contract address parameters are provided: Query the token transfer list for the specific ERC-20 token related to the particular contract address
Note: It is recommended to keep the block height range within 10,000, as the interface may time out otherwise.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokentx
&contractaddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2
&address=0x4e83362442b8d1bec281594cea3050c8eb01311c
&page=1
&offset=1
&startblock=19153000
&endblock=19153162
&sort=asc
Request Parameters
Parameter
Type
Required
Description
address
String
No
Address
contractaddress
String
No
Token contract address
startblock
String
No
The starting block for the query
endblock
String
No
The ending block for the query
page
String
No
Page
offset
String
No
The number of results returned per page
sort
String
No
The parameter "asc" indicates ascending order, while "desc" indicates descending order. The default order is ascending (asc).
Response Example
{
"status": "1",
"message": "OK",
"result":
"result":[
{
"blockNumber":"4730207",
"timeStamp":"1513240363",
"hash":"0xe8c208398bd5ae8e4c237658580db56a2a94dfa0ca382c99b776fa6e7d31d5b4",
"nonce":"406",
"blockHash":"0x022c5e6a3d2487a8ccf8946a2ffb74938bf8e5c8a3f6d91b41c56378a96b5c37",
"from":"0x642ae78fafbb8032da552d619ad43f1d81e4dd7c",
"contractAddress":"0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
"to":"0x4e83362442b8d1bec281594cea3050c8eb01311c",
"value":"5901522149285533025181",
"tokenName":"Maker",
"tokenSymbol":"MKR",
"tokenDecimal":"18",
"transactionIndex":"81",
"gas":"940000",
"gasPrice":"32010000000",
"gasUsed":"77759",
"cumulativeGasUsed":"2523379",
"input":"deprecated",
"confirmations":"7968350"
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
nonce
String
The sequence number of transactions initiated by the sender's address
blockHash
String
Block hash
from
String
Sender address
contractAddress
String
Token contract address
to
String
Recipient address
value
String
Token transaction value
tokenName
String
Token name
tokenSymbol
String
Token symbol
tokenDecimal
String
Number of decimal places for the token
transactionIndex
String
Transaction index within the block
gas
String
Gas limit
gasPrice
String
The gas price, measured in wei
gasUsed
String
Actual amount of gas used
cumulativeGasUsed
String
The total amount of gas consumed by all transactions executed within the current block
input
String
The input data of the transaction, typically representing the code for calling a contract function
confirmations
String
The number of confirmed blocks
Get ERC-721 token transfers by address
Query a list of ERC-721 (NFT) token transfers for a specific address or contract. The supported chains include ETH, POLYGON, X1_TEST.
If theaddress parameter is provided: Query the ERC-721 token transfer list for that address
If the contract addressparameter is provided: Query the token transfer list for the ERC-721 token corresponding to that contract address
If both address and contract address parameters are provided: Query the token transfer list for the specific ERC-721 token related to the particular contract address
Note: It is recommended to keep the block height range within 10,000, as the interface may time out otherwise.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokennfttx
&contractaddress=0x06012c8cf97bead5deae237070f9587f8e7a266d
&address=0x6975be450864c02b4613023c2152ee0743572325
&page=1
&offset=1
&startblock=0
&endblock=27025780
&sort=asc
Request Parameters
Parameter
Type
Required
Description
address
String
No
Address
contractaddress
String
No
Token contract address
startblock
String
No
The starting block for the query
endblock
String
No
The ending block for the query
page
String
No
Page
offset
String
No
The number of results returned per page
sort
String
No
The parameter "asc" indicates ascending order, while "desc" indicates descending order. The default order is ascending (asc).
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "4708120",
"timeStamp": "1512907118",
"hash": "0x031e6968a8de362e4328d60dcc7f72f0d6fc84284c452f63176632177146de66",
"nonce": "0",
"blockHash": "0x4be19c278bfaead5cb0bc9476fa632e2447f6e6259e0303af210302d22779a24",
"from": "0xb1690c08e213a35ed9bab7b318de14420fb57d8c",
"to": "0x6975be450864c02b4613023c2152ee0743572325",
"contractAddress": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
"tokenName": "CryptoKitties",
"tokenSymbol": "CK",
"tokenDecimal": "0",
"transactionIndex": "81",
"gas": "158820",
"gasPrice": "40000000000",
"gasUsed": "60508",
"cumulativeGasUsed": "4880352",
"input": "0x454a2ab3000000000000000000000000000000000000000000000000000000000003157a",
"confirmations": "14452761",
"tokenID": "202106"
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
nonce
String
The sequence number of transactions initiated by the sender's address
blockHash
String
Block hash
from
String
Sender address
contractAddress
String
Token contract address
to
String
Recipient address
tokenID
String
NFT token ID
tokenName
String
Token name
tokenSymbol
String
Token symbol
tokenDecimal
String
Number of decimal places for the token
transactionIndex
String
Transaction index within the block
gas
String
Gas limit
gasPrice
String
The gas price, measured in wei
gasUsed
String
Actual amount of gas used
cumulativeGasUsed
String
The total amount of gas consumed by all transactions executed within the current block
input
String
The input data of the transaction, typically representing the code for calling a contract function
confirmations
String
The number of confirmed blocks
Get ERC-1155 token transfers by address
Query a list of ERC-1155 (multi token standard) token transfers for a specific address or contract. The supported chains include ETH, POLYGON, X1_TEST.
If theaddress parameter is provided: Query the ERC-1155 token transfer list for that address
If the contract addressparameter is provided: Query the token transfer list for the ERC-1155 token corresponding to that contract address
If both address and contract address parameters are provided: Query the token transfer list for the specific ERC-1155 token related to the particular contract address
Note: It is recommended to keep the block height range within 10,000, as the interface may time out otherwise.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=token1155tx
&contractaddress=0x76be3b62873462d2142405439777e971754e8e77
&address=0x83f564d180b58ad9a02a449105568189ee7de8cb
&page=1
&offset=1
&startblock=0
&endblock=99999999
&sort=asc
Request Parameters
Parameter
Type
Required
Description
address
String
No
Address
contractaddress
String
No
Token contract address
startblock
String
No
The starting block for the query
endblock
String
No
The ending block for the query
page
String
No
Page
offset
String
No
The number of results returned per page
sort
String
No
The parameter "asc" indicates ascending order, while "desc" indicates descending order. The default order is ascending (asc).
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "13472395",
"timeStamp": "1634973285",
"hash": "0x643b15f3ffaad5d38e33e5872b4ebaa7a643eda8b50ffd5331f682934ee65d4d",
"nonce": "41",
"blockHash": "0xa5da536dfbe8125eb146114e2ee0d0bdef2b20483aacbf30fed6b60f092059e6",
"from": "0x1e63326a84d2fa207bdfa856da9278a93deba418",
"to": "0x83f564d180b58ad9a02a449105568189ee7de8cb",
"contractAddress": "0x76be3b62873462d2142405439777e971754e8e77",
"tokenName": "parallel",
"tokenSymbol": "LL",
"transactionIndex": "100",
"gas": "140000",
"gasPrice": "52898577246",
"gasUsed": "105030",
"cumulativeGasUsed": "11739203",
"input": "0x3e6b214b0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000288300000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000004eb500000000000000000000000000000000000000000000000000000000000000410344d5913b3beedc05dd524fb9006ac0d8e52936b366551c1a0a0f8487e7e1e87e345e8094d856cdf5eb36a8b0e6e243d041760d21d3de073cb8bae0cc578fcd1b00000000000000000000000000000000000000000000000000000000000000",
"confirmations": "5688487",
"tokenValue": "1",
"tokenID": "10371"
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
hash
String
Transaction hash
nonce
String
The sequence number of transactions initiated by the sender's address
blockHash
String
Block hash
from
String
Sender address
contractAddress
String
Token contract address
to
String
Recipient address
tokenValue
String
Token transaction value
tokenID
String
NFT token ID
tokenName
String
Token name
tokenSymbol
String
Token symbol
transactionIndex
String
Transaction index within the block
gas
String
Gas limit
gasPrice
String
The gas price, measured in wei
gasUsed
String
Actual amount of gas used
cumulativeGasUsed
String
The total amount of gas consumed by all transactions executed within the current block
input
String
The input data of the transaction, typically representing the code for calling a contract function
confirmations
String
The number of confirmed blocks
Get address-validated blocks
Query the total number of blocks validated by a specific address. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=getminedblocks
&address=0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b
&page=1
&offset=1
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
page
String
No
Page
offset
String
No
The number of results returned per page
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "19135623",
"timeStamp": "1706815223",
"blockReward": "115675929186924040"
}
]
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
Timestamp in seconds
blockReward
String
Block reward, measured in wei
Get historical native token balance by address
Query the native token balance for a specific address at a specific block height. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=balancehistory
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&blockno=8000000
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
blockno
String
Yes
Block height
Response Example
{
"status": "1",
"message": "OK",
"result": "610538078574759898951277"
}
Response Parameters
Parameter
Type
Description
result
String
The native token balance for the address in the corresponding block, measured in wei
ContractGet ABI for verified contracts
Query the Contract Application Binary Interface (ABI) of verified smart contracts. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=getabi
&address=0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Contract address
Response Example
{
"status": "1",
"message": "OK",
"result": "[{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"proposals\",\"outputs\":[{\"name\":\"recipient\",\"type\":\"address\"},{\"name\":\"amount\",\"type\":\"uint256\"},{\"name\":\"description\",\"type\":\"string\"},{\"name\":\"votingDeadline\",\"type\":\"uint256\"},{\"name\":\"open\",\"type\":\"bool\"},{\"name\":\"proposalPassed\",\"type\":\"bool\"},{\"name\":\"proposalHash\",\"type\":\"bytes32\"},{\"name\":\"proposalDeposit\",\"type\":\"uint256\"},{\"name\":\"newCurator\",\"type\":\"bool\"},{\"name\":\"yea\",\"type\":\"uint256\"},{\"name\":\"nay\",\"type\":\"uint256\"},{\"name\":\"creator\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minTokensToCreate\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"rewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"daoCreator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"divisor\",\"outputs\":[{\"name\":\"divisor\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"extraBalance\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"executeProposal\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"unblockMe\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalRewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"actualBalance\",\"outputs\":[{\"name\":\"_actualBalance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"closingTime\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"allowedRecipients\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"refund\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_description\",\"type\":\"string\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"},{\"indexed\":false,\"name\":\"_debatingPeriod\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"bool\"}],\"name\":\"newProposal\",\"outputs\":[{\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"DAOpaidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minQuorumDivisor\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_newContract\",\"type\":\"address\"}],\"name\":\"newContract\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"name\":\"balance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"changeAllowedRecipients\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"halveMinQuorum\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"paidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"splitDAO\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"DAOrewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"proposalDeposit\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"numberOfProposals\",\"outputs\":[{\"name\":\"_numberOfProposals\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"lastTimeMinQuorumMet\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_toMembers\",\"type\":\"bool\"}],\"name\":\"retrieveDAOReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"receiveEther\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"isFueled\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_tokenHolder\",\"type\":\"address\"}],\"name\":\"createTokenProxy\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"name\":\"getNewDAOAddress\",\"outputs\":[{\"name\":\"_newDAO\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_supportsProposal\",\"type\":\"bool\"}],\"name\":\"vote\",\"outputs\":[{\"name\":\"_voteID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"getMyReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"rewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFromWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"name\":\"remaining\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"}],\"name\":\"changeProposalDeposit\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"blocked\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"curator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"checkProposalCode\",\"outputs\":[{\"name\":\"_codeChecksOut\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"privateCreation\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_curator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_daoCreator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_minTokensToCreate\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_closingTime\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_privateCreation\",\"type\":\"address\"}],\"payable\":false,\"type\":\"constructor\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"FuelingToDate\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"CreatedToken\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Refund\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"newCurator\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"description\",\"type\":\"string\"}],\"name\":\"ProposalAdded\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"position\",\"type\":\"bool\"},{\"indexed\":true,\"name\":\"voter\",\"type\":\"address\"}],\"name\":\"Voted\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"result\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"quorum\",\"type\":\"uint256\"}],\"name\":\"ProposalTallied\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"NewCurator\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"AllowedRecipientChanged\",\"payable\":false,\"type\":\"event\"}]"
}
Response Parameters
Parameter
Type
Description
result
String
Contract ABI
Get source code of verified contracts
Query the source code of verified smart contracts. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=getsourcecode
&address=0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Contract address
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"SourceCode": "/*\n\n- Bytecode Verification performed was compared on second iteration -\n\nThis file is part of the DAO.\n\nThe DAO is free software: you can redistribute it and/or modify\nit under the terms of the GNU lesser General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThe DAO is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU lesser General Public License for more details.\n\nYou should have received a copy of the GNU lesser General Public License\nalong with the DAO. If not, see
"ABI": "[{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"proposals\",\"outputs\":[{\"name\":\"recipient\",\"type\":\"address\"},{\"name\":\"amount\",\"type\":\"uint256\"},{\"name\":\"description\",\"type\":\"string\"},{\"name\":\"votingDeadline\",\"type\":\"uint256\"},{\"name\":\"open\",\"type\":\"bool\"},{\"name\":\"proposalPassed\",\"type\":\"bool\"},{\"name\":\"proposalHash\",\"type\":\"bytes32\"},{\"name\":\"proposalDeposit\",\"type\":\"uint256\"},{\"name\":\"newCurator\",\"type\":\"bool\"},{\"name\":\"yea\",\"type\":\"uint256\"},{\"name\":\"nay\",\"type\":\"uint256\"},{\"name\":\"creator\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"approve\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minTokensToCreate\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"rewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"daoCreator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalSupply\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"divisor\",\"outputs\":[{\"name\":\"divisor\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"extraBalance\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"executeProposal\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFrom\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"unblockMe\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"totalRewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"actualBalance\",\"outputs\":[{\"name\":\"_actualBalance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"closingTime\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"allowedRecipients\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"refund\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_description\",\"type\":\"string\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"},{\"indexed\":false,\"name\":\"_debatingPeriod\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"bool\"}],\"name\":\"newProposal\",\"outputs\":[{\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"DAOpaidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"minQuorumDivisor\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_newContract\",\"type\":\"address\"}],\"name\":\"newContract\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"}],\"name\":\"balanceOf\",\"outputs\":[{\"name\":\"balance\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"changeAllowedRecipients\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"halveMinQuorum\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"paidOut\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"splitDAO\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"DAOrewardAccount\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"proposalDeposit\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"numberOfProposals\",\"outputs\":[{\"name\":\"_numberOfProposals\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"lastTimeMinQuorumMet\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_toMembers\",\"type\":\"bool\"}],\"name\":\"retrieveDAOReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"receiveEther\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transfer\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"isFueled\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_tokenHolder\",\"type\":\"address\"}],\"name\":\"createTokenProxy\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"}],\"name\":\"getNewDAOAddress\",\"outputs\":[{\"name\":\"_newDAO\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_supportsProposal\",\"type\":\"bool\"}],\"name\":\"vote\",\"outputs\":[{\"name\":\"_voteID\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[],\"name\":\"getMyReward\",\"outputs\":[{\"name\":\"_success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"rewardToken\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_value\",\"type\":\"uint256\"}],\"name\":\"transferFromWithoutReward\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_spender\",\"type\":\"address\"}],\"name\":\"allowance\",\"outputs\":[{\"name\":\"remaining\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"}],\"name\":\"changeProposalDeposit\",\"outputs\":[],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"\",\"type\":\"address\"}],\"name\":\"blocked\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"curator\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"indexed\":false,\"name\":\"_proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_transactionData\",\"type\":\"bytes\"}],\"name\":\"checkProposalCode\",\"outputs\":[{\"name\":\"_codeChecksOut\",\"type\":\"bool\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"privateCreation\",\"outputs\":[{\"name\":\"\",\"type\":\"address\"}],\"payable\":false,\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"_curator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_daoCreator\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_proposalDeposit\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_minTokensToCreate\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_closingTime\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"_privateCreation\",\"type\":\"address\"}],\"payable\":false,\"type\":\"constructor\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_from\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Transfer\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_owner\",\"type\":\"address\"},{\"indexed\":true,\"name\":\"_spender\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Approval\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"FuelingToDate\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"CreatedToken\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"to\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"value\",\"type\":\"uint256\"}],\"name\":\"Refund\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"newCurator\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"description\",\"type\":\"string\"}],\"name\":\"ProposalAdded\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"position\",\"type\":\"bool\"},{\"indexed\":true,\"name\":\"voter\",\"type\":\"address\"}],\"name\":\"Voted\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"proposalID\",\"type\":\"uint256\"},{\"indexed\":false,\"name\":\"result\",\"type\":\"bool\"},{\"indexed\":false,\"name\":\"quorum\",\"type\":\"uint256\"}],\"name\":\"ProposalTallied\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_newCurator\",\"type\":\"address\"}],\"name\":\"NewCurator\",\"payable\":false,\"type\":\"event\"},{\"constant\":false,\"inputs\":[{\"indexed\":true,\"name\":\"_recipient\",\"type\":\"address\"},{\"indexed\":false,\"name\":\"_allowed\",\"type\":\"bool\"}],\"name\":\"AllowedRecipientChanged\",\"payable\":false,\"type\":\"event\"}]",
"ContractName": "DAO",
"CompilerVersion": "v0.3.1-2016-04-12-3ad5e82",
"OptimizationUsed": "1",
"Runs": "200",
"ConstructorArguments": "000000000000000000000000da4a4626d3e16e094de3225a751aab7128e965260000000000000000000000004a574510c7014e4ae985403536074abe582adfc80000000000000000000000000000000000000000000000001bc16d674ec80000000000000000000000000000000000000000000000000a968163f0a57b4000000000000000000000000000000000000000000000000000000000000057495e100000000000000000000000000000000000000000000000000000000000000000",
"EVMVersion": "Default",
"Library": "",
"LicenseType": "",
"Proxy": "0",
"Implementation": "",
"SwarmSource": ""
}
]
}
Response Parameters
Parameter
Type
Description
SourceCode
String
Source code of the contract
ABI
String
Contract ABI
ContractName
String
CompilerVersion
String
Compiler version used
OptimizationUsed
String
Indicates whether optimization was used when compiling the contract, where0 indicates no optimization, while 1 indicates optimization
Runs
String
The number of times the code is executed during optimization
ConstructorArguments
String
For contracts created with constructor parameters, encoded in ABI format
EVMVersion
String
Compile the EVM version of the contract
Library
String
Information about the libraries referenced in the contract
LicenseType
String
Open source license type
Proxy
String
Indicates whether it is a proxy contract, where 0 indicates that it is not a proxy contract, while 1 indicates that it is a proxy contract
Implementation
String
The address of the implementation contract for the proxy contract
SwarmSource
String
Hash value of the contract source code on Swarm
Get contract creator and creation transaction hash
Query the deployment address and transaction hash for creating a contract, up to 5 contracts at a time. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=getcontractcreation
&contractaddresses=0xB83c27805aAcA5C7082eB45C868d955Cf04C337F
Request Parameters
Parameter
Type
Required
Description
contractaddresses
String
Yes
Contract address, up to a maximum of 5, separated by commas
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"contractAddress": "0xb83c27805aaca5c7082eb45c868d955cf04c337f",
"contractCreator": "0x390dcfddebeff949b9862ec91d7be337b8995553",
"txHash": "0x0dbad4991b6727df606650635c9e632dad8a92c6363c91652307680efd336c6e"
}
]
}
Response Parameters
Parameter
Type
Description
contractAddress
String
Contract address
contractCreator
String
Contract creator
txHash
String
Transaction hash of the contract creation
Verify contract source code
Upload contract source codes for verification. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 0
Request Example
POST https://www.oklink.com/api/v5/explorer/eth/api/contract/verifysourcecode
body
{
"sourceCode":"pragma solidity ^0.7.6;↵contract HelloWorl {↵ string public greet = 'Hello Worl!';↵}",
"contractaddress":"0x9Dca580D2c8B8e19e9d77345a5b4C2820B25b386",
"codeformat":"solidity-single-file",
"contractname":"HelloWorld",
"compilerversion":"v0.7.6+commit.7338295f",
"optimizationUsed":"1",
"runs":"200",
"evmVersion":"tangerineWhistle"
}
]
}
Request Parameters
Parameter
Type
Required
Description
sourceCode
String
Yes
Contract source code; if the contract uses imports, the code needs to be concatenated into a single file (otherwise known as flattening). Solidity flattening tools can also be used, such as SolidityFlattery(by@DaveAppleton)
contractaddress
String
Yes
Contract address
codeformat
String
Yes
Code format, which supports solidity-single-file, solidity-standard-json-input, Vyper
contractname
String
Yes
Contract name
compilerversion
String
Yes
The compiler version used, such as v0.7.6+commit.7338295f, vyper:0.2.11. You can check supported compiler versions for contract verification in OKLink Explorer under Verify Contract
optimizationUsed
String
Yes
Indicates whether optimization was used during contract compilation, where 0 indicates no optimization, while 1 indicates that optimization was used
runs
String
No
The number of times the code is executed during optimization
constructorArguements
String
No
For contracts created with constructor parameters, encoded in ABI format
evmversion
String
No
Compile the EVM version of the contract. If the default version is used during compilation, leave it blank. Specify if others, such as tangerineWhistle, spuriousDragon, byzantium
licenseType
String
No
Open source license type, leave blank for default No License
libraryname
String
No
The name of the library used in the contract, up to 10 libraries
libraryaddress
String
No
The address of the library used in the contract, corresponding with the libraryname, such as 0xCfE28868F6E0A24b7333D22D8943279e76aC2cdc
Response Example
{
"status": "1",
"message": "OK",
"result": "7bea22463da94c649662c1a5aae3efa9"
}
Response Parameters
Parameter
Type
Description
result
String
A GUID is returned upon successful submission, which can be used to query the verification result
Get contract verification status
After submitting contract source code verification, use the returned GUID to retrieve the verification result. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 0
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=checkverifystatus
&guid=ezq878u486pzijkvvmerl6a9mzwhv6sefgvqi5tkwceejc7tvn
Request Parameters
Parameter
Type
Required
Description
guid
String
Yes
Query the verification results for contract source code based on the GUID
Response Example
{
"status": "0",
"message": "OK",
"result": "Success"
}
Response Parameters
Parameter
Type
Description
result
String
Verification result of the contract source code, where Success indicates successful verification, Fail indicates verification failure, and Pending indicates that verification is in progress
Verify proxy contract
Validate whether a proxy contract implements the contract as expected. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 0
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=verifyproxycontract
&address=0xbc46363a7669f6e12353fa95bb067aead3675c29
&expectedimplementation=0xe45a5176bc0f2c1198e2451c4e4501d4ed9b65a6
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Proxy contract address
expectedimplementation
String
No
Verify whether the implementation contract for the proxy contract forwards calls to the specified address
Response Example
{
"status": "1",
"message": "OK",
"result": "523a27789e84489285ffb7c3eaec9cf4"
}
Response Parameters
Parameter
Type
Description
result
String
Upon successful submission, a GUID will be returned, which can be used to query the verification result
Get proxy contract verification status
After submitting the proxy contract verification, use the returned GUID to retrieve the verification result. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 0
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=contract
&action=checkproxyverification
&guid=ezq878u486pzijkvvmerl6a9mzwhv6sefgvqi5tkwceejc7tvn
Request Parameters
Parameter
Type
Required
Description
guid
String
Yes
Query the verification results for proxy contracts based on the GUID
Response Example
{
"status": "0",
"message": "OK",
"result": "The proxy's (0x826427966fb2e7edee940c5d99b7d66062faef2e) implementation contract is found at 0xd4a2dca4e03713d5bf7d2173237058466a9c1be4 and is successfully updated."
}
Response Parameters
Parameter
Type
Description
result
String
Verification result of the proxy contract, where Success indicates successful verification, Fail indicates verification failure, and Pending indicates that verification is in progress
TransactionCheck contract execution status
Query the contract execution status of a transaction. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=transaction
&action=getstatus
&txhash=0xaf1023b59104130950f5719fb5b719332385dc787cf2e2c31121a7268179b443
Request Parameters
Parameter
Type
Required
Description
txhash
String
Yes
Transaction hash
Response Example
{
"status": "1",
"message": "OK",
"result": {
"isError": "0",
"errDescription": ""
}
}
Response Parameters
Parameter
Type
Description
isError
String
Contract execution status, where 0 indicates successful transactions, while1 indicates failed transactions
errDescription
String
Error description
Check transaction receipt status
Query the execution status of a transaction. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=transaction
&action=gettxreceiptstatus
&txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76
Request Parameters
Parameter
Type
Required
Description
txhash
String
Yes
Transaction hash
Response Example
{
"status": "1",
"message": "OK",
"result": {
"status": "1"
}
}
Response Parameters
Parameter
Type
Description
status
String
Transaction execution status, where 1 indicates successful transactions, while0 indicates failed transactions
BlockGet block rewards
Query block rewards. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=block
&action=getblockreward
&blockno=2165403
Request Parameters
Parameter
Type
Required
Description
blockno
String
Yes
Block height
Response Example
{
"status": "1",
"message": "OK",
"result": {
"blockNumber": "2165403",
"timeStamp": "1472533979",
"blockMiner": "0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3",
"blockReward": "5314181600000000000"
}
}
Response Parameters
Parameter
Type
Description
blockNumber
String
Block height
timeStamp
String
The timestamp for block generation, with Unix timestamp in seconds
blockMiner
String
Address of the block validator
blockReward
String
Block reward, measured in wei
Get estimated countdown time until block validation
Query the estimated time remaining, in seconds, until block validation is completed. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=block
&action=getblockcountdown
&blockno=19161699
Request Parameters
Parameter
Type
Required
Description
blockno
String
Yes
Block height
Response Example
{
"status": "1",
"message": "OK",
"result": {
"CurrentBlock": "19161603",
"CountdownBlock": "19161699",
"RemainingBlock": "96",
"EstimateTimeInSec": "1166.976"
}
}
Response Parameters
Parameter
Type
Description
CurrentBlock
String
Current latest block height
CountdownBlock
String
Block height to query the countdown
RemainingBlock
String
The number of remaining blocks
EstimateTimeInSec
String
Estimated remaining time for block validation to complete, measured in seconds
Get block height by timestamp
Query the block height at a specific timestamp. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=block
&action=getblocknobytime
×tamp=1578638524
&closest=before
Request Parameters
Parameter
Type
Required
Description
timestamp
String
Required
The timestamp for the query, with Unix timestamp in seconds
closest
String
Required
"before" represents the most recent block produced on or before the specified timestamp, while "after" represents the most recent block produced on or after the specified timestamp
Response Example
{
"status": "1",
"message": "OK",
"result": "9251482"
}
Response Parameters
Parameter
Type
Description
result
String
Block height
Get daily average block size
Query the daily average block size over a specific date range. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavgblocksize
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"blockSize_bytes": "20373.362004950493"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"blockSize_bytes": "17499.098277608915"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
blockSize_bytes
String
Average block size for the day, measured in bytes
Get daily block count and rewards
Query the number of blocks mined daily and the amount of block rewards. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyblkcount
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"blockCount": "4848",
"UTCDate": "2019-02-01",
"blockRewards_Eth": "14929.4646908706"
},
{
"unixTimeStamp": "1549065600",
"blockCount": "4935",
"UTCDate": "2019-02-02",
"blockRewards_Eth": "15120.386084685942"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
blockCount
String
The number of blocks produced on the current day
blockRewards_Eth
String
The total block rewards for the day, measured in the chain's native token
Get daily block rewards
Query the amount of block rewards distributed daily. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyblockrewards
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"blockRewards_Eth": "14929.4646908706"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"blockRewards_Eth": "15120.386084685942"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
blockRewards_Eth
String
The total block rewards for the day, measured in the chain's native token
Get daily average time block time
Query the daily average of time needed for a block to be successfully mined. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavgblocktime
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"blockTime_sec": "17.821782178217823"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"blockTime_sec": "17.507598784194528"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
blockTime_sec
String
Daily average block time, measured in seconds
TokenGet total supply of ERC-20 tokens by address
Query the current circulating supply of ERC-20 tokens. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=tokensupply
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
Request Parameters
Parameter
Type
Required
Description
contractaddress
String
Yes
ERC-20 token contract address
Response Example
{
"status": "1",
"message": "OK",
"result": "21265524714464"
}
Response Parameters
Parameter
Type
Description
result
String
The total token supply, with the result returned to the smallest decimal precision. For example, if the total token supply is 215.241526476136819398 with a precision of 18, the result will be returned as 215241526476136819398.
Get ERC-20 token balance by address
Query the current balance of an ERC-20 token for a given address. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokenbalance
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
Request Parameters
Parameter
Type
Required
Description
contractaddress
String
Yes
ERC-20 token contract address
address
String
Yes
Address to query the balance
Response Example
{
"status": "1",
"message": "OK",
"result": "15"
}
Response Parameters
Parameter
Type
Description
result
String
The address token balance, with the result returned to the smallest decimal precision. For example, if the total token supply is 215.241526476136819398 with a precision of 18, the result will be returned as 215241526476136819398.
Get total ERC-20 token supply by address
Query the overall historical supply of a specific ERC-20 token at a certain block height. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&blockno=8000000
Request Parameters
Parameter
Type
Required
Description
contractaddress
String
Yes
ERC-20 token contract address
blockno
String
Yes
Block height
Response Example
{
"status": "1",
"message": "OK",
"result": "21265524714464"
}
Response Parameters
Parameter
Type
Description
result
String
The total token supply in the corresponding block, with the result returned to the smallest decimal precision. For example, if the total token supply is 215.241526476136819398 with a precision of 18, the result will be returned as 215241526476136819398.
Get historical ERC-20 token balance by address
Query the historical balance of an ERC-20 token for an address within a specified block. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
&blockno=8000000
Request Parameters
Parameter
Type
Required
Description
contractaddress
String
Yes
ERC-20 token contract address
address
String
Yes
Address to query the balance
blockno
String
Yes
Block height
Response Example
{
"status": "1",
"message": "OK",
"result": "135499"
}
Response Parameters
Parameter
Type
Description
result
String
The historical token balance for the address in the corresponding block, with the result returned to the smallest decimal precision. For example, if the total token supply is 215.241526476136819398 with a precision of 18, the result will be returned as 215241526476136819398.
Get list of addresses with ERC-20 tokens
Query a list of addresses along with their corresponding token holdings for a specific ERC-20 token, with results returned in descending order based on token holdings. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=token
&action=tokenholderlist
&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d
&page=1
&offset=1
Request Parameters
Parameter
Type
Required
Description
contractaddress
String
Yes
ERC-20 token contract address
page
String
No
Page number
offset
String
No
The number of results returned per page. The maximum and default is 100.
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"TokenHolderAddress": "0x455257963812c008ce8edf3d08cb48e95c8aa2e2",
"TokenHolderQuantity": "6521980135015"
}
]
}
Response Parameters
Parameter
Type
Description
TokenHolderAddress
String
Addresses holding the token
TokenHolderQuantity
String
The amount of tokens held by an address, with the result returned to the smallest decimal precision. For example, if the total token supply is 215.241526476136819398 with a precision of 18, the result will be returned as 215241526476136819398.
Get ERC-20/721/1155 token information
Query information for specific ERC-20/721/1155 tokens. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 3
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=token
&action=tokeninfo
&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07
Request Parameters
Parameter
Type
Required
Description
contractaddress
String
Yes
Token contract address
Response Example
{
"status": "1",
"message": "OK",
"result": {
"contractAddress": "0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",
"tokenName": "Gods Unchained Cards",
"symbol": "CARD",
"divisor": "0",
"tokenType": "ERC721",
"totalSupply": "6972003",
"website": "https://godsunchained.com/?refcode=0x5b3256965e7C3cF26E11FCAf296DfC8807C01073",
"twitter": "https://twitter.com/GodsUnchained",
"whitepaper": "",
"tokenPriceUSD": ""
}
}
Response Parameters
Parameter
Type
Description
contractAddress
String
Token contract address
tokenName
String
Token name
symbol
String
Token symbol
divisor
String
Token precision
tokenType
String
Token type (ERC-20, ERC-721, ERC-1155)
totalSupply
String
Total token supply
website
String
Official website of the token
String
Link to the token's Twitter page
whitepaper
String
Link to the token's whitepaper
tokenPriceUSD
String
Token's current price in USD
Get ERC-20 token holdings by address
Query the list of ERC-20 tokens held by a specific address along with their balances. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=addresstokenbalance
&address=0x983e3660c0bE01991785F80f266A84B911ab59b0
&page=1
&offset=1
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
page
String
No
Page number
offset
String
No
The number of results returned per page. The maximum and default is 100.
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x618e75ac90b12c6049ba3b27f5d5f8651b0037f6",
"TokenName": "QASH",
"TokenSymbol": "QASH",
"TokenQuantity": "19",
"TokenDivisor": "6"
}
]
}
Response Parameters
Parameter
Type
Description
TokenAddress
String
Token contract address
TokenName
String
Token name
TokenSymbol
String
Token symbol
TokenQuantity
String
Token holding quantity
TokenDivisor
String
Token precision
Get ERC-721 token holdings by address
Query the list of ERC-721 tokens held by a specific address along with their balances. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=addresstokennftbalance
&address=0x6b52e83941eb10f9c613c395a834457559a80114
&page=1
&offset=1
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
page
String
No
Page number
offset
String
No
The number of results returned per page. The maximum and default is 100.
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x7c6f282efbe06e93de4ab5e646478bee20f966b8",
"TokenName": "Legionfarm Celebrities Collection",
"TokenSymbol": "LFT",
"TokenQuantity": "1"
}
]
}
Response Parameters
Parameter
Type
Description
TokenAddress
String
Token contract address
TokenName
String
Token name
TokenSymbol
String
Token symbol
TokenQuantity
String
Token holding quantity
Get specific ERC-721 token holdings by address
Query the list of specific ERC-721 tokens held by a specific address. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=account
&action=addresstokennftinventory
&address=0x123432244443b54409430979df8333f9308a6040
&contractaddress=0xed5af388653567af2f388e6224dc7c4b3241c544
&page=1
&offset=1
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
Address
contractaddress
String
Yes
ERC-721 token contract address
page
String
No
Page number
offset
String
No
The number of results returned per page. The maximum and default is 100.
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
"TokenId": "9055"
}
]
}
Response Parameters
Parameter
Type
Description
TokenAddress
String
Token contract address
TokenId
String
ERC-721 token ID
LogGet event logs
Query event logs based on different filter criteria, including: address and topic0; address and block number; address, block number, and topic0. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=logs
&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
&action=getLogs
&address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8
&page=1
&offset=1
Request Parameters
Parameter
Type
Required
Description
address
String
Yes
The address of the smart contract that triggered the event log
startblock
String
No
The starting block for the query
endblock
String
No
The ending block for the query
topic0
String
No
The topic0 of the event log
page
String
No
Page
offset
String
No
The number of results returned per page. The maximum and default is 100.
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000003e316f6abe52fc5cf70a6c9c0932dcb1fcbf3d62",
"0x00000000000000000000000029469395eaf6f95920e59f858042f0e28d98a20b",
"0x0000000000000000000000000000000000000000000000000000000000000f93"
],
"data": "0x",
"blockNumber": "0x12674cc",
"timeStamp": "0x65d9e2af",
"gasPrice": "0x56e959dc4",
"gasUsed": "0x3210f",
"logIndex": "0x18a",
"transactionHash": "0x946d9bc16b827d616c37fc422aee9719153a3490585569f03ff7cfb9c00319ad",
"transactionIndex": "0x78"
}
]
}
Response Parameters
Parameter
Type
Description
address
String
The address of the smart contract that triggered the event log
topics
Array
The topics of the event log
data
String
The non-indexed parameter of the event
blockNumber
String
Block height
timeStamp
String
Transaction time, with timestamp in seconds
gasPrice
String
The gas price of the transaction, measured in wei
gasUsed
String
Actual amount of gas used for the transaction
logIndex
String
The position index of the event log within the block
transactionHash
String
Transaction hash
transactionIndex
String
Transaction index within the block
GasGet gas oracle
Query estimated gas price. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=gastracker
&action=gasoracle
Request Parameters
Response Example
{
"status": "1",
"message": "OK",
"result": {
"suggestBaseFee": "28.126699714",
"gasUsedRatio": "0.371853066666666667,0.999953733333333333,0.523121033333333333,0.738372333333333333,0.394655666666666667",
"LastBlock": "19297505",
"SafeGasPrice": "28.127541273",
"ProposeGasPrice": "28.127933611",
"FastGasPrice": "29.639802826"
}
}
Response Parameters
Parameter
Type
Description
suggestBaseFee
String
Suggested base fee, measured in Gwei
gasUsedRatio
String
Gas used ratio of the last 5 blocks
LastBlock
String
The latest block height
SafeGasPrice
String
Slow gas price, measured in Gwei
ProposeGasPrice
String
Suggested gas price, measured in Gwei
FastGasPrice
String
Fast gas price, measured in Gwei
Get daily average gas limit
Query the historical daily average gas limit. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavggaslimit
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"gasLimit": "8001271",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"gasLimit": "8001245",
"UTCDate": "2019-02-02"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
gasLimit
String
Daily average gas limit
Get daily total gas used
Query the total amount of gas used daily for blockchain transactions. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailygasused
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"gasUsed": "29994520939",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"gasUsed": "28583928186",
"UTCDate": "2019-02-02"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
gasUsed
String
Total amount of gas used daily
Get daily average gas price
Query the historical daily average gas price. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailyavggasprice
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"maxGasPrice_Wei": "60814303896257",
"minGasPrice_Wei": "0",
"avgGasPrice_Wei": "13320433407"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"maxGasPrice_Wei": "20000000000000",
"minGasPrice_Wei": "0",
"avgGasPrice_Wei": "11986248035"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
maxGasPrice_Wei
String
The daily maximum gas price, measured in wei
minGasPrice_Wei
String
The daily minimum gas price, measured in wei
avgGasPrice_Wei
String
The daily average gas price, measured in wei
StatsGet the total supply of the chain's native token
Query the total supply of the chain's native token across different public chains. The supported chains include ETH, POLYGON.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=nativetokensupply
Request Parameters
Response Example
{
"status": "1",
"message": "OK",
"result": "120156541650000000000000000"
}
Response Parameters
Parameter
Type
Description
result
String
Total supply of the native token, measured in wei
Get the last price of the chain's native token
Query the latest price of the chain's native token across different public chains. The supported chains include ETH, POLYGON.
Consumption per query 2
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=nativetokenprice
Request Parameters
Response Example
{
"status": "1",
"message": "OK",
"result": {
"nativetokenbtc": "0.057867210944049643",
"nativetokenusd": "2954.26",
"nativetokenbtc_timestamp": "1708778400",
"nativetokenusd_timestamp": "1708778400"
}
}
Response Parameters
Parameter
Type
Description
nativetokenbtc
String
The price of the native token relative to BTC
nativetokenbtc_timestamp
String
The latest timestamp of the price update for "nativetokenbtc", in seconds
nativetokenusd
String
The latest USD price of the native token
nativetokenusd_timestamp
String
The latest timestamp of the price update for "nativetokenusd", in seconds
Get daily network transaction fee
Query the total amount of network transaction fees per day. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailytxnfee
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"UTCDate": "2019-02-01",
"transactionFee_nativetoken": "14929.4646908706"
},
{
"unixTimeStamp": "1549065600",
"UTCDate": "2019-02-02",
"transactionFee_nativetoken": "15120.386084685942"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
transactionFee_nativetoken
String
The amount of transaction fees paid to miners per day, measured in the chain's native token
Get daily new address count
Query the number of new addresses created per day. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailynewaddress
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"newAddressCount": "59997",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"newAddressCount": "70617",
"UTCDate": "2019-02-02"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
newAddressCount
String
The number of new addresses created per day
Get daily network utilization
Query the network utilization per day. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailynetutilization
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"networkUtilization": "0.8464394280243289",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"networkUtilization": "0.7686569959455622",
"UTCDate": "2019-02-02"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
networkUtilization
String
The network utilization per day, calculated based on the daily average gas consumption divided by the daily average gas limit
Get daily transaction count
Query the number of blockchain transactions per day. The supported chains include ETH, POLYGON, X1_TEST.
Consumption per query 5
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=dailytx
&startdate=2019-02-01
&enddate=2019-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1548979200",
"transactionCount": "498856",
"UTCDate": "2019-02-01"
},
{
"unixTimeStamp": "1549065600",
"transactionCount": "450314",
"UTCDate": "2019-02-02"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
transactionCount
String
The number of transactions performed on the blockchain per day
Get historical daily price of the chain's native token
Query the historical daily prices of the chain's native token across different public chains. The supported chains include ETH, POLYGON.
Consumption per query 1
Request Example
https://www.oklink.com/api/v5/explorer/eth/api
?module=stats
&action=nativetokendailyprice
&startdate=2024-02-01
&enddate=2024-02-02
&sort=asc
Request Parameters
Parameter
Type
Required
Description
startdate
String
Yes
Start date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
enddate
String
Yes
End date for the query in UTC, formatted as yyyy-MM-dd, for example, 2019-02-01
sort
String
No
"asc" for ascending order, "desc" for descending order, default is "asc"
Response Example
{
"status": "1",
"message": "OK",
"result": [
{
"unixTimeStamp": "1706745600",
"value": "2283.4",
"UTCDate": "2024-02-01"
},
{
"unixTimeStamp": "1706832000",
"value": "2303.71",
"UTCDate": "2024-02-02"
}
]
}
Response Parameters
Parameter
Type
Description
UTCDate
String
UTC date, formatted as yyyy-MM-dd, for example, 2019-02-01
unixTimeStamp
String
Seconds-level timestamp
value
String
The historical USD price of the native token per day
API Use and Management
Query the interfaces supported by the public chain, the public chains supported by the interface, and your OKLink Explorer API subscription information, historical call data, the top 10 interfaces by call consumption.
Chain supported APIs
Get the information about the supported API interfaces of a specific blockchain, the supported chains are BTC, BCH, LTC, DASH, DOGE, ETH, OKTC, X1_TEST, BSC, ETC, POLYGON, AVAXC, ETHW, DIS, FTM, OP, ARBITRUM, KLAYTN, ZKSYNC, GNOSIS, RONIN, LINEA, POLYGON_ZKEVM, APT, SUI, TRON, BEACON, STARKNET, COSMOS
Consumption per query 0HTTP Request
GET /api/v5/explorer/chain-supported-apis
Request Example
GET /api/v5/explorer/chain-supported-apis?chainShortName=btc
Request Parameters
Parameter
Type
Required
Description
chainShortName
String
Yes
The blockchain network symbol, e.g. BTC. Request the '/api/v5/explorer/blockchain/summary' interface to query the chains supported by OKLink
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"chainFullName": "Bitcoin",
"chainShortName": "BTC",
"chainSupportedApis": [
"/api/v5/explorer/btc/address-balance-details",
"/api/v5/explorer/block/address-balance-history",
"/api/v5/explorer/address/utxo",
"/api/v5/explorer/address/address-summary",
"/api/v5/explorer/btc/position-list",
"/api/v5/explorer/address/unspent",
"/api/v5/explorer/blockchain/transaction",
"/api/v5/tracker/contractscanner/token-authorized-list",
"/api/v5/explorer/address/transaction-list",
"/api/v5/explorer/btc/inscriptions-list",
"/api/v5/explorer/btc/transaction-list",
"/api/v5/explorer/btc/address-balance-list",
"/api/v5/explorer/btc/token-details",
"/api/v5/explorer/pool/pool-hashrate-rank",
"/api/v5/explorer/transaction/large-transaction-list",
"/api/v5/explorer/block/block-fills",
"/api/v5/explorer/block/block-list",
"/api/v5/explorer/transaction/transaction-fills",
"/api/v5/explorer/transaction/unconfirmed-transaction-list",
"/api/v5/explorer/transaction/publish-tx",
"/api/v5/explorer/transaction/transaction-list",
"/api/v5/explorer/blockchain/fee",
"/api/v5/explorer/address/rich-list",
"/api/v5/explorer/transaction/decode",
"/api/v5/explorer/address/balance-multi",
"/api/v5/explorer/btc/token-list",
"/api/v5/explorer/tokenprice/price-multi",
"/api/v5/explorer/blockchain/mine",
"/api/v5/explorer/stablecoin/printing-record",
"/api/v5/explorer/blockchain/address",
"/api/v5/explorer/pool/estimated-pool-share",
"/api/v5/explorer/blockchain/hashes",
"/api/v5/explorer/block/transaction-list",
"/api/v5/explorer/blockchain/info",
"/api/v5/explorer/blockchain/block"
]
}
]
}
Response Parameters
Parameter
Type
Description
chainFullName
String
The blockchain network full name, e.g. Bitcoin.
chainShortName
String
The blockchain network short name, e.g. BTC.
chainSupportedApis
String
The supported API interfaces of this chain.
API supported chains
Get the information about the supported chains of a specific API interfaces.
Consumption per query 0HTTP Request
GET /api/v5/explorer/api-supported-chains
Request Example
GET /api/v5/explorer/api-supported-chains?apiUrl=/api/v5/explorer/blockchain/info
Request Parameters
Parameter
Type
Required
Description
apiUrl
String
Yes
The URL of the API interface, e.g. /api/v5/explorer/blockchain/info
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"apiSupportedChains": [
"BTC",
"BCH",
"LTC",
"DASH",
"DOGE",
"ETH",
"OKEXCHAIN",
"X1_TEST",
"BSC",
"ETC",
"POLYGON",
"AVAXC",
"ETHW",
"ETF",
"FTM",
"OPTIMISM",
"ARBITRUM",
"KLAYTN",
"ZKSYNC",
"GNOSIS",
"RONIN",
"LINEA",
"POLYGON_ZKEVM",
"APT",
"SUI",
"TRON"
]
}
]
}
Response Parameters
Parameter
Type
Description
apiSupportedChains
Array
The supported chains of this API interface.
API management
Query your OKLink explorer API subscription information, historical call data, and the top 10 interfaces by call consumption.
Note: This module only supports the query of explorer API with call consumption > 0. The statistics are based on call consumption points, not call counts.
Subscription info
Inquire about the expiration date and usage consumption of your OKlink explorer API subscription service.
Consumption per query 0HTTP Request
GET /api/v5/explorer/management/subscription-info
Request Example
GET /api/v5/explorer/management/subscription-info
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"expirationTime": "1727107199000",
"totalCalls": "1000000",
"usedCalls": "6061",
"remainedCalls": "993939"
}
]
}
Response Parameters
Parameter
Type
Description
expirationTime
String
Expiration time of the subscription. Unix timestamp format in milliseconds, e.g. 1597026383085
totalCalls
String
Total number of call consumptions allowed in the subscription per year
usedCalls
String
Number of calls consumed so far
remainedCalls
String
Remaining number of call consumptions available
Call history
Query the historical daily call consumption of your OKlink explorer API subscription, with a maximum time span of one month. By default, it returns the call data for the past month.
Consumption per query 0HTTP Request
GET /api/v5/explorer/management/call-history
Request Example
GET /api/v5/explorer/management/call-history
Request Parameters
Parameter
Type
Required
Description
startTime
String
No
Start time of the query. Unix timestamp format in milliseconds, e.g. 1597026383085
endTime
String
No
End time of the query. Unix timestamp format in milliseconds, e.g. 1597026383085
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"time": "1696608000000",
"calls": "6"
},
{
"time": "1696780800000",
"calls": "369"
}
]
}
Response Parameters
Parameter
Type
Description
time
String
Call date, on a daily basis. Unix timestamp format in milliseconds, e.g. 1597026383085
dailyCalls
String
Call consumption on the day
Top 10 calls
Query the top 10 interfaces with the highest accumulated usage consumption, returning the usage data for up to the past year.
Consumption per query 0HTTP Request
GET /api/v5/explorer/management/top-calls
Request Example
GET /api/v5/explorer/management/top-calls
Response Example
{
"code": "0",
"msg": "",
"data": [
{
"topCalls": [
{
"rank": "1",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},
{
"rank": "2",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},
{
"rank": "3",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},
{
"rank": "4",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
},{
"rank": "5",
"apiUrl": "/api/v5/explorer/blockchain/info",
"calls": "249"
}
]
}
]
}
Response Parameters
Parameter
Type
Description
topCalls
Array
Top 10 interfaces with the highest usage consumption
> rank
String
Rank of the interface based on usage consumption
> apiUrl
String
URL of the API interface, e.g., /api/v5/explorer/blockchain/info
> calls
String
Total usage consumption of the API interface
LTC Explorer | Blockchain Explorer | OKLink
Explorer | Blockchain Explorer | OKLinkBy clicking "Accept", you agree to the storing of cookies on your device to improve your browsing experience, analyze web traffic, and enhance security.AcceptExplorerOnchain AMLWhy OKLink Onchain AMLOKLink Onchain AML is committed to crypto compliance, risk prevention with cutting-edge technologies and premium servicesKYTMonitor on-chain risks to ensure crypto asset securityKYAGet an overview of address risks to improve compliance awarenessSecurity auditConduct on-chain data analysis for dual security protectionChaintelligenceWhy OKLink ChaintelligenceOKLink Chaintelligence serves as a pioneer of blockchain security to empower enforcement and compliance teamsCompliance analysis toolsMake investigations hassle-freeSituation awarenessDetect risks through smart alertsReport & ConsultReport crypto crime and access professional guidanceAPIsLTC halving is coming soon: 00 days 00 hours 00 minutesLearn moreLitecoinHomeBlockchainDevelopersMoreMoreLitecoin (LTC) is a cryptocurrency build on top of the Bitcoin code. LTC has faster block generation speed and lower transaction fees compared to BTC. The design goal of LTC is to become a digital currency that users can buy and trade on a daily basis. LTC adopts the same decentralized, open-source and secure encryption technology as BTC. LTC has been continuously advancing development and improvement, and actively exploring a wider range of application scenarios.Litecoin (LTC) is a cryptocurrency build on top of the Bitcoin code. LTC has faster block generation speed and lower transaction fees compared to BTC. The design goal of LTC is to become a digital currency that users can buy and trade on a daily basis. LTC adopts the same decentralized, open-source and secure encryption technology as BTC. LTC has been continuously advancing development and improvement, and actively exploring a wider range of application scenarios.
English简体中文English繁體中文DeutschEspañolFrançaisPortuguésPусскийTiếng ViệtTürkçe한국어日本語ExplorerBitcoinEthereumOKT ChainTRONBNB ChainPolygonzkSync EraStarkNetArbitrum OneOptimismEthereumPoWSuiCosmos HubTether USDAvalanche-CLitecoinDIS CHAINFantomOKT Chain TestnetX1 TestnetEthereum ClassicSolanaAptosBeacon ChainBitcoin CashDASHDogecoinGnosisKlaytnRoninLineaPolygon zkEVMScrollBaseopBNB MainnetGoerli TestnetSepolia TestnetAmoy TestnetPolygon zkEVM TestnetMumbai TestnetCantoManta PacificOnchain AMLKYTKYASecurity auditChaintelligenceCompliance analysis toolsSituation awarenessReport & ConsultAPIsAPI plansAPI documentationAPI managementMore about OKLinkAbout usTerms of servicePrivacy policy statementAcademyOTCContact usPartnership[email protected]Partnership[email protected]WechatTelegramTwitterWeiboDiscord© 2014-2024 OKLink.com. All Rights Reserved.Beijing ICP No. 2001701
EthereumPoW (ETHW) Explorer | Blockchain Explorer | OKLink
reumPoW (ETHW) Explorer | Blockchain Explorer | OKLinkBy clicking "Accept", you agree to the storing of cookies on your device to improve your browsing experience, analyze web traffic, and enhance security.AcceptExplorerOnchain AMLWhy OKLink Onchain AMLOKLink Onchain AML is committed to crypto compliance, risk prevention with cutting-edge technologies and premium servicesKYTMonitor on-chain risks to ensure crypto asset securityKYAGet an overview of address risks to improve compliance awarenessSecurity auditConduct on-chain data analysis for dual security protectionChaintelligenceWhy OKLink ChaintelligenceOKLink Chaintelligence serves as a pioneer of blockchain security to empower enforcement and compliance teamsCompliance analysis toolsMake investigations hassle-freeSituation awarenessDetect risks through smart alertsReport & ConsultReport crypto crime and access professional guidanceAPIsEthereum PoWHomeBlockchainDevelopersMoreMoreEthereumPoW (ETHW) is a fork chain that insists on maintaining the consensus algorithm of proof-of-work (PoW) after Ethereum switched to the proof-of-stake (PoS) algorithm.EthereumPoW (ETHW) is a fork chain that insists on maintaining the consensus algorithm of proof-of-work (PoW) after Ethereum switched to the proof-of-stake (PoS) algorithm.
English简体中文English繁體中文DeutschEspañolFrançaisPortuguésPусскийTiếng ViệtTürkçe한국어日本語ExplorerBitcoinEthereumOKT ChainTRONBNB ChainPolygonzkSync EraStarkNetArbitrum OneOptimismEthereumPoWSuiCosmos HubTether USDAvalanche-CLitecoinDIS CHAINFantomOKT Chain TestnetX1 TestnetEthereum ClassicSolanaAptosBeacon ChainBitcoin CashDASHDogecoinGnosisKlaytnRoninLineaPolygon zkEVMScrollBaseopBNB MainnetGoerli TestnetSepolia TestnetAmoy TestnetPolygon zkEVM TestnetMumbai TestnetCantoManta PacificOnchain AMLKYTKYASecurity auditChaintelligenceCompliance analysis toolsSituation awarenessReport & ConsultAPIsAPI plansAPI documentationAPI managementMore about OKLinkAbout usTerms of servicePrivacy policy statementAcademyOTCContact usPartnership[email protected]Partnership[email protected]WechatTelegramTwitterWeiboDiscord© 2014-2024 OKLink.com. All Rights Reserved.Beijing ICP No. 2001701
How OKLink Is Empowering Users through OKLink Explorer
How OKLink Is Empowering Users through OKLink Explorer
We use cookies to improve your experience.
Accept
Learn
NewsOpinion
Bitcoin
Altcoins
Press Releases
RankingsConvert
Exchanges
Prices
Web3 Jobs
BeVerified
Advertise
Learn-to-EarnNew
en
Spanish
Russian
Turkish (Turkey)
Korean
Vietnamese
German (Germany)
Portuguese
Français
Poland
Indonesia
Thailand
عرب
日本語
Italiana
Nederlands
/
en
Spanish
Russian
Turkish (Turkey)
Korean
Vietnamese
German (Germany)
Portuguese
Français
Poland
Indonesia
Thailand
عرب
日本語
Italiana
Nederlands
Edit
See More
You can only choose 10 coins
Home/
Business
/
Partnered
Navigating the Complexities of Blockchain: How OKLink Is Empowering Users through OKLink Explorer
8 mins
By Dirk van Haaster
18 December 2023, 13:01 GMT+0000
Updated by
Dirk van Haaster
20 December 2023, 08:44 GMT+0000
Join our Trading Community on Telegram
Share on Twitter
Share on Email
Share on Linkedin
Editorial Note: The following content does not reflect the views or opinions of BeInCrypto. It is provided for informational purposes only and should not be interpreted as financial advice. Please conduct your own research before making any investment decisions.
There is no doubt that with the evolving blockchain technology, the network ecosystem is becoming increasingly complex. A multitude of chains offer diverse functionalities, from smart contracts to DeFi services, NFT marketplaces, and beyond.
At the core of this evolution lies a vital need: users require reliable, strong, and accessible data to navigate the blockchain seas. This is where OKLink, a cutting-edge blockchain information service, serves as a guiding platform for navigators of the expansive cryptocurrency world.
At present, the blockchain network ecosystem is a big web of multiple layers, chains, and nodes, each playing a critical role in the infrastructure that supports a wide array of applications.
Layer 1 networks, including Ethereum, Solana, Avalanche, TRON, and Polygon, form the backbone of the blockchain world, supporting countless decentralized applications. These foundational networks provide essential consensus mechanisms and robust security models, enabling decentralized transactions and setting the stage for diverse blockchain applications.
Layer 2 solutions are gaining immense traction, particularly Ethereum-based networks. These include Polygon, along with others like zkEVM, opBNB, Base, zkSync Era, Linea, Starknet, and Optimism. Layer 2 networks are pivotal in enhancing the scalability, speed, and efficiency of blockchain transactions, significantly contributing to the evolution of the Web3 ecosystem.
OKLink Explorer, keeping pace with these trends, extends its support to a wide array of Layer 2 networks, recognizing their growing importance and popularity. Among these, OKLink’s own X1 stands out as a cutting-edge Layer 2 solution, exemplifying the platform’s commitment to embracing and integrating advanced blockchain technologies.
This support for both Layer 1 and Layer 2 networks underlines OKLink Explorer’s role as a comprehensive tool, equipped to navigate the complex and multi-layered blockchain landscape.
However, the increasing complexity of the ecosystem has made it challenging for users to stay informed and make decisions. Transaction volumes are soaring, new DeFi protocols are launching daily, and NFTs are redefining digital ownership.
Amidst this, the distributed and continuous nature of ledgers has compounded the need for sophisticated data analysis tools.
The Core User Needs in a Complex Ecosystem
In this big blockchain ecosystem, users have certain needs to navigate through this expanding world. Let’s examine the key requirements essential for users in this space.
Reliable and Timely Information
The first and foremost need is access to reliable and timely information. Users demand up-to-the-minute data that can inform their decisions, whether trading cryptocurrencies, minting NFTs, or deploying smart contracts. The accuracy of this data is the cornerstone upon which trust is built, and decisions are made.
Explore the OKLink explorer here
Clear On-Chain Transaction Records
As users delve into blockchain applications, they require crystal-clear on-chain transaction records. They contain the history of interactions, the movement of assets, and the records of smart contract executions.
Sponsored
Sponsored
Users need these insights to track their activities, audit their transactions, and strategize their next moves. This transparency must be coupled with depth, providing a detailed view of the transactions while maintaining simplicity in interpretation.
Interoperability Across Networks
Users often operate across multiple blockchains, requiring seamless interoperability. They need tools and platforms that allow them to move assets, execute contracts, and engage with applications across different chains without friction.
This interoperability is vital not only for user convenience but also for the broader integration and adoption of blockchain technology.
OKLink: The Frontrunner of Blockchain Transparency and Accessibility
While the OKLink Explorer is a significant aspect of OKLink’s offerings, it’s important to understand that OKLink encompasses a broader ecosystem, delivering a suite of services that extend well beyond exploration.
OKLink, as a holistic platform, includes not only the advanced blockchain explorer but also an API service, along with Onchain AML and investigation capabilities. This comprehensive approach caters to a wide range of needs within the blockchain community, from basic data access and analysis to advanced risk and compliance monitoring.
The OKLink Explorer, a key component of this ecosystem, provides users with in-depth insights into blockchain transactions and activities, but it represents just one facet of the diverse tools and services OKLink offers to enhance the blockchain experience for users and developers alike.
To understand the multifaceted nature of OKLink, one must delve deeper into its core functions and innovative features:
Comprehensive Data Analysis with OKLink
Central to OKLink’s appeal is its capacity for full data analysis. This platform is not just about presenting raw data. OKLink’s advanced analytics dive deep into the complexities of the blockchain, offering users detailed insights into everything from market trends to individual transaction nuances.
Whether it’s DeFi protocols, NFT marketplaces, or standard cryptocurrency transactions, OKLink provides a holistic view, making it a treasure trove for data-driven decision-making.
By providing an interface that tears down the complexity of blockchain networks, OKLink has democratized data accessibility, enabling both novices and veterans alike to traverse the multifaceted realms of cryptocurrency with confidence.
OKLink has crafted a universal explorer that goes beyond the scope of traditional blockchain explorers. It serves as a panoramic lens through which users can observe 36 public chains in their entirety and growing. This inclusivity has significantly lowered the barriers to entry, fostering a more informed and diverse blockchain community.
User-Friendly Interface for Easy Navigation
Recognizing the diverse range of its users, from seasoned blockchain experts to newcomers, OKLink is designed with user-friendliness at its core. The interface is intuitive and accessible, ensuring that navigating through complex blockchain data becomes a streamlined and straightforward experience.
Explorer-As-A-Service: Empowering Public Chains
Through its API integration, OKLink redefines blockchain accessibility with its unique Explorer-as-a-Service model, specifically designed to construct official blockchain explorers for L1 and L2 public chains. This service is offered free of charge, highlighting OKLink’s commitment to fostering growth within the blockchain ecosystem.
Unlike just providing API services, Explorer-as-a-Service focuses on collaborating with public chains to develop their official explorers. By offering this tailored service, OKLink enables public chains to enhance their visibility and accessibility, making blockchain data more approachable and understandable to a broader audience.
Sponsored
Sponsored
This initiative by OKLink is not just about data access; it’s about creating an interconnected and thriving environment where public chains can flourish. By removing financial barriers and offering technical expertise, OKLink paves the way for innovation and growth in the blockchain community.
Empowering Developers with Powerful Tools
OKLink’s Explorer is not just a strong platform for monitoring blockchain transactions; it’s also an invaluable resource for developers, equipped with specialized tools tailored to enhance development capabilities. This includes:
Debug Tracing Capability: OKLink Explorer offers advanced debug tracing features, allowing developers to trace and dissect the execution of transactions. This is crucial for identifying issues, optimizing smart contract performance, and ensuring the accuracy of blockchain applications.
Explorer APIs: The platform provides Explorer APIs that empower developers with flexible and powerful tools to access, analyze, and manipulate blockchain data. These APIs are designed for seamless integration, enabling developers to enrich their applications with real-time blockchain data and insights.
Anti-Money Laundering (AML) Compliance Tools: In addition to these development tools, OKLink continues to provide strong security measures such as AML screening services. These tools are integral for maintaining compliance with global regulatory standards, thereby enhancing the trustworthiness and integrity of blockchain applications.
Developers can leverage these capabilities to create more secure, efficient, and compliant blockchain solutions. As a result, OKLink not only empowers individual developers and projects but also contributes to the advancement and security of the broader blockchain ecosystem.
Meanwhile, OKLink provides advanced API for developers to utilize here. The Bytecode decompiler and Verify contract features can also help a lot. You can find more details here.
Enhancing Security With Web3 Toolkit
Besides, their extensive Web3 toolkit offers the following tools to enhance overall security on the blockchain:
Token Approval Checker
This tool allows users to check contracts approved by addresses, adding an extra layer of security to their accounts.
Historical Balance & Address Monitoring
Users can quickly check mainstream cryptocurrencies and monitor high-profile transactions, staying informed about significant movements and activities.
Address Analytics and Risk Level Assessment
OKLink provides detailed analyses of address behaviors, assets, and major counterparties. It also categorizes on-chain risks using big data, helping users understand and navigate these complexities.
Private Label Creation & DeFi Tracker
Users can create exclusive address labels and track major DeFi projects and trading behaviors for a better grasp of the DeFi space.
Transaction Map & Token Scanner
These tools trace transaction sources and highlight high-risk addresses and suspicious transactions, enhancing the safety of crypto assets.
NFT Tracer & Verify Contract
OKLink offers tools for visualized traceability of NFTs and increased contract transparency to ensure safer on-chain transactions
Developer-Focused Resources
The platform provides an extensive indicator library, comprehensive white papers, detailed developer documentation, and a bytecode decompiler to support developers in creating secure blockchain applications.
Report & Consult Platform
This first-of-its-kind platform in the blockchain industry allows for reporting and consultation to uphold justice and fairness.
Contract Audit & DeFi Project Listing
OKLink conducts automated and manual contract audits and offers DeFi projects the opportunity to be listed for public analysis.
Empowerment through the OKLink Explorer
Sponsored
Sponsored
OKLink Explorer is not just another blockchain explorer; it is a sophisticated gateway to the complex world of blockchain data. As a cutting-edge platform, it offers unparalleled access and insightful data analytics across a multitude of networks.
Unmatched Network Support
OKLink distinguishes itself by supporting data from an extensive range of 34 chains, far beyond the offerings of conventional explorers. This includes the titans of layer 1 networks like Ethereum (ETH), Solana (SOL), Avalanche (AVAX), TRON (TRX), and Polygon (MATIC).
As OKLink continues to redefine the boundaries of blockchain technology and exploration, it maintains a fundamental principle at its core: an open invitation for blockchain networks and projects to join and enrich its ecosystem.
Joining the OKLink ecosystem means tapping into a wealth of resources, expertise, and a broad user base. It’s an opportunity for blockchain projects to gain visibility, leverage advanced tools, and collaborate with other industry players.
Explore the OKLink explorer here
In Conclusion
OKLink’s services and contributions to the blockchain space cannot be overstated. Its multi-chain data platform, strong API, and comprehensive explorer tool equip users with the necessary means to navigate the complex blockchain ecosystem.
For developers, the rich set of tools accelerates innovation and simplifies the deployment of smart contracts. And perhaps most importantly, through its efforts to enhance transparency and compliance, OKLink is paving the way for a more secure and robust blockchain future.
OKLink emerges not just as a service provider but as an ecosystem enhancer, setting the benchmark for what a blockchain information service should aspire to be. It is not just contributing to the industry; it is actively shaping its trajectory towards a more integrated, accessible, and fair future.
Links:
Twitter | Telegram | Discord
Sponsored
Sponsored
Frequently Asked Questions
How many blockchains have OKLink supported now?
OKLink supports 36 public blockchains with full-node analysis, including major networks such as Bitcoin (BTC), Ethereum (ETH), and others. They continuously expand their services to include more chains. As a whole, OKLink supports 170+ chains with light-node analysis; for example, transactions & price data feeds.
Is OKLink the explorer with the most comprehensive ecosystem?
OKLink is among the explorers with the most comprehensive ecosystems, given its wide range of supported blockchains and the variety of tools it offers. It provides services like real-time transaction data, AML monitoring, and an array of analytics tools that rival the offerings of other popular explorers.
How can users make full use of the OKLink explorer?
Users can take full advantage of OKLink by utilizing its real-time data services to monitor transactions and market conditions, employing its on-chain AML solutions for enhanced security, and leveraging its analytics for deeper insights into blockchain activities.
Additionally, developers can integrate OKLink’s APIs into their own applications to access multi-chain data and improve their products’ functionality. Regular users can also benefit from the Web3 toolkit provided by OKLink, which includes various functions like token approval checks, address monitoring, and DeFi tracking, to enhance their blockchain experience.
Best crypto platforms in Europe | March 2024
YouHodler
Explore →
Wirex App
Explore →
Coinbase
Explore →
AlgosOne
Explore →
PrimeXBT
Explore →
Disclaimer
All the information contained on our website is published in good faith and for general information purposes only. Any action the reader takes upon the information found on our website is strictly at their own risk.
Share on Twitter
Share on Email
Share on Linkedin
Dirk van Haaster
READ FULL BIO
With over four years of specialized work experience in the crypto space, Dirk has gained significant expertise in producing written content for the Web3 ecosystem.
Dirk earned his Master's in Strategic Management from the renowned Erasmus University in Rotterdam, where he graduated with cum laude distinction. This academic background equips him with a unique blend of strategic thinking and analytical skills, which he successfully applies to navigate the world of blockchain technologies.
With over four years of specialized work experience in the crypto space, Dirk has gained significant expertise in producing written content for the Web3 ecosystem.
Dirk earned his Master's in Strategic Management from the renowned Erasmus University in Rotterdam, where he graduated with cum laude distinction. This academic background equips him with a unique blend of strategic thinking and analytical skills, which he successfully applies to navigate the world of blockchain technologies.
READ FULL BIO
Sponsored
Sponsored
RELATED NEWS
Business
News Report
This Bitcoin Miner Shutters Canadian Facility Amid Energy Crisis
2 mins
6 hours ago
Business
News Report
A16z Eyes $6.9 Billion AI Investment, Pauses Crypto Fund Expansion
2 mins
7 hours ago
Business
News Report
BlockFi Customers Could Be Made Whole After $874M FTX, Alameda Settlement
2 mins
9 hours ago
Business
Partnered
CoinEx Revolutionizes Crypto with Groundbreaking Bitcoin Halving Video
5 mins
1 day ago
Business
Guest expert
Interview | MetaMask & Consensys Staking: Exploring Validator Staking on the MetaMask Portfolio
8 mins
3 days ago
Best crypto platforms in Europe | March 2024
YouHodler
Explore →
Wirex App
Explore →
Coinbase
Explore →
AlgosOne
Explore →
PrimeXBT
Explore →
Most Read
TON Foundation X AMA Session With BeInCrypto
15 mins
14 Best No KYC Crypto Exchanges in 2024
18 mins
Best of February
Best of February
Morgan Stanley Seeks Indirect Exposure to Bitcoin
2 mins
4 days ago
Cyber Security Experts Explain How to Avoid Getting Your Crypto Wallet Hacked
2 mins
5 days ago
3 Lesser-Known Altcoins to Watch for Potential Gains in March
2 mins
4 days ago
Top 20 Crypto Launchpads To Jump On in March 2024
19 mins
Investing
Investing
Want to know more?
Join our Telegram Group and get trading signals, a free trading course and daily communication with crypto fans!
Join Our Telegram
Sponsored
Sponsored
Stay up to date on crypto
Join our newsletter
Subscribe
CompanyAbout UsOur AuthorsCareers Our TeamEditorialProductsNewsCryptocurrenciesExchangesLearnWeb3 MarketingResourcesAdvertiseRemote JobsContactThe Trust ProjectVerification Methodology
© 2024 BeInNews Academy.
Terms
Privacy
Disclaimer