# 应用程序编程接口（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>