Get live orderbook

curl --request GET \
  --url https://propamm.kipseli.win/v2/price \
  --header 'X-API-KEY: <api-key>'

{
  "blockNumber": 29500000,
  "blockTime": 1741737600,
  "pairs": [
    {
      "baseToken": "0x4200000000000000000000000000000000000006",
      "quoteToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "bids": [
        {
          "price": "3200.50",
          "amount": "1.0"
        },
        {
          "price": "3198.00",
          "amount": "5.0"
        },
        {
          "price": "3190.25",
          "amount": "10.0"
        }
      ],
      "asks": [
        {
          "price": "3201.75",
          "amount": "1.0"
        },
        {
          "price": "3204.00",
          "amount": "5.0"
        },
        {
          "price": "3210.50",
          "amount": "10.0"
        }
      ]
    },
    {
      "baseToken": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
      "quoteToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "bids": [
        {
          "price": "97500.00",
          "amount": "0.01"
        },
        {
          "price": "97200.00",
          "amount": "0.05"
        }
      ],
      "asks": [
        {
          "price": "97600.00",
          "amount": "0.01"
        },
        {
          "price": "97900.00",
          "amount": "0.05"
        }
      ]
    }
  ]
}

API Reference

Get Orderbook

Returns the latest cached on-chain orderbook for all configured token pairs. The cache refreshes on every new block via eth_subscribe, so the data always reflects the most recent chain state.

Each pair has a baseToken (non-USDC token, e.g. WETH) and a quoteToken (USDC). Prices are expressed as USDC per base token (decimal strings). Amounts are human-readable base token quantities (decimal strings).

Levels are marginal — each level is an independent price point, not cumulative depth. bids are sorted descending (best bid first); asks are sorted ascending (best ask first).

GET

price

Get live orderbook

curl --request GET \
  --url https://propamm.kipseli.win/v2/price \
  --header 'X-API-KEY: <api-key>'

{
  "blockNumber": 29500000,
  "blockTime": 1741737600,
  "pairs": [
    {
      "baseToken": "0x4200000000000000000000000000000000000006",
      "quoteToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "bids": [
        {
          "price": "3200.50",
          "amount": "1.0"
        },
        {
          "price": "3198.00",
          "amount": "5.0"
        },
        {
          "price": "3190.25",
          "amount": "10.0"
        }
      ],
      "asks": [
        {
          "price": "3201.75",
          "amount": "1.0"
        },
        {
          "price": "3204.00",
          "amount": "5.0"
        },
        {
          "price": "3210.50",
          "amount": "10.0"
        }
      ]
    },
    {
      "baseToken": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
      "quoteToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "bids": [
        {
          "price": "97500.00",
          "amount": "0.01"
        },
        {
          "price": "97200.00",
          "amount": "0.05"
        }
      ],
      "asks": [
        {
          "price": "97600.00",
          "amount": "0.01"
        },
        {
          "price": "97900.00",
          "amount": "0.05"
        }
      ]
    }
  ]
}

Returns the live on-chain orderbook for all configured token pairs. The cache is refreshed on every new block via eth_subscribe, so the response always reflects the most recent chain state. Use this endpoint to get current market prices before executing a swap, or to display market depth to users.

Understanding the Orderbook

bids — prices at which PropAMM will buy the base token (you sell base, receive USDC). Sorted descending.
asks — prices at which PropAMM will sell the base token (you buy base, pay USDC). Sorted ascending.
Each level is marginal — independent price points, not cumulative depth.
Prices and amounts are decimal strings to preserve EVM-scale precision.

If the cache has not been populated yet (service just started), pairs may be empty.

Alternative: On-chain Quote

For a precise quote for a specific input amount, use the on-chain quote() function with an EIP-712 signature. See the Integration Guide.

Response Fields

Top-level

Field	Type	Description
`blockNumber`	integer	Block at which the orderbook was last refreshed
`blockTime`	integer	Unix timestamp (seconds) of that block
`pairs`	array	One entry per configured token/USDC pair

`pairs[].PairOrderbook`

Field	Type	Description
`baseToken`	string	EVM address of the non-USDC token (e.g. WETH)
`quoteToken`	string	EVM address of the USDC token
`bids`	array	Buy-side levels, sorted by descending price
`asks`	array	Sell-side levels, sorted by ascending price

`bids[].OrderbookLevel` / `asks[].OrderbookLevel`

Field	Type	Description
`price`	string	USDC per token, decimal string (e.g. `"3200.50"`)
`amount`	string	Token quantity, decimal string (e.g. `"1.5"`)

Authorizations

X-API-KEY

string

header

required

API key issued by the Kipseli team. Required on every request.

Response

Current orderbook snapshot

blockNumber

integer<int64>

The on-chain block number at which the orderbook was last refreshed. Updates on every new block. Zero if the cache has not been populated yet.

Example:

29500000

blockTime

integer<int64>

Unix timestamp (seconds) of the block identified by blockNumber. Zero if the cache has not been populated yet.

Example:

1741737600

pairs

object[]

Orderbook for each configured token/USDC pair. Empty if the cache has not been populated yet (e.g. service just started).

Show child attributes

Request Swap Verification

​Understanding the Orderbook

​Alternative: On-chain Quote

​Response Fields

​Top-level

​pairs[].PairOrderbook

​bids[].OrderbookLevel / asks[].OrderbookLevel