GET
/convert/:from/:toFX / Crypto Converter
Convert any amount between supported forex and crypto symbols at the current market rate. Returns the converted amount, the rate applied, and the timestamp of the underlying market price so clients can see how fresh the conversion is.
Parameters
ParameterDescription
Parameter
fromrequiredstring · path- The currency or token you're converting from (e.g. USD, EUR, BTC, ETH). Case-insensitive.
torequiredstring · path- The currency or token you want to receive (e.g. GBP, JPY, BTC, ETH). Case-insensitive.
amountnumber · query- How much you want to convert. Defaults to 1 when omitted, useful for fetching just the rate.
Example
request · shell
curl -H "X-API-Key: $KEY" \
"https://api.sifting.io/v1/convert/USD/GBP?amount=100"200OKapplication/json
{ "from": "USD", "to": "GBP", "amount": 100, "rate": 0.78912, "result": 78.912, "t": 1733256123000}Loading runner…
First load onlyReference
Response fieldsDescription
Response fields
- from
- Echo of the source symbol.
- to
- Echo of the target symbol.
- amount
- Amount you sent in.
- rate
- Rate applied. amount × rate = result.
- result
- Your converted amount. Usually the only number you need.
- t
- Timestamp of the underlying market rate, Unix epoch milliseconds.
What it's forDescription
What it's for
- Localised prices
- Show your customers prices in their own currency without maintaining your own FX feed.
- Cross-asset checkout
- Power flows like 'pay $50 worth of USDC' without bolting on a separate pricing service.
- Portfolio dashboards
- Normalise multi-asset holdings to a single display currency.
- Spot quotes
- Quick valuations and rate look-ups inside trading and analytics tools.
- Reference rates
- Anywhere you'd otherwise hardcode a stale exchange rate.
Good to knowDescription
Good to know
- Rates are live
- Each request reads the most recent market price. Identical requests minutes apart can return slightly different numbers, that's the market moving, not us.
- Same asset
- Converting an asset to itself returns the original amount with rate 1. USD to USD always returns rate 1.
- Case-insensitive
- usd, USD, and Usd all resolve identically.
- Mid-market
- Rates are the mid-market price from our live feed. No fees, no spreads, no slippage, useful for display and reference, not for executing trades.
Error responses
StatusCodeMeaning
- 404
pair_not_foundAt least one of the symbols isn't in our live feed. Double-check spelling, or pick a more common quote currency (USD, USDC, EUR).
{ "error": "pair_not_found", "message": "No live rate available for this pair."}