Skip to main content
GET
Stream real-time reserve updates for a single pool or token

Query Parameters

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
address
string
required

Target pool or token smart contract address.

chain
string
required

Target blockchain network identifier (e.g., ethereum, solana).

request_id
integer

Optional identifier for tracking the request in the SSE stream.

Required range: 0 <= x <= 4294967295
limit
integer

Maximum event count before server-initiated connection teardown.

Required range: x >= 1

Response

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