DevelopersOsai website ↗
API v1
Get started

Amounts & precision

Keep minor-unit money, fixed-point FX rates and instrument-scaled quantities exact.

Currency minor units

Money uses integer minor units or exact integer strings, as defined by the interface. NGN and USD have two decimal places: 100000 minor units is 1,000.00. Read currency exponents instead of assuming every currency has that convention. Avoid floating-point arithmetic and unsafe JavaScript integers.

Quote economics

FIXED_SOURCE fixes total source debit including fees. FIXED_DESTINATION fixes destination proceeds. Read source principal, fee, total debit, total-cost currency, rate direction and scale together. Do not add a fee twice to an all-in amount. Preserve the returned rate_scale when interpreting fixed-point rates.

Exchange scales

Read price_scale, quantity_scale, tick, step and minimums from market capabilities. Order prices and quantities are base-10 integer strings in the instrument scale. Fee amounts retain their own currency and minor-unit scale. Check tick and step divisibility before preparing an order.

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.