Skip to main content
Version: testnet (v0.73)


An order in Vega, if active it will be on the order book for the market

type Order {
id: ID!
price: String!
timeInForce: OrderTimeInForce!
side: Side!
market: Market!
size: String!
remaining: String!
party: Party!
createdAt: Timestamp!
expiresAt: Timestamp
status: OrderStatus!
reference: String!
dateRange: DateRange
pagination: Pagination
): TradeConnection
type: OrderType
rejectionReason: OrderRejectionReason
version: String!
updatedAt: Timestamp
peggedOrder: PeggedOrder
liquidityProvision: LiquidityProvision
postOnly: Boolean
reduceOnly: Boolean
icebergOrder: IcebergOrder

Fields ● ID! non-null scalar

Hash of the order data

Order.price ● String! non-null scalar

The worst price the order will trade at (e.g. buy for price or less, sell for price or more) (uint64)

Order.timeInForce ● OrderTimeInForce! non-null enum

The timeInForce of order (determines how and if it executes, and whether it persists on the book)

Order.side ● Side! non-null enum

Whether the order is to buy or sell ● Market! non-null object

The market the order is trading on (probably stored internally as a hash of the market details)

Order.size ● String! non-null scalar

Total number of units that may be bought or sold (immutable) (uint64)

Order.remaining ● String! non-null scalar

Number of units remaining of the total that have not yet been bought or sold (uint64) ● Party! non-null object

The party that placed the order (probably stored internally as the party's public key)

Order.createdAt ● Timestamp! non-null scalar

RFC3339Nano formatted date and time for when the order was created (timestamp)

Order.expiresAt ● Timestamp scalar

RFC3339Nano expiration time of this order

Order.status ● OrderStatus! non-null enum

The status of an order, for example 'Active'

Order.reference ● String! non-null scalar

The external reference (if available) for the order

Order.tradesConnection ● TradeConnection object

Trades relating to this order

Order.tradesConnection.dateRange ● DateRange input

Date range to retrieve trades from/to. Start and end time should be expressed as an integer value Unix nanoseconds

Order.tradesConnection.pagination ● Pagination input

Order.type ● OrderType enum

The order type

Order.rejectionReason ● OrderRejectionReason enum

Why the order was rejected

Order.version ● String! non-null scalar

Version of this order, counts the number of amends

Order.updatedAt ● Timestamp scalar

RFC3339Nano time the order was altered

Order.peggedOrder ● PeggedOrder object

PeggedOrder contains the details about a pegged order

Order.liquidityProvision ● LiquidityProvision object

The liquidity provision this order was created from

Order.postOnly ● Boolean scalar

Is this a post only order

Order.reduceOnly ● Boolean scalar

Is this a reduce only order

Order.icebergOrder ● IcebergOrder object

Details of an iceberg order

Returned by

orderByID query ● orderByReference query

Member of

Entities object ● LiquidityOrderReference object ● OrderEdge object ● StopOrder object