General

Convert an amount across asset types (currency or crypto)

GET/api/general/convert

Converts between any two assets regardless of type. Each side's asset type is given by `from_asset_type`/`to_asset_type` (`currency` or `crypto`), so fiat<->crypto pairs are supported.

Query parameters

from_symbolstringrequired
Currency or crypto symbol
from_asset_typestringrequired
Asset type of the symbol
to_symbolstringrequired
Currency or crypto symbol
to_asset_typestringrequired
Asset type of the symbol
amountnumberrequired
Amount to convert. Must be a positive number up to 1e15.
precisionintegeroptional
Decimal places to round the result to

Response

fromstring
tostring
amountnumber
ratenumber
resultnumber
updatedstring<date-time>

Errors

400VALIDATION_ERROR
Invalid query parameters.
401UNAUTHORIZED
Missing or invalid API key.
404UNKNOWN_ASSET
Unknown currency or crypto.
429USAGE_LIMIT_EXCEEDED
Too many requests: per-key or per-IP burst rate limit exceeded (RATE_LIMIT_EXCEEDED) or monthly request quota reached (USAGE_LIMIT_EXCEEDED).
500INTERNAL_ERROR
Unexpected server error.
502UPSTREAM_ERROR
Exchange-rate provider failure.