Rates
Market Data · Public
Real-time conversion rates across every supported pair.
The Rates API surfaces the live cross-currency conversion rates CoinPayments uses internally. Quote any pair, batch multiple lookups in one call, and (optionally) pin pricing to a moment in time for reproducible audits.
What this API does
No auth requiredCross-currency rates
Convert between any combination of supported coins, tokens, or fiat with a single request.
Learn more
Point-in-time pricing
Pin a quote to a specific timestamp to reproduce historical conversion values for reconciliation or reporting.
Learn more
Token-aware pairs
Quote ERC-20 / BEP-20 / SPL tokens using the canonical coinId:contractAddress format — no separate lookup table.
Learn more
How it works
One call, many pairsRequest shape
Send a GET to /api/v2/rates with comma-separated lists of source and target currency ids. Optionally include pointInTime for historical lookups.
- from1,4,4:0xdac17f958d2ee523a2206206994597c13d831ec7
- to2,3
- pointInTime2025-03-01T02:30:00Z
The response returns one entry per cross-pair, each containing the base and quote currency ids, symbols, and a conversion rate.
Use string math for amounts
Rates are returned as strings to preserve the precision crypto requires. Convert with a decimal/BigNumber library — never with native floating-point arithmetic, especially when computing invoice totals.
Where to next?
Pick the most useful next step.