CurrAPI.com
HomePricingCurrenciesDocumentationCalculator

CurrAPI

Reliable currency exchange rate data for developers.

Product

  • Pricing
  • Currencies
  • Documentation
  • Dashboard
  • Calculator

Company

  • Contact

© 2025 CurrAPI.com. All rights reserved.

    Getting Started

    • Introduction

    NPM Package

    • Installation
    • Usage

    Reference

    • Supported Currencies

    API Documentation

    Welcome to the currapi documentation. Learn how to integrate with our API to access historical currency exchange rates.

    Installation

    Install the @appaka/currapi package using npm, yarn, or pnpm:

    npm install @appaka/currapi

    Usage

    The @appaka/currapi package provides a simple and intuitive API for accessing currency exchange rates.

    Initialization

    First, initialize the client with your API key:

    import { CurrAPIClient } from '@appaka/currapi'
    
    // Initialize the client with your API key
    const currapi = new CurrAPIClient(process.env.CURRAPI_API_KEY!)
    Security Note
    Never expose your API key in client-side code. For frontend applications, use environment variables and a backend proxy to make API calls.

    Caching

    Optionally, implement caching functions to reduce the number of requests to currapi.com:

    import Redis from 'ioredis'
    import { CurrAPIClient } from '@appaka/currapi'
    
    const redis = new Redis(process.env.REDIS_URL!)
    
    const currapi = new CurrAPIClient(process.env.CURRAPI_API_KEY!, {
      verboseMode: true,
      cacheGet: (base, target, date) => redis.get(`${date}:${base}${target}`),
      cacheSet: (base, target, date, rate) =>
        redis.set(`${date}:${base}${target}`, rate),
    })
    

    Getting Exchange Rates

    Fetch the exchange rate between two currencies for a specific date:

    // Get exchange rate
    const rate = await currapi.getRate('USD', 'EUR', '2023-01-15')
    console.log(rate) // 0.92385671

    Converting Currency

    Convert an amount from one currency to another:

    // Convert currency
    const result = await currapi.convert(100, 'USD', 'EUR', '2023-01-15')
    // Date is optional, defaults to current date
    console.log(result) // 92.39 EUR

    Supported Currencies

    CurrAPI provides exchange rate data for 60 different assets across three categories: fiat currencies, cryptocurrencies, and precious metals.

    Programmatic Access

    You can access the list of supported currencies and their codes programmatically using the CURRENCIES constant from the npm package:

    import { CURRENCIES } from '@appaka/currapi'
    
    // CURRENCIES contains all supported currency codes
    console.log(CURRENCIES)
    // ['EUR', 'USD', 'JPY', 'BTC', 'ETH', 'XAU', ...]

    Complete Currency List

    Below is the full list of all supported currencies, organized by category:

    Fiat Currencies

    31 major world currencies from the European Central Bank

    CodeName
    AUDAustralian Dollar
    BGNBulgarian Lev
    BRLBrazilian Real
    CADCanadian Dollar
    CHFSwiss Franc
    CNYChinese Yuan
    CZKCzech Koruna
    DKKDanish Krone
    EUREuro
    GBPBritish Pound
    HKDHong Kong Dollar
    HUFHungarian Forint
    IDRIndonesian Rupiah
    ILSIsraeli Shekel
    INRIndian Rupee
    ISKIcelandic Krona
    JPYJapanese Yen
    KRWSouth Korean Won
    MXNMexican Peso
    MYRMalaysian Ringgit
    NOKNorwegian Krone
    NZDNew Zealand Dollar
    PHPPhilippine Peso
    PLNPolish Zloty
    RONRomanian Leu
    SEKSwedish Krona
    SGDSingapore Dollar
    THBThai Baht
    TRYTurkish Lira
    USDUS Dollar
    ZARSouth African Rand

    Cryptocurrencies

    25 major cryptocurrencies via Kraken API

    CodeName
    AAVEAave
    ADACardano
    ALGOAlgorand
    ATOMCosmos
    AXSAxie Infinity
    BCHBitcoin Cash
    BTCBitcoin
    DOGEDogecoin
    DOTPolkadot
    ETHEthereum
    FILFilecoin
    FLOWFlow
    HBARHedera
    LINKChainlink
    LTCLitecoin
    MANADecentraland
    SANDThe Sandbox
    SOLSolana
    TRXTRON
    UNIUniswap
    WBTCWrapped Bitcoin
    XLMStellar
    XMRMonero
    XRPXRP
    XTZTezos

    Precious Metals

    4 precious metals with daily pricing

    CodeName
    XAGSilver (Troy Ounce)
    XAUGold (Troy Ounce)
    XPDPalladium (Troy Ounce)
    XPTPlatinum (Troy Ounce)