DevelopersOsai website ↗
API v1
Console operations / API reference

Read Console Legacy Trades

Request and response reference for GET /v1/console/operations/rfq-trades.

GET/v1/console/operations/rfq-trades
Authentication: Console sessionPermission: rfq.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/console/operations/rfq-trades" \
  -H "Origin: $OSAI_APP_ORIGIN" \
  --cookie "$OSAI_SESSION_COOKIE_FILE"

Parameters

NameLocationRequirementDescription
trade_idquery · stringOptionalUse the value defined for this resource.
pagequery · integerOptionalUse the value defined for this resource.
page_sizequery · integerOptionalUse 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 · Institution-scoped owner evidence; no external finality inferred
FieldTypeDescription & constraints
institution_idRequired in parent objectstringDefined by the resource contract.
observed_atRequired in parent objectstringDefined by the resource contract.
sourceRequired in parent objectstringDefined by the resource contract.
itemsRequired in parent objectarrayDefined by the resource contract.
items[].trade_idRequired in parent objectstringDefined by the resource contract.
items[].institution_idRequired in parent objectstringDefined by the resource contract.
items[].quote_idRequired in parent objectstringDefined by the resource contract.
items[].statusRequired in parent objectstringDefined by the resource contract.
items[].base_amount_minorRequired in parent objectstringDefined by the resource contract.
items[].base_currencyRequired in parent objectstringDefined by the resource contract.
items[].quote_currencyRequired in parent objectstringDefined by the resource contract.
items[].correlation_idRequired in parent objectstringDefined by the resource contract.
items[].settlement_idRequired in parent objectstringDefined by the resource contract.
items[].beneficiary_idRequired in parent objectstringDefined by the resource contract.
items[].settlement_provider_idRequired in parent objectstringDefined by the resource contract.
items[].customer_referenceRequired in parent objectstringDefined by the resource contract.
items[].fx_execution_idRequired in parent objectstringDefined by the resource contract.
items[].fx_executor_idRequired in parent objectstringDefined by the resource contract.
items[].fx_execution_referenceRequired in parent objectstringDefined by the resource contract.
items[].fx_execution_statusRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshotRequired in parent objectobject | nullDefined by the resource contract.
items[].pricing_snapshot.quote_modeRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.requested_amount_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.source_principal_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.fee_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.total_debit_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.destination_amount_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.destination_target_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.destination_surplus_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.source_currencyRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.destination_currencyRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.rate_scaledRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.rate_directionRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.rate_scaleRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.fee_schedule_idRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.fee_schedule_versionRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.source_minor_exponentRequired in parent objectintegerDefined by the resource contract.
items[].pricing_snapshot.destination_minor_exponentRequired in parent objectintegerDefined by the resource contract.
items[].pricing_snapshot.fixed_fee_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.fee_basis_pointsRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.minimum_fee_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.maximum_fee_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.minimum_source_principal_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.maximum_source_principal_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.minimum_total_debit_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.maximum_total_debit_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.minimum_destination_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.maximum_destination_minorRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.expires_atRequired in parent objectstringDefined by the resource contract.
items[].pricing_snapshot.snapshot_hashRequired in parent objectstringDefined by the resource contract.
pageRequired in parent objectintegerDefined by the resource contract.
page_sizeRequired in parent objectintegerDefined by the resource contract.
totalRequired in parent objectintegerDefined by the resource contract.
source_as_ofRequired in parent objectstring | nullDefined by the resource contract.
external_finalityRequired in parent objectboolean | nullDefined by the resource contract.
400 · Invalid query

No client body fields are defined for this response.

401 · Session required

No client body fields are defined for this response.

403 · Permission denied

No client body fields are defined for this response.

503 · Owner unavailable; no scenario fallback

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.