Skip to main content
GET
Stream real-time swap transactions for a single pool or token

Query Parameters

method
enum<string>
required

Subscription target type — pool for pool-level transactions, token for token-level.

Available options:
pool,
token
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.

Swap transaction event payload. Emitted on the pool or token event channel.

chain
string

Blockchain network identifier.

Example:

"ethereum"

pool_id
string

Pool smart contract address.

Example:

"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

block_number
string

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

Example:

"19000000"

block_timestamp
string<date-time>

Block timestamp in RFC 3339 format.

tx_hash
string

Transaction hash.

Example:

"0xabc123..."

sender
string

Address that initiated the swap.

Example:

"0xd3cda913deb6f0967b991b2d0a373199c2f7c90c"

recipient
string

Address that received the output tokens.

Example:

"0xd3cda913deb6f0967b991b2d0a373199c2f7c90c"

token_0
string

Address of the first token in the pool.

Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

token_1
string

Address of the second token in the pool.

Example:

"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"

amount_0
number

Raw token0 amount from the chain (not decimal-normalised). Negative means tokens left the user's wallet.

Example:

-1000

amount_1
number

Raw token1 amount from the chain (not decimal-normalised). Positive means tokens entered the user's wallet.

Example:

500000000

amount_0_usd
number

USD value of token0 amount (decimal-normalised volume × price). Preserves sign from the underlying volume.

Example:

-1000.5

amount_1_usd
number

USD value of token1 amount (decimal-normalised volume × price). Preserves sign from the underlying volume.

Example:

998.75

price_0_usd
number

USD price per one unit of token0 (after decimal normalisation).

Example:

1.0005

price_1_usd
number

USD price per one unit of token1 (after decimal normalisation).

Example:

1997.5

volume_usd
number

Estimated USD volume of the swap.

Example:

999.625