Docs/Skills/Currency Symbol Skill

Currency Symbol Skill

Get currency symbols

OperationalCredits 1 per callp50 113msFinance

Overview

A currency code API built on the ISO 4217 list. Look up a currency code such as EUR to get every country that uses it, or a country to get its currency. Countries can be a name (Canada), a two- or three-letter ISO code (CA or CAN) or a common alternative spelling, and are matched against ISO 4217's own country names, so KR finds Korea (the Republic of). The Free plan returns the country names and ISO codes. Paid plans add the symbol, the currency's full name, its numeric code, its minor units (the decimal places to show) and its live value: units per US dollar, the dollar value of one unit and the percent change since yesterday's close, refreshed every few minutes. To convert amounts, use Currency Converter.

Live Test Currency Symbol Skill Skill →

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as CurrencySymbolSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call
{
  "name": "CurrencySymbolSkill",
  "arguments": {
    "currency": "USD"
  }
}

You do not name the tool yourself; the model picks it. Asking about USD in the terms this skill covers is enough for it to reach for CurrencySymbolSkill on its own — naming it explicitly also works, and is the way to force the call.

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

ArgumentTypeDescription
currencyRequiredstringThe currency code for which you want to get the symbol

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "countriesFound": [
      {
        "country_name": "AMERICAN SAMOA",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "BONAIRE, SINT EUSTATIUS AND SABA",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "BRITISH INDIAN OCEAN TERRITORY (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "ECUADOR",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "EL SALVADOR",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "GUAM",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "HAITI",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "MARSHALL ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "MICRONESIA (FEDERATED STATES OF)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "NORTHERN MARIANA ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "PALAU",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "PANAMA",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "PUERTO RICO",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "TIMOR-LESTE",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "TURKS AND CAICOS ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "UNITED STATES MINOR OUTLYING ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "UNITED STATES OF AMERICA (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "VIRGIN ISLANDS (BRITISH)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "VIRGIN ISLANDS (U.S.)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      }
    ],
    "ratesUpdated": "2026-10-27T17:41:09.810Z",
    "currency": "USD"
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

FieldTypeExampleDescription
countriesFoundarray[19]Array of countries matching the search query
countriesFound.0.country_namestringAMERICAN SAMOAFull name of the country
countriesFound.0.currency_namePremiumstringUS DollarFull name of the currency used in country
countriesFound.0.currency_iso_codestringUSDISO 4217 currency code for the country
countriesFound.0.currency_numberPremiumstring840ISO 4217 numeric currency code
countriesFound.0.currency_mnr_untsPremiumstring2Minor currency units for decimal place specification
countriesFound.0.currency_symbolPremiumstring$Symbol representing the currency
countriesFound.0.exchangeRatePremiumnumber1Live units of this currency per 1 US dollar; null when no rate is published for it
countriesFound.0.usdValuePremiumnumber1Live value of 1 unit of this currency in US dollars; null when no rate is published for it
countriesFound.0.change1dPremiumnumber0Percent change in the currency's US dollar value since yesterday's close (positive means it strengthened); null when no close is stored
ratesUpdatedPremiumstring2026-10-27T17:41:09.810ZISO 8601 time the live exchange rates were last refreshed
currencystringUSDThe currency code of the queried country

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This skill is not part of VerveKit. Check the catalog.
429Out of credits, or a brief rate limit. The message tells them apart.

A call costs 1 credit each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Supported Currencies

170+ world currencies supported including fiat currencies, cryptocurrencies, and precious metals.

CodeCurrencyRegion
AEDUAE DirhamUnited Arab Emirates
AFNAfghan AfghaniAfghanistan
ALLAlbanian LekAlbania
AMDArmenian DramArmenia
ANGNetherlands Antillean GuilderCuraçao
AOAAngolan KwanzaAngola
ARSArgentine PesoArgentina
AUDAustralian DollarAustralia
AWGAruban FlorinAruba
AZNAzerbaijani ManatAzerbaijan
BAMBosnia-Herzegovina Convertible MarkBosnia and Herzegovina
BBDBarbadian DollarBarbados

Use cases

E-Commerce Storefronts
Look up a buyer's country during checkout to retrieve the matching ISO currency code and render localized pricing with the correct symbol.
Invoicing Systems
Accounting platforms query an ISO currency code to identify the associated countries, numeric code, and decimal precision before generating international billing records.
Multi-Currency Digital Wallets
When a customer opens a foreign account balance, fetch the official currency name and symbol to display next to the ledger balance.
Expense Report Processing
Map foreign transaction entries to their originating country and currency code to validate expense submissions across international subsidiaries.

Other ways to use Currency Symbol Skill

Set up Currency Symbol Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

More in Finance:

Dividends SkillGet Company Dividend History by TickerEnergy Price SkillGet Daily Oil, Natural Gas and Fuel Spot PricesEthereum Price SkillGet Current Ethereum PriceExchange Rate SkillGet exchange rate between two currenciesFinancial Ratios SkillGet Key Financial Ratios for a Company by TickerGas Price SkillGet Weekly Gasoline and Diesel Prices for the US, UK and EU
Was this page helpful?