Skip to main content
POST
Stream real-time reserve updates for multiple pools or tokens

Query Parameters

limit
integer

Maximum event count before server-initiated connection teardown.

Required range: x >= 1

Body

application/json
Maximum array length: 25
chain
string
required

Target blockchain network identifier.

Example:

"ethereum"

address
string
required

Pool or token smart contract address.

Example:

"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

method
enum<string>
required

Subscription target type — pool_reserves for pool-level data, token_reserves for token-level aggregated data.

Available options:
pool_reserves,
token_reserves
request_id
integer

Optional identifier for tracking multiplexed requests. Defaults to the array index if omitted.

Required range: 0 <= x <= 4294967295

Response

Multiplexed SSE stream successfully established.

Per-block reserve update for a pool. Emitted on the pool_reserves event channel.

chain
string

Blockchain network identifier.

Example:

"ethereum"

pool_id
string

Pool smart contract address.

Example:

"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

block
string

Block number in which the reserve update was confirmed (string-encoded integer).

Example:

"19000000"

previous_block
string

Previous block number for this pool (string-encoded integer). Omitted if unavailable.

Example:

"18999999"

tokens
object[]

Per-token reserve statistics for this pool.

total_reserve_usd
number

Total USD value of all reserves in the pool.

Example:

2000000.75

total_delta_usd
number

Total USD change across all reserves. Negative values indicate a net decrease.

Example:

-1000.5

timestamp
integer

Server ingestion timestamp (Unix epoch seconds).

Example:

1715162400

block_timestamp
integer

On-chain block timestamp (Unix epoch seconds).

Example:

1715162388