Skip to main content
GET
Get bulk order status

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

account
string
required

User account address (user query alias is also accepted)

market
string
required

Concrete market address. Spot and perp markets with the same base asset have different addresses.

sequence_number
integer<int64>
required

Sequence number of the bulk order

Required range: x >= 0
asset_type
enum<string>

Asset type discriminator. Defaults to "perp" when omitted so the endpoint preserves prior behaviour for perp callers; pass "spot" to query the spot tables instead. (Bulk-order status is keyed by (account, market, sequence_number) — those keys are independent across products, so a single call cannot meaningfully UNION both.) Discriminator carried on DTOs that can mix perp and spot rows (markets, orders, trades, bulk orders, bulk order fills, and WebSocket payloads). Also accepted as a query parameter on REST endpoints that can filter to one product.

Wire format is lowercase ("perp" / "spot") and accepted case-insensitively on the request side via [impl_case_insensitive_deserialize].

Available options:
perp,
spot

Response

200 - application/json

Bulk order status retrieved successfully

bulk_order
object
required
details
string
required
status
string
required