<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Convert Exchange Rates | fxapi Documentation</title>
<meta name="generator" content="VuePress 1.9.10">
<link rel="icon" type="image/x-icon" href="https://app.fxapi.com/img/favicon/fxapi.ico">
<script src="/docs/scripts/scroll-to-hash.js"></script>
<script defer="defer" data-api="https://fxapi.com/api/event" src="https://fxapi.com/js/form.js"></script>
<meta name="description" content="">
<meta name="theme-color" content="#059669">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<link href="https://fxapi.com/docs/convert" rel="canonical" />
<link rel="preload" href="/docs/assets/css/0.styles.1e177608.css" as="style"><link rel="preload" href="/docs/assets/js/app.7f49d7ed.js" as="script"><link rel="preload" href="/docs/assets/js/2.6ad3e565.js" as="script"><link rel="preload" href="/docs/assets/js/1.480c7c06.js" as="script"><link rel="preload" href="/docs/assets/js/26.3fa967cf.js" as="script"><link rel="preload" href="/docs/assets/js/22.763ab560.js" as="script"><link rel="prefetch" href="/docs/assets/js/10.02bbe909.js"><link rel="prefetch" href="/docs/assets/js/11.f636680a.js"><link rel="prefetch" href="/docs/assets/js/12.723510a3.js"><link rel="prefetch" href="/docs/assets/js/13.9eb85bc6.js"><link rel="prefetch" href="/docs/assets/js/14.a4df9396.js"><link rel="prefetch" href="/docs/assets/js/15.6ed45353.js"><link rel="prefetch" href="/docs/assets/js/16.a07e0aa9.js"><link rel="prefetch" href="/docs/assets/js/17.bd3e849b.js"><link rel="prefetch" href="/docs/assets/js/18.38e4479e.js"><link rel="prefetch" href="/docs/assets/js/19.8f9ca7b8.js"><link rel="prefetch" href="/docs/assets/js/20.aa60c50e.js"><link rel="prefetch" href="/docs/assets/js/21.0d23901b.js"><link rel="prefetch" href="/docs/assets/js/23.802a3efd.js"><link rel="prefetch" href="/docs/assets/js/24.f69fba30.js"><link rel="prefetch" href="/docs/assets/js/25.14be0e16.js"><link rel="prefetch" href="/docs/assets/js/27.734ae8be.js"><link rel="prefetch" href="/docs/assets/js/28.640db7d9.js"><link rel="prefetch" href="/docs/assets/js/29.b1722be1.js"><link rel="prefetch" href="/docs/assets/js/3.adfc2293.js"><link rel="prefetch" href="/docs/assets/js/30.3a7eb56b.js"><link rel="prefetch" href="/docs/assets/js/31.c2fb05ed.js"><link rel="prefetch" href="/docs/assets/js/32.3eef2b22.js"><link rel="prefetch" href="/docs/assets/js/33.f6c7e0af.js"><link rel="prefetch" href="/docs/assets/js/34.aa3f9c1d.js"><link rel="prefetch" href="/docs/assets/js/35.e81bf566.js"><link rel="prefetch" href="/docs/assets/js/36.89cd9cd7.js"><link rel="prefetch" href="/docs/assets/js/37.1a42ccae.js"><link rel="prefetch" href="/docs/assets/js/38.26e23424.js"><link rel="prefetch" href="/docs/assets/js/4.c6846cca.js"><link rel="prefetch" href="/docs/assets/js/5.35abbe5f.js"><link rel="prefetch" href="/docs/assets/js/6.56285f1a.js"><link rel="prefetch" href="/docs/assets/js/7.0591d375.js"><link rel="prefetch" href="/docs/assets/js/vendors~docsearch.3ae8c029.js">
<link rel="stylesheet" href="/docs/assets/css/0.styles.1e177608.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/docs/" class="home-link router-link-active"><img src="https://app.fxapi.com/img/logo/fxapi.png" alt="fxapi Documentation" class="logo"> <span class="site-name can-hide">fxapi Documentation</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><a href="/docs/" class="nav-link">
Guide
</a></div><div class="nav-item"><a href="/docs/examples/" class="nav-link">
Examples
</a></div> <!----></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><a href="/docs/" class="nav-link">
Guide
</a></div><div class="nav-item"><a href="/docs/examples/" class="nav-link">
Examples
</a></div> <!----></nav> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Guide</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/docs/" aria-current="page" class="sidebar-link">Authentication & API key Information</a></li><li><a href="/docs/status-codes.html" class="sidebar-link">Request Status Codes</a></li><li><a href="/docs/testing.html" class="sidebar-link">Testing</a></li><li><a href="/docs/currency-list.html" class="sidebar-link">Currency List</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>Endpoints</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/docs/status.html" class="sidebar-link">Status Endpoint</a></li><li><a href="/docs/currencies.html" class="sidebar-link">Currencies Endpoint</a></li><li><a href="/docs/latest.html" class="sidebar-link">Latest Exchange Rates</a></li><li><a href="/docs/historical.html" class="sidebar-link">Historical Exchange Rates</a></li><li><a href="/docs/range.html" class="sidebar-link">Range Historical Exchange Rates</a></li><li><a href="/docs/convert.html" class="active sidebar-link">Convert Exchange Rates</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/docs/convert.html#request-parameters" class="sidebar-link">Request Parameters</a></li><li class="sidebar-sub-header"><a href="/docs/convert.html#sample-response" class="sidebar-link">Sample Response</a></li></ul></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="convert-exchange-rates"><a href="#convert-exchange-rates" class="header-anchor">#</a> Convert Exchange Rates</h1> <p>Returns calculated values for today or any given date for all currencies.</p> <p><strong>Request Method:</strong> <code>GET</code><br> <strong>Request URL:</strong> <code>https://api.fxapi.com/v1/convert</code></p> <h2 id="request-parameters"><a href="#request-parameters" class="header-anchor">#</a> Request Parameters</h2> <table><thead><tr><th>Parameter</th> <th>Type</th> <th>Mandatory</th> <th>Description</th></tr></thead> <tbody><tr><td><code>apikey</code></td> <td><em>string</em></td> <td><svg width="20px" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"></path></svg>️</td> <td>Your API Key</td></tr> <tr><td><code>value</code></td> <td><em>string</em></td> <td><svg width="20px" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"></path></svg>️</td> <td>The value you want to convert</td></tr> <tr><td><code>date</code></td> <td><em>string</em></td> <td>️</td> <td>Date to retrieve historical rates from (format: 2021-12-31)</td></tr> <tr><td><code>base_currency</code></td> <td><em>string</em></td> <td></td> <td>The base currency to which all results are behaving relative to<br>By default all values are based on USD</td></tr> <tr><td><code>currencies</code></td> <td><em>string</em></td> <td></td> <td>A list of comma seperated currency codes which you want to get (EUR,USD,CAD)<br>By default all available currencies will be shown</td></tr></tbody></table> <h2 id="sample-response"><a href="#sample-response" class="header-anchor">#</a> Sample Response</h2> <p>The API response comes easy-to-read JSON-format contains all the currencies .</p> <div class="language-json extra-class"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">"meta"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"last_updated_at"</span><span class="token operator">:</span> <span class="token string">"2022-01-01T23:59:59Z"</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"AED"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token string">"AED"</span><span class="token punctuation">,</span>
<span class="token property">"value"</span><span class="token operator">:</span> <span class="token number">3.67306</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">"AFN"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token string">"AFN"</span><span class="token punctuation">,</span>
<span class="token property">"value"</span><span class="token operator">:</span> <span class="token number">91.80254</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">"ALL"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token string">"ALL"</span><span class="token punctuation">,</span>
<span class="token property">"value"</span><span class="token operator">:</span> <span class="token number">108.22904</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">"AMD"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token string">"AMD"</span><span class="token punctuation">,</span>
<span class="token property">"value"</span><span class="token operator">:</span> <span class="token number">480.41659</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">"..."</span><span class="token operator">:</span> <span class="token string">"150+ more currencies"</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre></div></div> <footer class="page-edit"><!----> <!----></footer> <!----> </main></div><div class="global-ui"><!----></div></div>
<script src="/docs/assets/js/app.7f49d7ed.js" defer></script><script src="/docs/assets/js/2.6ad3e565.js" defer></script><script src="/docs/assets/js/1.480c7c06.js" defer></script><script src="/docs/assets/js/26.3fa967cf.js" defer></script><script src="/docs/assets/js/22.763ab560.js" defer></script>
</body>
</html>