GET /orderbook

Get price levels for all supported pair in a chain

GET https://newapi.native.org/v1/orderbook

This endpoint provides price levels for all the supported pairs in a particular chain. This is useful to estimate the available liquidity and quote for different order sizes.

Headers

Name	Description
apiKey	API Key retrieved from the Native app.

Params

Name	Description
chain*	Blockchain name, you can refer to supported chain API.

Example

https://newapi.native.org/v1/orderbook?chain=ethereum

Response

Type: Array of order pairs

Name	Description
base_symbol	The symbol of the token the market maker is buying or selling.
base_address	The address of the token the market maker is buying or selling.
quote_symbol	The symbol of the token that will exchanged for the base token.
quote_address	The address of the token that will exchanged for the base token.
levels	This is an array of tuples in the format of [[int, int]]. The value at index 0 is the amount of tokens and the value at index 1 is the price the market maker is willing to transact at.
side	"ask" or "bid". Indicates whether the market maker is buying or selling the base token.
minimum_in_base	The minimum amount of base tokens that the market maker is willing to transact.

Example response:

[
    {
        "base_symbol": "ETH",
        "base_address": "0x2170ed0880ac9a755fd29b2688956bd959f933f8",
        "quote_symbol": "USDT",
        "quote_address": "0x55d398326f99059ff775485246999027b3197955",
        "levels": [
            [
                0.0001,
                1621.71
            ],
            [
                10,
                1621.72
            ],
            [
                40.75786733219471,
                1621.54
            ]
        ],
        "side": "bid",
        "minimum_in_base": 0.0001
    },
}

Note: the price levels returned are ordered in a non-cumulative manner. So, in the above example, if someone wanted to trade 30 ETH for USDT, the price would be: 0.0001 * 1621.71 + 10 * 1621.72 + (30 - 0.0001 - 10) * 1621.54 = 48648.00002

You may try this endpoint out here.