DevelopersOsai website ↗
API v1
Exchange / API reference

Read Own Order

Request and response reference for GET /v1/exchange/markets/{market}/orders/{order}.

GET/v1/exchange/markets/{market}/orders/{order}
Authentication: Console sessionPermission: exchange.read
Use the base URL and access configuration provided to your institution. Examples are request templates, not transaction results. Field tables focus on client fields; preserve additional metadata returned by the configured service.

Request

This interface uses an approved institutional session, not a financial API key. Session writes also need Origin and CSRF protection. Use the JavaScript sample within an authorized browser integration.

Request templatecURL
curl -X GET "$OSAI_CONSOLE_BASE_URL/v1/exchange/markets/$MARKET_ID/orders/$ORDER_ID?account_id=$ACCOUNT_ID" \
  -H "Origin: $OSAI_APP_ORIGIN" \
  --cookie "$OSAI_SESSION_COOKIE_FILE"

Parameters

NameLocationRequirementDescription
marketpath · stringRequiredUse the value defined for this resource.
orderpath · stringRequiredUse the value defined for this resource.
account_idquery · stringRequiredUse the value defined for this resource.

Request body

This operation does not define a JSON request body.

Responses

Inspect HTTP status before parsing a body. These tables describe client response fields rather than invented successful transaction payloads.

200 · HTTP 200 response
FieldTypeDescription & constraints
orderRequired in parent objectobjectDefined by the resource contract.
order.order_idRequired in parent objectstringDefined by the resource contract.
order.instructionRequired in parent objectobjectDefined by the resource contract.
order.instruction.institution_idRequired in parent objectstringDefined by the resource contract.
order.instruction.account_idRequired in parent objectstringDefined by the resource contract.
order.instruction.actor_idRequired in parent objectstringDefined by the resource contract.
order.instruction.client_order_idRequired in parent objectstringDefined by the resource contract.
order.instruction.sideRequired in parent objectstringDefined by the resource contract.
order.instruction.typeRequired in parent objectstringDefined by the resource contract.
order.instruction.time_in_forceRequired in parent objectstringDefined by the resource contract.
order.instruction.quantityRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.instruction.limit_priceRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.instruction.protection_priceRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.terms_hashRequired in parent objectstringDefined by the resource contract.
order.acceptance_sequenceRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.versionRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.accepted_atRequired in parent objectstringdate-timeDefined by the resource contract.
order.remaining_quantityRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.filled_quantityRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.statusRequired in parent objectstringDefined by the resource contract.
order.fee_snapshotRequired in parent objectobjectDefined by the resource contract.
order.fee_snapshot.schedule_idRequired in parent objectstringDefined by the resource contract.
order.fee_snapshot.versionRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.effective_fromRequired in parent objectstringdate-timeDefined by the resource contract.
order.fee_snapshot.effective_untilRequired in parent objectstringdate-timeDefined by the resource contract.
order.fee_snapshot.makerRequired in parent objectobjectDefined by the resource contract.
order.fee_snapshot.maker.currencyRequired in parent objectstringDefined by the resource contract.
order.fee_snapshot.maker.minor_scaleRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.maker.numeratorRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.maker.denominatorRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.maker.roundingRequired in parent objectstringDefined by the resource contract.Values: FLOOR, CEILING
order.fee_snapshot.takerRequired in parent objectobjectDefined by the resource contract.
order.fee_snapshot.taker.currencyRequired in parent objectstringDefined by the resource contract.
order.fee_snapshot.taker.minor_scaleRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.taker.numeratorRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.taker.denominatorRequired in parent objectstringExact nonnegative base-10 integer; never a JSON number.Pattern: ^(0|[1-9][0-9]*)$
order.fee_snapshot.taker.roundingRequired in parent objectstringDefined by the resource contract.Values: FLOOR, CEILING
400 · Invalid bounded instruction

No client body fields are defined for this response.

401 · Authentication required

No client body fields are defined for this response.

403 · Permission, recent verified MFA or CSRF denied

No client body fields are defined for this response.

409 · Version, preview, instruction or capacity conflict

No client body fields are defined for this response.

503 · Unavailable or unknown commit outcome; query the original command before retrying

No client body fields are defined for this response.

Retries & recovery

Keep the original request identifiers and any required idempotency key. A timeout does not establish failure. Read the original resource or command before another financial write; use expected versions for concurrent changes.

16 suggested pages

Get startedIntroductionIntegrate institutional FX and stablecoin trading with quotes, orders, market data, account records and settlement reporting.Get startedQuickstartMake an authenticated read, request a quote and follow an instruction without losing its original references.Get startedAuthenticationUse the correct authentication scheme for API credentials, Console sessions and market-data feeds.Get startedErrorsDistinguish invalid inputs, denied access, conflicts, rate limits and uncertain outcomes.Get startedRate limitsUse response headers, bounded concurrency and backoff rather than repeated bursts.Get startedAmounts & precisionKeep minor-unit money, fixed-point FX rates and instrument-scaled quantities exact.Get startedPagination & recoveryUse each resource’s pagination model and preserve stable recovery checkpoints.Financial workflowsQuotes & acceptanceRequest explicit FX economics, review conditions and retain accepted terms.Financial workflowsTrade lifecycleTrack funding, execution and settlement as distinct business transitions.Financial workflowsBalances & transactionsRead institutional financial positions and reconcile movements by currency.Financial workflowsBeneficiariesRegister beneficiaries and coordinate their institutional approval lifecycle.Financial workflowsCredential managementCreate, inspect, rotate and revoke application credentials without exposing secrets.Events & reliabilityIdempotencyPrevent duplicate financial effects across retries and uncertain outcomes.Events & reliabilityWebhooks & verificationVerify deliveries, persist original events and make downstream processing idempotent.Events & reliabilityEvent payloadsUnderstand the customer event envelope and business transitions behind subscriptions.Events & reliabilityDelivery retries & replayRepair webhook delivery without creating a second business event.