Skip to main content
GET
Stream liquidations live

Authorizations

Authorization
string
header
required

Ironflow API key, format if_xxxx. Free keys at https://ironflow.sh/key. Optional on read endpoints.

Query Parameters

market
string

Comma-separated markets to include (BTC-PERP,flx:GAS-PERP). A bare coin (BTC) matches its perp. Up to 50. Omit for every market.

Example:

"BTC-PERP,ETH-PERP"

address
string

Only liquidations of this wallet.

Example:

"0x0000000000000000000000000000000000000001"

min_usd
number

Only liquidations of at least this notional (price × size) in USD.

Required range: x >= 0
Example:

10000

last_event_id
string

Resume after this event id (<timestamp>-<sequence>), for clients that cannot set the Last-Event-ID header. Ids older than 5 minutes are ignored.

Example:

"1718400000000-1"

Response

An open event stream. Each data line is a Liquidation.

The response is of type string.