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

Headers

Last-Event-ID
string

Id of the last event you got. Browsers send it on reconnect. The stream resumes right after it.

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
since
integer<int64>

Unix time in seconds. Sends swaps since this time first, then live swaps. Must be within the last 15 minutes.

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