Skip to main content
POST
/
sse
/
reserves
Stream real-time pool reserves for multiple assets
curl --request POST \
  --url https://streaming.dexpaprika.com/sse/reserves \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "chain": "ethereum",
    "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
  }
]
'
{
  "chain": "ethereum",
  "pool_id": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  "block": "25236164",
  "tokens": [
    {
      "token_id": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "reserve": "27549935173644",
      "delta": "69057090960",
      "price_usd": 1.000240563722932,
      "reserve_usd": 27556562.688615907,
      "delta_usd": 69073.70359089618
    }
  ],
  "total_reserve_usd": 92394235.39327304,
  "total_delta_usd": 28.042117388933548,
  "timestamp": 1780481297,
  "block_timestamp": 1780481291
}

Query Parameters

​
limit
integer

Maximum event count processing threshold before server-initiated connection teardown.

Required range: x >= 1
​
request_id
integer

Optional correlation ID echoed back on every message of the stream as an SSE request_id: field. Must be a non-negative integer; non-numeric values are rejected with {"message": "invalid query parameters: request_id (must be a number)"}. Defaults to 0 when omitted.

Required range: x >= 0

Body

application/json
Maximum array length: 25
​
chain
string
required
Example:

"ethereum"

​
address
string
required

Pool address (for pool_reserves) or token address (for token_reserves).

Example:

"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

​
method
enum<string>
required

Subscription method for this entry.

Available options:
pool_reserves,
token_reserves

Response

200 - text/event-stream

Multiplexed SSE stream successfully established.

Payload for the pool_reserves event channel. Emitted once per block in which the subscribed pool changed, carrying the full pool snapshot.

​
chain
string

The blockchain network the pool resides on.

Example:

"ethereum"

​
pool_id
string

Address of the pool the change happened in.

Example:

"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

​
block
string

Block number the change was observed in (string-encoded).

Example:

"25236164"

​
tokens
object[]

Per-token reserve state for every token in the pool.

​
total_reserve_usd
number

Total reserve value of the pool in USD.

Example:

92394235.39327304

​
total_delta_usd
number

Net USD reserve change across all tokens this block. Positive means net inflow, negative means net outflow.

Example:

28.042117388933548

​
timestamp
integer

Unix timestamp (seconds) when the event was emitted by the stream.

Example:

1780481297

​
block_timestamp
integer

Unix timestamp (seconds) of the block in which the change was observed.

Example:

1780481291