Nusa Documentation
English
Search
K

GET /api/quote

Returns the current swap price data for a given sell & buy token.

Request

Query Param
Description
Example
sellToken
The token contract address or symbol of the token that you want to sell. Token symbols such as BNB or NUSA can be provided as a valid sellToken. If the provided value is not supported, try using the token address instead.
sellToken=BNB, sellToken=0xe11F1D5EEE6BE945BeE3fa20dBF46FeBBC9F4A19
buyToken
The token contract address or symbol of the token that you want to buy. Token symbols such as BNB or NUSA can be provided as a valid buyToken. If the provided value is not supported, try using the token address instead.
buyToken=BNB, buyToken=0xe11F1D5EEE6BE945BeE3fa20dBF46FeBBC9F4A19
network
The blockchain network. Acceptable values are bsc, eth, polygon.
network=bsc

Response

Result is returned in the result field, and if there's any error message, it will be returned in the error field. result contents are defined as follows:
Field
Description
network
The selected blockchain network.
sell_token
Token metadata for the selected sell token. Example: "sell_token": { "name": "Binance-Peg BTCB Token", "symbol": "BTCB", "decimals": "18", "address": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c" }
buy_token
Token metadata for the selected buy token. Example: "buy_token": { "name": "Binance-Peg BUSD Token", "symbol": "BUSD", "decimals": "18", "address": "0xe9e7cea3dedca5984780bafc599bd69add087d56" }
price
The current price. The amount of buy_token that you will receive for 1 sell_token.

Example

Request: GET
https://api.nusa.finance/api/quote?sellToken=BTCB&buyToken=0xe9e7cea3dedca5984780bafc599bd69add087d56
Response
{
"result": {
"network": "bsc",
"sell_token": {
"name": "Binance-Peg BTCB Token",
"symbol": "BTCB",
"decimals": "18",
"address": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c"
},
"buy_token": {
"name": "Binance-Peg BUSD Token",
"symbol": "BUSD",
"decimals": "18",
"address": "0xe9e7cea3dedca5984780bafc599bd69add087d56"
},
"price": "22868.882110165316"
}
}