Get live orderbook

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

import requests

url = "https://propamm.kipseli.win/v2/price"

headers = {"X-API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://propamm.kipseli.win/v2/price', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://propamm.kipseli.win/v2/price",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://propamm.kipseli.win/v2/price"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://propamm.kipseli.win/v2/price")
  .header("X-API-KEY", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://propamm.kipseli.win/v2/price")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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>'

import requests

url = "https://propamm.kipseli.win/v2/price"

headers = {"X-API-KEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://propamm.kipseli.win/v2/price', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://propamm.kipseli.win/v2/price",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://propamm.kipseli.win/v2/price"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://propamm.kipseli.win/v2/price")
  .header("X-API-KEY", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://propamm.kipseli.win/v2/price")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

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