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"
    }
}