REST API
URL
https://api.benswap.cash/
List of all public API endpoints
*If the public RPC node is down, some API endpoints may be temporarily unavailable.
BCH
Latest BCH price.
GET /api/bch/price
Some history prices in the past 7 days
GET /api/bch/historyPrices
smartBCH
Latest SBCH Price.
GET /api/smartbch/price
General Info.
GET /api/smartbch/info
Latest block height.
GET /api/smartbch/block
Closest block height at Unix timestamp (seconds).
GET /api/smartbch/block/{timestamp}
GET /api/smartbch/block?timestamp={timestamp}
Unix timestamp (seconds) of the latest block.
GET /api/smartbch/timestamp
Unix timestamp (seconds) at specific block.
GET /api/smartbch/timestamp/{block}
GET /api/smartbch/timestamp?block={block}
RPC nodes.
GET /api/smartbch/rpc
Check RPC node by name.
GET /api/smartbch/rpc/{name}
GET /api/smartbch/rpc?name={name}
SEP20
SEP-20 token basic information (id is token contract address). Works for all SEP-20 tokens.
GET /api/sep20/tokenbasics/{id}
GET /api/sep20/tokenbasics?id={id}
GET /api/sep20/token/{id}
GET /api/sep20/token?id={id}
SEP-20 token liquidity detail across multiple DEXes. Works for all SEP-20 tokens.
GET /api/sep20/liquidity/{id}
GET /api/sep20/liquidity?id={id}
EBEN
Current supply summary.
GET /api/eben/supply
Current total supply.
GET /api/eben/total
Current total burned.
GET /api/eben/burned
Current circulating supply.
GET /api/eben/circulating
Current staked info in major LPs, pools, and DeFi contracts etc.
GET /api/eben/staked
Current EBEN price (per USD).
GET /api/eben/priceUsd
Current EBEN price (per SBCH).
GET /api/eben/priceSbch
DEX
Warning: USD based data are missing before block 820000. Statistics like "totalVolumeUsd", "volumeUsd" only include volume after block 820000, and statistics like "priceUsd", "liquidityUsd" will be 0 if you use a block number less than 820000. USD data are also distorted between May and September in 2022 due to the de-pegging of the previous de facto stable coin: flexUSD.
DEX stats.
GET /api/dex/stats
DEX stats at specific block.
GET /api/dex/stats/{block}
GET /api/dex/stats?block={block}
Pairs that have enough liquidity.
GET /api/dex/pairs
Single pair data (id is LP address). Must have enough liquidity on DEX.
GET /api/dex/pair/{id}
GET /api/dex/pair?id={id}
Single pair at specific block (id is LP address).
GET /api/dex/pair/{id}/{block}
GET /api/dex/pair?id={id}&block={block}
Tokens that have enough liquidity.
GET /api/dex/tokens
Single token data (id is token address). Must have enough liquidity on DEX.
GET /api/dex/token/{id}
GET /api/dex/token?id={id}
Single token at specific block (id is token address).
GET /api/dex/token/{id}/{block}
GET /api/dex/token?id={id}&block={block}
Latest candlestick trading data for a token (id is token address). "baseCurrency" has to be either "bch" or "usd". "range" has to be one of these ["1min", "15mins", "1h", "1d", "1w"]. Maximum return is 1000 records.
GET /api/dex/trade/{baseCurrency}/{range}/{id}
GET /api/dex/trade/{baseCurrency}/{range}?id={id}
Same as above, but with specific ending time (not inclusive) to get earlier records. "before" has to be a valid Unix timestamp (seconds).
GET /api/dex/trade/{baseCurrency}/{range}/{id}/{before}
GET /api/dex/trade/{baseCurrency}/{range}?id={id}&before={before}
Lottery
Get lottery ticket data by its NFT ID.
GET /api/lotteryTicket/{id}
GET /api/lotteryTicket?id={id}
PokéBen
Get a PokéBen's metadata by PokéBen ID.
GET /api/pokeben/data/{id}
GET /api/pokeben/data?id={id}
Get a PokéBen item's metadata by Item ID.
GET /api/pokeben/item/{id}
GET /api/pokeben/item?id={id}
Current total number of PokéBen.
GET /api/pokeben/supply
Current total number of PokéBen items.
GET /api/pokeben/itemSupply
Top PokéBens ranking by power. 20 items per page.
GET /api/pokeben/ranking/power/{page}
GET /api/pokeben/ranking/power?page={page}
Top PokéBens ranking by level. 20 items per page.
GET /api/pokeben/ranking/level/{page}
GET /api/pokeben/ranking/level?page={page}
Bridge
Current information of all bridged tokens.
GET /api/bridge
Others
Unix timestamp (milliseconds) of server time
GET /api/time
Last updated