On-chain DEX API
用 REST 拿 DEX 价格、池子、K 线和成交
Ethereum, Base, Arbitrum 上索引好的 DEX 数据：代币的当前与历史价格、流动性池、OHLCV K 线、成交和持有人。不用自己跑节点或索引器，一次 HTTPS 调用就够。
- REST + WebSocket
- 一个密钥通用
- 3 条链
- Ethereum, Base, Arbitrum
- 免费 100,000 次
- 每 30 天
直接试 API，无需 key
选链和路由，点发送。返回的是真实数据，与用 key 调用的是同一个 API。
每个核心功能都试一遍
价格 Pricing
当前价与批量价格，点发送后展开查看 JSON。
历史数据 Historical
1 分钟到 1 天的 OHLCV K 线，下方实时 demo 的图用的是同一份数据。
钱包 Wallet
持有人排行、地址持仓与池子成交，与 DEX API 共用同一个 key 和配额。
Live demo
在线体验 DEX 实时价格与 K 线
匿名可试、无需 key：本示例经短时缓存读取的就是你拿 key 调用的同一套 API。尽力而为（best effort），不代表 API 的延迟或配额。
价格
覆盖 Ethereum、Base、Arbitrum 上的头部 token。至少输入 2 个字符，或粘贴完整地址。
Ethereum 上的 WETH
0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
- 最新价
- —
- 24h 涨跌
- —
- 24h 成交额
- —
价格在每个边缘节点每 5 秒更新一次。自己的应用请申请免费 key 直接调用 API。
试一试：实时代币价格
下面的公开示例可以直接复制运行。填入你的 On-chain DEX API 端点密钥即可，REST 和 WebSocket 用同一个密钥。
REST · 当前价格
一次 HTTPS 调用，返回 Ethereum 上 WETH 的当前 USD 价格。
curl -s "https://api.blockreq.com/v1/dex/ethereum/tokens/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2/price" \
-H "X-API-Key: $BLOCKREQ_DATA_API_KEY"{
"data": {
"chain": "ethereum",
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"at": 1794038400,
"price_usd": "3412.18",
"price_time": 1794038398,
"source": "current",
"low_liquidity": false,
"stale": false
}
}WebSocket · 价格推送即将开放
订阅 prices 频道，价格变动时服务端主动推送。
wscat -c "wss://api.blockreq.com/v1/dex/ws" \
-H "X-API-Key: $BLOCKREQ_DATA_API_KEY"{"op":"subscribe","id":"1","channel":"prices","params":{"chain":"ethereum","addresses":["0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"interval":5}}{
"op": "prices",
"subscription": "s1",
"chain": "ethereum",
"seq": 1,
"data": [
{
"chain": "ethereum",
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"price_usd": "3412.55",
"stale": false
}
]
}响应为示例，价格数字仅作示意。
能查什么
代币价格
当前 USD 价格及 24 小时涨跌和成交量，或任意历史 Unix 时间点的价格。
批量价格
一次 POST /prices 最多查 50 个代币，可跨链。
流动性池
按成交量或流动性排序的头部池、新建的池，以及单个池的详情。
OHLCV K 线
代币和池子的 1 分钟到 1 天 K 线，可按代币或 USD 计价。
成交
一个池子最近的兑换记录，用游标翻页。
持有人与持仓
已跟踪代币的持有人排行，以及一个账户的 ERC-20 余额。
/v1/dex/onchain/... 下提供与 CoinGecko onchain（GeckoTerminal）兼容的路径，已有客户端改动很小就能切换。
与 RPC 分开的独立产品
- 独立的端点和密钥：在 Dashboard 创建 On-chain DEX API 端点，把它的密钥放在 X-API-Key 头里调用 https://api.blockreq.com/v1/dex。
- 独立的配额：数据 API 调用不占用 RPC Requests、请求包或钱包余额，RPC 流量也不占用数据 API 配额。
- 目前支持的链：Ethereum, Base, Arbitrum。
- Wallet API 同属 Crypto Data API：同一个 key、同一份配额和套餐，也能查持有人排行和地址持仓。 查看 Wallet API
Free
100,000 次 / 30 天
速率限制：1 / 1 Req/s
创建第一个 On-chain DEX API 端点后获得 Free。