All SparkSwap pairs consist of two different tokens. BNB is not a native currency in SparkSwap, and is represented only by WBNB in the pairs.
The canonical WBNB address used by the SparkSwap interface is 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c.
Results are edge-cached for 1 minute (or 60 seconds) and refreshed in background (stale-while-revalidate).
Returns data for the top ~1000 SparkSwap pairs, sorted by reserves.
GET https://api.sparkswap.info/api/summary
{
"0x..._0x...": { // the asset ids of the BEP20 tokens (i.e. token addresses), joined by an underscore
"last_price": 1.234, // denominated in token0/token1
"base_volume": 123.456, // last 24h volume denominated in token0
"quote_volume": 1234.56, // last 24h volume denominated in token1
"liquidity": 1234.56, // liquidity denominated in USD
"liquidity_BNB": 1234.56 // liquidity denominated in BNB
},
// ...
}Returns the tokens in the top ~1000 pairs on SparkSwap, sorted by reserves.
GET https://api.sparkswap.info/api/assets
{
// ...,
"0x...": { // the address of the BEP20 token
"name": "...", // not necessarily included for BEP20 tokens
"symbol": "...", // not necessarily included for BEP20 tokens
"last_price": 1.234, // denominated in USD
"maker_fee": 0, // always 0
"taker_fee": 0.002, // always 0.002 i.e. .2%
},
// ...
}Returns data for the top ~1000 SparkSwap pairs, sorted by reserves.
GET https://api.sparkswap.info/api/tickers
{
"0x..._0x...": { // the asset ids of BNB and BEP20 tokens, joined by an underscore
"base_name": "...", // token0 name
"base_symbol": "...", // token0 symbol
"base_address": "0x...", // token0 address
"base_id": "0x...", // token0 address
"quote_name": "...", // token1 name
"quote_symbol": "...", // token1 symbol
"quote_address": "0x...", // token1 address
"quote_id": "0x...", // token1 address
"last_price": 1.234, // the mid price as token1/token0
"base_volume": 123.456, // denominated in token0
"quote_volume": 1234.56, // denominated in token1
"liquidity": 1234.56, // liquidity denominated in USD
"liquidity_BNB": 1234.56 // liquidity denominated in BNB
},
// ...
}Returns simulated orderbook data for the given SparkSwap pair. Since SparkSwap has a continuous orderbook, fixed amounts in an interval are chosen for bids and asks, and prices are derived from the SparkSwap formula (accounting for both slippage and fees paid to LPs).
GET https://api.sparkswap.info/api/orderbook/:pair
pair: The asset ids of two BEP20 tokens, joined by an underscore, e.g.0x..._0x.... The first token address is considered the base in the response.
{
"updated_at": 1234567, // UNIX timestamp of the response
"bids": [
[12, 1.2], // denominated in base token, quote token/base token
[12, 1.1], // denominated in base token, quote token/base token
// ...
],
"asks": [
[12, 1.3], // denominated in base token, quote token/base token
[12, 1.4], // denominated in base token, quote token/base token
// ...
]
}Returns all swaps in the last 24 hours for the given SparkSwap pair.
The pair address is the address of the two tokens in either order. The first address is considered the base in the response.
pair: The asset ids of two BEP20 tokens, joined by an underscore, e.g.0x..._0x.... The first token address is considered the base in the response.
GET https://api.sparkswap.info/api/trades/:pair
[
{
"trade_id": "...",
"price": "1.234", // denominated in quote token/base token
"base_volume": "123.456", // denominated in base token
"quote_volume": "1234.56", // denominated in quote token
"trade_timestamp": 1234567, // UNIX timestamp
"type": "buy" // "buy"/"sell"/"borrow-both"/"???"
},
// ...
]