# 应用程序编程接口（API）

### 链接

<https://api.benswap.cash/>

### 公共应用程序编程接口（API）端点列表

\*如果公共RPC节点出现宕机，可能会导致某些API接口暂时不可用。

#### BCH

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>最新价格</td><td>GET /api/bch/price</td><td></td></tr><tr><td>7天内的一些历史价格</td><td>GET /api/bch/historyPrices</td><td></td></tr></tbody></table>

#### smartBCH

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>最新价格（SBCH）</td><td>GET /api/smartbch/price</td><td></td></tr><tr><td>基本信息</td><td>GET /api/smartbch/info</td><td></td></tr><tr><td>最新区块高度</td><td>GET /api/smartbch/block</td><td></td></tr><tr><td>Unix时间戳（秒）最近的区块高度</td><td><p>GET /api/smartbch/block/{timestamp} </p><p>GET /api/smartbch/block?timestamp={timestamp}</p></td><td></td></tr><tr><td>Unix时间戳（秒）最新区块</td><td>GET /api/smartbch/timestamp</td><td></td></tr><tr><td>特定区块的Unix时间戳（秒）</td><td><p>GET /api/smartbch/timestamp/{block}</p><p>GET /api/smartbch/timestamp?block={block}</p></td><td></td></tr><tr><td>RPC节点</td><td>GET /api/smartbch/rpc</td><td></td></tr><tr><td>按名称检查RPC节点</td><td><p>GET /api/smartbch/rpc/{name} </p><p>GET /api/smartbch/rpc?name={name}</p></td><td></td></tr></tbody></table>

#### SEP20

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>SEP-20代币基本信息（id表示代币合约地址）。任何SEP-20代币都能用。</td><td><p>GET /api/sep20/tokenbasics/{id}</p><p>GET /api/sep20/tokenbasics?id={id}</p></td><td></td></tr><tr><td>SEP-20代币信息（id表示代币合约地址）。代币必须已在<a href="https://github.com/BenTokenFinance/benswapbch-assets">BenSwap资产主仓库</a>的/assets文件夹中注册。</td><td><p>GET /api/sep20/token/{id}</p><p>GET /api/sep20/token?id={id}</p></td><td></td></tr><tr><td>SEP-20代币在各个去中心化交易所的流动性情况。任何SEP-20代币都能用。</td><td><p>GET /api/sep20/liquidity/{id} </p><p>GET /api/sep20/liquidity?id={id}</p></td><td></td></tr></tbody></table>

#### EBEN

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>当前供应量总结</td><td>GET /api/eben/supply</td><td></td></tr><tr><td>当前总供应量</td><td>GET /api/eben/total</td><td></td></tr><tr><td>当前总燃烧量</td><td>GET /api/eben/burned</td><td></td></tr><tr><td>当前流通供应量</td><td>GET /api/eben/circulating</td><td></td></tr><tr><td>当前主要LP、矿池、DeFi合约等的质押信息</td><td>GET /api/eben/staked</td><td></td></tr><tr><td>当前EBEN价格（按美元）</td><td>GET /api/eben/priceUsd</td><td></td></tr><tr><td>当前EBEN价格（按SBCH）</td><td>GET /api/eben/priceSbch</td><td></td></tr></tbody></table>

#### 去中心化交易所

**提示**：区块820000之前基于美元的数据缺失。诸如“totalVolumeUsd”、“volumeUsd”之类的数据仅涵盖区块 820000 之后的；当区块小于820000，“priceUsd”、“liquidityUsd”之类的数据将为 0。另外，由于之前默认的稳定币flexUSD的脱锚事件，在2022年5月到9月之间的美元数据是被扭曲了的。

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>交易所数据</td><td>GET /api/dex/stats</td><td></td></tr><tr><td>交易所在特定区块的数据</td><td><p>GET /api/dex/stats/{block}</p><p>GET /api/dex/stats?block={block}</p></td><td></td></tr><tr><td>有足够流动性的交易对</td><td>GET /api/dex/pairs</td><td></td></tr><tr><td>单个交易对的数据（id是LP合约地址）。必须在交易所上面有足够的流动性。</td><td><p>GET /api/dex/pair/{id}</p><p>GET /api/dex/pair?id={id}</p></td><td></td></tr><tr><td>在特定区块的单个交易对（id是LP合约地址）。</td><td><p>GET /api/dex/pair/{id}/{block}</p><p>GET /api/dex/pair?id={id}&#x26;block={block}</p></td><td></td></tr><tr><td>有足够流动性的代币</td><td>GET /api/dex/tokens</td><td></td></tr><tr><td>单个代币的数据（id是代币合约地址）。必须在交易所上面有足够的流动性。</td><td><p>GET /api/dex/token/{id}</p><p>GET /api/dex/token?id={id}</p></td><td></td></tr><tr><td>在特定区块的单个代币（id是代币合约地址）。</td><td><p>GET /api/dex/token/{id}/{block}</p><p>GET /api/dex/token?id={id}&#x26;block={block}</p></td><td></td></tr><tr><td>代币最新K线交易记录（id是代币合约地址）。“baseCurrency”必须是“bch”或者“usd”。“range”必须是以下其中之一["1min"，"15mins"，"1h"，"1d"，"1w"]。最多返回1000条记录。</td><td><p>GET /api/dex/trade/{baseCurrency}/{range}/{id}</p><p>GET /api/dex/trade/{baseCurrency}/{range}?id={id}</p></td><td></td></tr><tr><td>与上一条相同，但是（不包括）有特定的结束时间来获得更早的数据。“before”必须是有效的Unix时间戳（秒）。</td><td><p>GET /api/dex/trade/{baseCurrency}/{range}/{id}/{before}</p><p>GET /api/dex/trade/{baseCurrency}/{range}?id={id}&#x26;before={before}</p></td><td></td></tr></tbody></table>

**彩票**

| 通过彩票NFT的ID获取该彩票详情 | <p>GET /api/lotteryTicket/{id}</p><p>GET /api/lotteryTicket?id={id}</p> |
| ----------------- | ----------------------------------------------------------------------- |

#### 精灵宝可本

| 通过ID获取精灵元数据。   | <p>GET /api/pokeben/data/{id}</p><p>GET /api/pokeben/data?id={id}</p>                         |
| -------------- | --------------------------------------------------------------------------------------------- |
| 通过ID获取物品元数据。   | <p>GET /api/pokeben/item/{id}</p><p>GET /api/pokeben/item?id={id}</p>                         |
| 当前精灵总数。        | GET /api/pokeben/supply                                                                       |
| 当前物品总数。        | GET /api/pokeben/itemSupply                                                                   |
| 战力排行榜，每页最多20条。 | <p>GET /api/pokeben/ranking/power/{page}</p><p>GET /api/pokeben/ranking/power?page={page}</p> |
| 等级排行榜，每页最多20条。 | <p>GET /api/pokeben/ranking/level/{page}</p><p>GET /api/pokeben/ranking/level?page={page}</p> |

#### 跨链桥 <a href="#undefined" id="undefined"></a>

| 当前所有桥接的币种信息。 | GET /api/bridge |
| ------------ | --------------- |

#### 其他

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>服务器时间的Unix时间戳（毫秒）</td><td>GET /api/time</td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.benswap.cash/zhong-wen/features/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.