Price Conversion v2

Convert an amount of one cryptocurrency or fiat currency into one or more different currencies utilizing the latest market rate for each currency. You may optionally pass a historical timestamp as `time` to convert values based on historical rates (as your API plan supports). Please note: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found here. Technical Notes - Latest market rate conversions are accurate to 1 minute of specificity. Historical conversions are accurate to 1 minute of specificity outside of non-USD fiat conversions which have 5 minute specificity. - You may reference a current list of all supported cryptocurrencies via the cryptocurrency/map endpoint. This endpoint also returns the supported date ranges for historical conversions via the `first_historical_data` and `last_historical_data` properties. - Conversions are supported in 93 different fiat currencies and 4 precious metals as outlined here. Historical fiat conversions are supported as far back as 2013-04-28. - A `last_updated` timestamp is included for both your source currency and each conversion currency. This is the timestamp of the closest market rate record referenced for each currency during the conversion. This endpoint is available on the following API plans: - Basic (Latest market price conversions) - Hobbyist (Latest market price conversions + 1 month historical) - Startup (Latest market price conversions + 1 month historical) - Standard (Latest market price conversions + 3 months historical) - Professional (Latest market price conversions + 12 months historical) - Enterprise (Latest market price conversions + up to 6 years historical) Cache / Update frequency: Every 60 seconds for the lastest cryptocurrency and fiat currency rates. Plan credit use: 1 call credit per call and 1 call credit per `convert` option beyond the first. CMC equivalent pages: Our cryptocurrency conversion page at [coinmarketcap.com/converter/](https://coinmarketcap.com/converter/).

byCoinMarketCap Cryptocurrency API

7000+calls

N/Alatency

Updated: Oct 27, 2026, 12:40 AM

Continue setup in your AI

Only public catalog IDs and a safe return path are handed to the Plugins page. This does not run the tool or confirm current availability, authorization, price, limits, or upstream status; those conditions are checked again before execution.

Selected tool: coinmarketcap.tools.priceconversion.retrieve.v2.24e991d9
Provider scope: CoinMarketCap Cryptocurrency API
Catalog updated: 2026-10-27T00:40:01.989419+00:00
Business task: Crypto Asset Master

Continue setupYou can return to this tool page if the selection is incomplete or expires.

Run on this page: Execute is the in-site test path. Continue setup is for adding the public selection to an external AI; the two paths are tracked and validated separately.

Discover -> Inspect -> Call

Call setup

Tool IDcoinmarketcap.tools.priceconversion.retrieve.v2.24e991d9

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

amountnumberRequired

An amount of currency to convert. Example: 10.43

idstringOptional

The CoinMarketCap currency ID of the base cryptocurrency or fiat to convert from. Example: "1"

symbolstringOptional

Alternatively the currency symbol of the base cryptocurrency or fiat to convert from. Example: "BTC". One "id" *or* "symbol" is required. Please note that starting in the v2 endpoint, due to the fact that a symbol is not unique, if you request by symbol each quote response will contain an array of objects containing all of the coins that use each requested symbol. The v1 endpoint will still return a single object, the highest ranked coin using that symbol.

timestringOptional

Optional timestamp (Unix or ISO 8601) to reference historical pricing during conversion. If not passed, the current time will be used. If passed, we'll reference the closest historic values available for this conversion.

convertstringOptional

Pass up to 120 comma-separated fiat or cryptocurrency symbols to convert the source amount to.

convert_idstringOptional

Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to `convert` outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when `convert` is used.

Price Conversion v2

7000+calls

N/Alatency

Updated: Oct 27, 2026, 12:40 AM

Continue setup in your AI

Selected tool

coinmarketcap.tools.priceconversion.retrieve.v2.24e991d9

Provider scope

CoinMarketCap Cryptocurrency API

Catalog updated

2026-10-27T00:40:01.989419+00:00

Business task

Crypto Asset Master

Continue setupYou can return to this tool page if the selection is incomplete or expires.