Skip to main content
GET
cURL

Path parameters

string
required
Base58 Solana vault public key.

Query parameters

string
Past or present ISO 8601 timestamp with an explicit timezone and up to three fractional-second digits. Omit for current state.
boolean
default:"false"
Include orders cancelled by the requested timestamp. Expiry and remaining-amount filters still apply.
URL-encode + in timezone offsets, or use UTC (Z).

Example request

cURL

Snapshot behavior

  • Posting and fill events at or before at are included.
  • Orders created after at are excluded.
  • Fills during posting and subsequent maker fills are applied according to the order type.
  • Orders expiring at or before at are excluded.
  • Cancelled orders are excluded unless includeRemoved=true. Their returned balance is the unfilled amount before cancellation, not funds still available to trade.
  • Fully filled orders and balances at or below the indexed orderbook threshold are excluded. The fallback threshold is 500 raw units if no initialization record is available at the timestamp.
  • Historical requests include orderbooks inactive today. Current requests retain the existing active-orderbook filter.
  • Future fills and cancellations do not affect historical balances or cancellation metadata.

Points integrations

Attribute orders using user_address, convert price_implied_apy to APY percent, and compare it with your market APY reference at the same timestamp. Apply your eligibility window before aggregating eligible balances by user. For server-calculated APY range checks and separate unclaimed filled SY/YT balances, use the orderbook in-range snapshot. This endpoint does not supply historical market APY, time-weighted balances, SY conversion, or points eligibility. Unclaimed proceeds from filled orders require separate treatment. Use the default includeRemoved=false for resting-order eligibility.
Historical responses reflect the data available at request time. Late-arriving data or corrections can change earlier results.