Skip to main content
Every side of a transaction specifies an asset (what kind of money) and a network (how it moves). The same field structure works for both crypto and fiat.

Asset and network format

{
  "asset": "usdc",
  "network": "polygon"
}
All values are lowercase. The supported combinations are documented in the tables on this page.

Crypto assets and networks

AssetNetworkDescription
usdcpolygonUSDC on Polygon Chain, the primary settlement asset
usdcethereumUSDC on Ethereum mainnet
usdcsolanaUSDC on Solana
btcbitcoinBitcoin
ethethereumEther
Polygon Chain is the recommended network for most use cases: sub-2-second finality, $0.002 average transaction cost, and native USDC (no bridging or wrapping).

Fiat rails

AssetNetworkDescription
usdachUS dollars via ACH bank transfer
usdwireUS dollars via domestic wire
usdcardUS dollars via debit card (coming soon)
usdcashUS dollars via physical cash (GreenDot / AllPoint network)
eursepaEuros via SEPA Instant
brlpixBrazilian reais via PIX
inrupiIndian rupees via UPI
mxnspeiMexican pesos via SPEI
gbpfpsBritish pounds via Faster Payments
Supported corridors and rails expand regularly. The tables on this page are the authoritative list.

Exchange rates and FX

When a transaction crosses currencies (e.g., USD to USDC, or USDC to EUR), OMS applies a live exchange rate at quote time. The quote response includes:
  • rates.exchangeRate: the spot rate used
  • rates.effectiveRate: the post-fee rate the customer actually receives
  • expiresAt: when the locked rate expires
OMS sources liquidity from multiple venues and routes to minimize spread. The fee breakdown shows OMS fees, developer fees, and gas costs separately.

Cash networks

Cash off-ramps use OMS’s partnership with physical cash networks:
  • GreenDot: US cash deposits and withdrawals at 90,000+ retail locations (CVS, Walgreens, Walmart)
  • OXXO / 7-Eleven / Walmart MX: Cash pickup in Mexico
  • AllPoint ATM: Cash withdrawals at 55,000 ATMs
Cash on-ramps generate a deposit code the customer presents at a retail location. OMS monitors for the deposit and auto-creates a fiatToCrypto transaction when cash is received. See Cash-in guide for the full flow.