DevelopersOsai website ↗
API v1
Financial workflows

Quotes & acceptance

Request explicit FX economics, review conditions and retain accepted terms.

Choose what to fix

POST /v1/quotes accepts base_currency and quote_currency with one supported amount mode. FIXED_SOURCE uses base_amount_minor as the all-in source debit. FIXED_DESTINATION uses destination_amount_minor as target proceeds. Do not send competing amount intentions.

Fixed-source requestbash
curl -X POST "$OSAI_API_BASE_URL/v1/quotes" \
  -H "Authorization: ApiKey $OSAI_PUBLIC_ID:$OSAI_API_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quote-order-1042" \
  -d '{"quote_mode":"FIXED_SOURCE","base_amount_minor":100000,"base_currency":"NGN","quote_currency":"USD","customer_reference":"order-1042"}'

Review the quote

  • Check the quote ID, currencies, source principal and destination proceeds.
  • Read fee, total debit, fee schedule and funding constraints.
  • Respect expires_at and request new terms after expiry.
  • An indicative price is not acceptance authority for a quote.

Accept and retain the trade reference

POST /v1/quotes/{quote_id}/accept takes quote_id and a beneficiary where the route requires it. Use a distinct stable Idempotency-Key for acceptance and retain trade_id with the exact accepted terms.

Accept a quotebash
curl -X POST "$OSAI_API_BASE_URL/v1/quotes/$QUOTE_ID/accept" \
  -H "Authorization: ApiKey $OSAI_PUBLIC_ID:$OSAI_API_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: accept-order-1042" \
  -d "{\"quote_id\":\"$QUOTE_ID\",\"beneficiary_id\":\"$BENEFICIARY_ID\"}"

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.