Skip to content
Alchemy Logo

L4 book snapshots

This API is in private preview. Target October 2026; timing is subject to change.

Alchemy-original read that returns an order-level L4 snapshot for checkpointing an order-status stream.

Coming with HyperCore. This read is documented but is not yet callable.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects the Alchemy-original l4Snapshots read.
includeUsersbooleanNoInclude order owners.
includeTriggerOrdersbooleanNoInclude trigger orders.
{
  "type": "l4Snapshots",
  "includeUsers": true,
  "includeTriggerOrders": true
}

[height, [[coin, {book_orders, untriggered_orders}], ...]]

FieldTypeDescription
[]arraySnapshot pair containing the block height and per-market snapshots.
[0]integerBlock height reflected by the snapshot.
[1]arrayPer-market [coin, snapshot] pairs.
[1][][0]stringMarket identifier.
[1][][1]objectMarket snapshot with book_orders and untriggered_orders keys.
[1][][1].book_ordersarrayTwo arrays: bids at index 0 and asks at index 1.
[1][][1].book_orders[0]arrayBid [address, order] pairs.
[1][][1].book_orders[1]arrayAsk [address, order] pairs.
[1][][1].book_orders[0|1][]array[address, order] pair; orders are not bare objects.
[1][][1].book_orders[0|1][][0]stringAddress associated with the order.
[1][][1].book_orders[0|1][][1]objectOrder object described below.
[1][][1].untriggered_ordersarraySeparate node-provided collection of [address, order] pairs for untriggered orders.

The order object in each [address, order] pair contains the following fields.

FieldTypeDescription
coinstringMarket symbol for the order.
sidestringSide code: A is ask/sell; B is bid/buy.
limitPxstringLimit price for the order.
szstringCurrent resting size of the order.
oidintegerIdentifier assigned to the order.
timestampintegerMilliseconds timestamp when the order was created.
triggerConditionstringHuman-readable trigger condition, not a programmatic enum. Non-trigger orders use the literal "N/A"; use triggerPx for the machine-readable price.
isTriggerbooleanWhether the order is a trigger order.
triggerPxstringMachine-readable trigger price; "0.0" when isTrigger is false.
childrenarrayChild orders associated with the order.
isPositionTpslbooleanWhether the order is a position take-profit or stop-loss order.
reduceOnlybooleanWhether execution can only reduce the position.
orderTypestringDisplay string: Limit, Stop Limit, Stop Market, Market, Take Profit Market, or Take Profit Limit.
origSzstringOriginal order size.
tifstring | nullTime-in-force: Alo, Ioc, Gtc, FrontendMarket, or LiquidationMarket; null when not set.
cloidstring | nullClient-supplied order identifier, when present.

In the sampled market, zero trigger orders appeared in book_orders; the node returns untriggered orders in their own untriggered_orders collection.

Was this page helpful?