DevelopersOsai website ↗
API v1
API reference

Integrate trading and financial operations.

Find authentication, request fields and response definitions for quotes, orders, market data, accounts and settlement records.

Customer financial APIs use API keys. Console and exchange workflows use approved institutional sessions. Market-data feeds use scoped bearer credentials. Access and enabled workflows are configured for your institution.

Accounts

GETHealth check/v1/healthGETGet institution balances/v1/balancesGETList institution transactions/v1/transactions

Route status

GETGet entitled customer facing route availability and capabilities/v1/providers/status

Beneficiaries

POSTRegister an institution beneficiary for review/v1/beneficiaries

Webhooks

POSTConfigure the institution's signed customer webhook endpoint/v1/webhook-endpointsPOSTQueue another delivery attempt for an existing customer event/v1/webhook-deliveries/{event_id}/replay

Credentials

POSTCreate an environment scoped API credential/v1/credentialsGETList institution credential metadata/v1/credentialsGETGet institution credential metadata/v1/credentials/{public_id}DELETERevoke an institution credential/v1/credentials/{public_id}POSTRotate an active institution credential/v1/credentials/{public_id}/rotate

Quotes

POSTCreate a quote/v1/quotesGETGet quote by ID/v1/quotes/{quote_id}POSTAccept a quote/v1/quotes/{quote_id}/accept

Trades

GETList institution trades/v1/tradesGETGet trade by ID/v1/trades/{trade_id}

Settlement reports

GETGet settlement by ID/v1/settlements/{settlement_id}GETList terminal settlement outcomes for the institution/v1/reports/settlements

Company access

POSTStart Login/api/auth/startPOSTStart Step Up/api/auth/step-upGETRead Session/api/auth/sessionPOSTRevoke Session/api/auth/logoutGETOne time state and browser bound OIDC callback/api/auth/callbackGETList Members/v1/console/membersGETList Roles/v1/console/rolesPOSTChange Membership/v1/console/members/changeGETRead Audit/v1/console/auditPOSTCreate Invitation/v1/console/invitationsGETList Invitations/v1/console/invitationsGETRead Invitation/v1/console/invitations/{invitation}POSTCancel Invitation/v1/console/invitations/{invitation}/cancelGETResolve Company Workspace/api/auth/company/{slug}POSTStart Company Login/api/auth/company/{slug}/startPOSTExplicitly replace an invitation token and queue a new delivery generation/v1/console/invitations/{invitation}/reissuePOSTSubmit Access Application/v1/access-applicationsPOSTVerify Application Email/v1/access-applications/verify-email

Console operations

GETRead Console Balances/v1/console/operations/balancesGETRead Console Transactions/v1/console/operations/transactionsGETRead Console Settlements/v1/console/operations/settlementsGETRead Console Credentials/v1/console/operations/credentialsGETRead Console Webhook/v1/console/operations/webhookGETRead Console Events/v1/console/operations/webhook-eventsGETRead Console Attempts/v1/console/operations/webhook-attemptsGETRead Console Daily Close/v1/console/operations/daily-closePOSTCredentialrevocations Console/v1/console/operations/credential-revocationsPOSTWebhookreplays Console/v1/console/operations/webhook-replaysPOSTApply Console Reconciliation Case/v1/console/operations/reconciliation-casesGETList Internal Statements/v1/console/operations/statementsPOSTCapture Internal Statement/v1/console/operations/statementsGETGet Internal Statement/v1/console/operations/statements/{statement}POSTRecord Console Daily Close/v1/console/operations/daily-close-runsGETRead Console Recovery Queue/v1/console/operations/recovery-queueGETRead Console Recovery History/v1/console/operations/recovery-queue/{settlement_id}/eventsGETRead Console Beneficiaries/v1/console/operations/beneficiariesGETRead Console Routing/v1/console/operations/routingGETRead Console RFQs/v1/console/operations/rfqsGETRead Console Legacy Trades/v1/console/operations/rfq-tradesPOSTConsole Beneficiary Proposals/v1/console/operations/beneficiary-proposalsPOSTConsole Beneficiary Approvals/v1/console/operations/beneficiary-approvalsPOSTConsole Beneficiary Rejections/v1/console/operations/beneficiary-rejectionsPOSTConsole Beneficiary Disables/v1/console/operations/beneficiary-disablesPOSTConsole Route Pause Proposals/v1/console/operations/route-pause-proposalsPOSTConsole Route Pause Approvals/v1/console/operations/route-pause-approvalsPOSTConsole Route Pause Rejections/v1/console/operations/route-pause-rejectionsPOSTConsole Incident Opens/v1/console/operations/incident-opensPOSTConsole Incident Acknowledgements/v1/console/operations/incident-acknowledgementsPOSTConsole Incident Closes/v1/console/operations/incident-closesPOSTConsole Rfq Requests/v1/console/operations/rfq-requestsPOSTConsole Rfq Acceptance Proposals/v1/console/operations/rfq-acceptance-proposalsPOSTConsole Rfq Acceptance Approvals/v1/console/operations/rfq-acceptance-approvalsPOSTConsole Rfq Acceptance Rejections/v1/console/operations/rfq-acceptance-rejectionsPOSTConsole Rfq Acceptance Cancellations/v1/console/operations/rfq-acceptance-cancellationsPOSTConsole Rfq Reauthorizations/v1/console/operations/rfq-reauthorizationsPOSTConsole Rfq Dispatches/v1/console/operations/rfq-dispatches

Exchange

GETList Markets/v1/exchange/marketsGETRead Book/v1/exchange/markets/{market}/bookGETGet markets matches/v1/exchange/markets/{market}/matchesGETRead Own Order/v1/exchange/markets/{market}/orders/{order}GETRead Own Order History/v1/exchange/markets/{market}/ordersPOSTDirect submission disabled: create an approval request from a frozen preview/v1/exchange/markets/{market}/ordersGETRead Own Fills/v1/exchange/markets/{market}/orders/{order}/fillsGETResolve Original Command/v1/exchange/commands/{command}POSTPreview Order/v1/exchange/markets/{market}/orders/previewPOSTPreview Replacement/v1/exchange/markets/{market}/orders/{order}/replace/previewPOSTDirect submission disabled: create an approval request from a frozen preview/v1/exchange/markets/{market}/orders/{order}/replacePOSTCancel Order/v1/exchange/markets/{market}/orders/{order}/cancelPOSTCreate Approval/v1/exchange/approval-requestsGETList Approvals/v1/exchange/approval-requestsGETRead Approval/v1/exchange/approval-requests/{request}POSTApprove Request/v1/exchange/approval-requests/{request}/approvePOSTReject Request/v1/exchange/approval-requests/{request}/rejectPOSTCancel Approval/v1/exchange/approval-requests/{request}/cancelGETGet Capabilities/v1/exchange/markets/{market}/capabilitiesGETRead only command atomic recovery from the snapshot sequence. Pin subsequent pages with as of sequence. Check market version and each from sequence before applying. A 409 EXCHANGE BOOK RESYNC REQUIRED requires a fresh book snapshot; disconnects never imply source freshness./v1/exchange/markets/{market}/book/deltasGETGet Exchange Eligibility/v1/exchange/markets/{market}/eligibilityGETRead classified book top. Empty markets have null prices; source age is never a heartbeat./v1/exchange/markets/{market}/tickerGETRead private per fill settlement lineage. Financial dispatch remains blocked./v1/exchange/markets/{market}/orders/{order}/settlement-workGETRead Funding Intent/v1/exchange/commands/{command}/funding

Market data

GETDiscover scoped candle series and read semantics, not executable instruments/v1/exchange/candle-seriesGETGet exchange candles/v1/exchange/candlesGETGet exchange source health/v1/exchange/source-health

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.