GeckoTerminal API V2 使用文档

注意：此API目前处于Beta版本，可能会有频繁更新。我们建议设置请求版本以避免意外问题。

基本信息

基础URL： https://api.geckoterminal.com/api/v2
版本： v2-beta (OAS3)
状态： Beta版本

版本控制

建议通过Accept头部设置API版本。当前版本为20230302。

Accept: application/json;version=20230302

如果不指定版本，将使用最新版本。

数据刷新

所有端点缓存时间为1分钟
数据更新速度：区块链交易确认后2-3秒内更新（取决于网络可用性）

速率限制

免费API限制：30次/分钟
若需更高速率限制，可订阅CoinGecko API付费计划

API端点

简单请求

GET /simple/networks/{network}/token_price/{addresses}

获取指定网络上多个代币的当前美元价格

网络

GET /networks

获取支持的网络列表

去中心化交易所(DEX)

GET /networks/{network}/dexes

获取指定网络上支持的DEX列表

流动性池

GET /networks/trending_pools

获取所有网络的热门流动性池

GET /networks/{network}/trending_pools

获取指定网络的热门流动性池

GET /networks/{network}/pools/{address}

获取指定网络上的特定流动性池

GET /networks/{network}/pools/multi/{addresses}

获取指定网络上的多个流动性池

GET /networks/{network}/pools

获取指定网络上的顶级流动性池

GET /networks/{network}/dexes/{dex}/pools

获取指定网络的DEX上的顶级流动性池

GET /networks/{network}/new_pools

获取指定网络上的最新流动性池

GET /networks/new_pools

获取所有网络的最新流动性池

GET /search/pools

在指定网络上搜索流动性池

代币

GET /networks/{network}/tokens/{token_address}/pools

获取代币的顶级流动性池

GET /networks/{network}/tokens/{address}

获取指定网络上的特定代币

GET /networks/{network}/tokens/multi/{addresses}

获取指定网络上的多个代币

GET /networks/{network}/tokens/{address}/info

获取指定网络上特定代币的信息

GET /networks/{network}/pools/{pool_address}/info

获取指定网络上流动性池的代币信息

GET /tokens/info_recently_updated

获取所有网络上最近更新的100个代币信息

OHLCV数据（开盘价、最高价、最低价、收盘价、交易量）

GET /networks/{network}/pools/{pool_address}/ohlcv/{timeframe}

获取流动性池的OHLCV数据，最多可查询6个月前的数据

交易

GET /networks/{network}/pools/{pool_address}/trades

获取流动性池过去24小时内的最近300笔交易

数据架构

errors_object
relationships
simple_token_price
token
token_info
pool
pool_details
ohlcv
ohlcv_token
trade

使用示例

获取以太坊网络上的热门流动性池

GET https://api.geckoterminal.com/api/v2/networks/eth/trending_pools

获取代币价格

GET https://api.geckoterminal.com/api/v2/simple/networks/eth/token_price/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984,0x6b175474e89094c44da98b954eedeac495271d0f

提示：如需了解更多信息或获得API更新通知，请通过官方表单订阅更新。