Convert a specific amount from one currency to another using the latest available exchange rates. This endpoint performs real-time currency conversion calculations, making it easy to handle cross-currency transactions in your application.The returned data includes the timestamp of the conversion rate used, ensuring transparency for financial calculations.
Note on Precision: Some currency pairs are returned with a multiplier (e.g., 100 or 1000) to ensure high precision.
Query parameters
string
required
The 3-letter currency code of the source currency (e.g., USD, EUR). See the list of available pairs.
string
required
The 3-letter currency code of the target currency (e.g., GBP, JPY). See the list of available pairs.
decimal
required
The value to convert.
Response
object
Metadata about the conversion rate used.
string
The Unix timestamp (epoch) when the rate was collected.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"xChangeApi.com","colors":{"primary":"#b75fe3","light":"#9938CA","dark":"#9938CA"},"logo":{"light":"https://mintcdn.com/xchangeapi/wjluIIKvOZxjEvik/logo/light.png?fit=max\u0026auto=format\u0026n=wjluIIKvOZxjEvik\u0026q=85\u0026s=29907fdc32b4f908b7b0cbcaaf707ddd","dark":"https://mintcdn.com/xchangeapi/wjluIIKvOZxjEvik/logo/light.png?fit=max\u0026auto=format\u0026n=wjluIIKvOZxjEvik\u0026q=85\u0026s=29907fdc32b4f908b7b0cbcaaf707ddd"},"favicon":"/favicon.svg","api":{"mdx":{"auth":{"method":"key","name":"api-key"},"server":"https://api.xchangeapi.com/"}},"navbar":{"primary":{"type":"button","label":"Sign in","href":"https://xchangeapi.com/sign-in"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xchangeapi","hasAudioNarration":false,"actualSubdomain":"xchangeapi","customDomains":["xchangeapi.com"],"gitSource":{"type":"github","owner":"rrosmus","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae942ae8b3a7fe7583a0bb9:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"HTTP API Reference","count":8},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Guides \u0026 Recipes","count":5},{"language":"default","tag":"Historical Data","count":3},{"language":"default","tag":"Live Data","count":3},{"language":"default","tag":"Quickstart","count":3},{"language":"default","tag":"Websocket API Reference","count":3},{"language":"default","tag":"Currency Tools","count":1},{"language":"default","tag":"Metadata","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"http/currency-tools/convert","slug":"/http/currency-tools/convert","pageMetadata":{"title":"Currency conversion","api":"GET convert?amount={amount}\u0026from={from}\u0026to={to}","description":null,"href":"/http/currency-tools/convert"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Info,ParamField,ResponseField}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Convert a specific amount from one currency to another using the latest available exchange rates. This endpoint performs real-time currency conversion calculations, making it easy to handle cross-currency transactions in your application.`}),`\n`,_jsx(_components.p,{children:`The returned data includes the timestamp of the conversion rate used, ensuring transparency for financial calculations.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Note on Precision`}),`: Some currency pairs are returned with a `,_jsx(_components.a,{href:`/http/metadata/multipliers`,children:`multiplier`}),` (e.g., 100 or 1000) to ensure high precision.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{path:`from`,type:`string`,required:true,id:`param-from`,children:_jsxs(_components.p,{children:[`The 3-letter currency code of the source currency (e.g., `,_jsx(_components.code,{children:`USD`}),`, `,_jsx(_components.code,{children:`EUR`}),`). See the list of `,_jsx(_components.a,{href:`/guides/available-currencies`,children:`available pairs`}),`.`]})}),`\n`,_jsx(ParamField,{path:`to`,type:`string`,required:true,id:`param-to`,children:_jsxs(_components.p,{children:[`The 3-letter currency code of the target currency (e.g., `,_jsx(_components.code,{children:`GBP`}),`, `,_jsx(_components.code,{children:`JPY`}),`). See the list of `,_jsx(_components.a,{href:`/guides/available-currencies`,children:`available pairs`}),`.`]})}),`\n`,_jsx(ParamField,{path:`amount`,type:`decimal`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`The value to convert.`})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`info`,type:`object`,id:`param-info`,children:[_jsx(_components.p,{children:`Metadata about the conversion rate used.`}),_jsx(ResponseField,{name:`timestamp`,type:`string`,id:`param-timestamp`,children:_jsx(_components.p,{children:`The Unix timestamp (epoch) when the rate was collected.`})}),_jsx(ResponseField,{name:`rate`,type:`string`,id:`param-rate`,children:_jsx(_components.p,{children:`The exchange rate used for this conversion.`})})]}),`\n`,_jsxs(ResponseField,{name:`query`,type:`object`,id:`param-query`,children:[_jsx(_components.p,{children:`Echoes the parameters used in the request.`}),_jsx(ResponseField,{name:`from`,type:`string`,id:`param-from-1`,children:_jsx(_components.p,{children:`Source currency code.`})}),_jsx(ResponseField,{name:`to`,type:`string`,id:`param-to-1`,children:_jsx(_components.p,{children:`Target currency code.`})}),_jsx(ResponseField,{name:`amount`,type:`decimal`,id:`param-amount-1`,children:_jsx(_components.p,{children:`Amount converted.`})})]}),`\n`,_jsx(ResponseField,{name:`result`,type:`string`,id:`param-result`,children:_jsx(_components.p,{children:`The calculated converted amount.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Currency conversion","api":"GET convert?amount={amount}\u0026from={from}\u0026to={to}","description":null,"href":"/http/currency-tools/convert"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Convert a specific amount from one currency to another using the latest available exchange rates. This endpoint performs real-time currency conversion calculations, making it easy to handle cross-currency transactions in your application.`}),`\n`,_jsx(_components.p,{children:`The returned data includes the timestamp of the conversion rate used, ensuring transparency for financial calculations.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Note on Precision`}),`: Some currency pairs are returned with a `,_jsx(_components.a,{href:`/http/metadata/multipliers`,children:`multiplier`}),` (e.g., 100 or 1000) to ensure high precision.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{path:`from`,type:`string`,required:true,id:`param-from`,children:_jsxs(_components.p,{children:[`The 3-letter currency code of the source currency (e.g., `,_jsx(_components.code,{children:`USD`}),`, `,_jsx(_components.code,{children:`EUR`}),`). See the list of `,_jsx(_components.a,{href:`/guides/available-currencies`,children:`available pairs`}),`.`]})}),`\n`,_jsx(ParamField,{path:`to`,type:`string`,required:true,id:`param-to`,children:_jsxs(_components.p,{children:[`The 3-letter currency code of the target currency (e.g., `,_jsx(_components.code,{children:`GBP`}),`, `,_jsx(_components.code,{children:`JPY`}),`). See the list of `,_jsx(_components.a,{href:`/guides/available-currencies`,children:`available pairs`}),`.`]})}),`\n`,_jsx(ParamField,{path:`amount`,type:`decimal`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`The value to convert.`})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`info`,type:`object`,id:`param-info`,children:[_jsx(_components.p,{children:`Metadata about the conversion rate used.`}),_jsx(ResponseField,{name:`timestamp`,type:`string`,id:`param-timestamp`,children:_jsx(_components.p,{children:`The Unix timestamp (epoch) when the rate was collected.`})}),_jsx(ResponseField,{name:`rate`,type:`string`,id:`param-rate`,children:_jsx(_components.p,{children:`The exchange rate used for this conversion.`})})]}),`\n`,_jsxs(ResponseField,{name:`query`,type:`object`,id:`param-query`,children:[_jsx(_components.p,{children:`Echoes the parameters used in the request.`}),_jsx(ResponseField,{name:`from`,type:`string`,id:`param-from-1`,children:_jsx(_components.p,{children:`Source currency code.`})}),_jsx(ResponseField,{name:`to`,type:`string`,id:`param-to-1`,children:_jsx(_components.p,{children:`Target currency code.`})}),_jsx(ResponseField,{name:`amount`,type:`decimal`,id:`param-amount-1`,children:_jsx(_components.p,{children:`Amount converted.`})})]}),`\n`,_jsx(ResponseField,{name:`result`,type:`string`,id:`param-result`,children:_jsx(_components.p,{children:`The calculated converted amount.`})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Example response`,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"info\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1766937316.276\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.17697`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"query\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"from\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EUR\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`11.7697`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Currency conversion","api":"GET convert?amount={amount}\u0026from={from}\u0026to={to}","description":null,"href":"/http/currency-tools/convert"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Query parameters","slug":"query-parameters","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Example response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"info\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"timestamp\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1766937316.276\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"rate\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1.17697\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"query\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"to\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">10\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"from\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"EUR\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"result\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">11.7697\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Currency conversion","path":"convert?amount={amount}\u0026from={from}\u0026to={to}","servers":[{"url":"https://api.xchangeapi.com/"}],"method":"get","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"api-key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"from":{"schema":[{"type":"string","description":"The 3-letter currency code of the source currency (e.g., `USD` , `EUR` ). See the list of available pairs .","required":true}]},"to":{"schema":[{"type":"string","description":"The 3-letter currency code of the target currency (e.g., `GBP` , `JPY` ). See the list of available pairs .","required":true}]},"amount":{"schema":[{"type":"number","description":"The value to convert.","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"info":[{"type":"object","properties":{"timestamp":[{"type":"string","description":"The Unix timestamp (epoch) when the rate was collected."}],"rate":[{"type":"string","description":"The exchange rate used for this conversion."}]},"description":"Metadata about the conversion rate used."}],"query":[{"type":"object","properties":{"from":[{"type":"string","description":"Source currency code."}],"to":[{"type":"string","description":"Target currency code."}],"amount":[{"type":"number","description":"Amount converted."}]},"description":"Echoes the parameters used in the request."}],"result":[{"type":"string","description":"The calculated converted amount."}]}}],"examples":{"example":{"value":{"info":{"timestamp":"\u003cstring>","rate":"\u003cstring>"},"query":{"from":"\u003cstring>","to":"\u003cstring>","amount":123},"result":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":["/docs/_mintlify/custom/xchangeapi/495ba753a52db71e/websocket/example-implementation/js/websocket.js","/docs/_mintlify/custom/xchangeapi/48911bb8c68ad74b/websocket/example-implementation/node/client.js"],"subdomain":"xchangeapi","siteName":"xChangeApi.com","title":"Currency conversion - xChangeApi.com","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-12-28T22:45:31.832Z","originalFileLocation":"http/currency-tools/convert.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"xChangeApi.com\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Currency conversion - xChangeApi.com\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"xChangeApi.com\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://xchangeapi.com/docs/http/currency-tools/convert\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xchangeapi.mintlify.site/docs/_mintlify/api/og/v2?division=Currency+Tools\u0026amp;title=Currency+conversion\u0026amp;theme=9ac6bf1a0da426ccc92107b9\u0026amp;signature=a295a72da84012a85604f1465f43b9e04d75f8f03762b07509da3e004da324b8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Currency conversion - xChangeApi.com\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xchangeapi.mintlify.site/docs/_mintlify/api/og/v2?division=Currency+Tools\u0026amp;title=Currency+conversion\u0026amp;theme=9ac6bf1a0da426ccc92107b9\u0026amp;signature=a295a72da84012a85604f1465f43b9e04d75f8f03762b07509da3e004da324b8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/xchangeapi/wHHzBy3GmlwqcEnG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"xChangeApi.com\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#b75fe3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://xchangeapi.com/docs/http/currency-tools/convert\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/http/currency-tools/convert.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://xchangeapi.com/#organization\",\"name\":\"xChangeApi.com\",\"url\":\"https://xchangeapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xchangeapi/wjluIIKvOZxjEvik/logo/light.png?fit=max\u0026auto=format\u0026n=wjluIIKvOZxjEvik\u0026q=85\u0026s=29907fdc32b4f908b7b0cbcaaf707ddd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://xchangeapi.com/docs#website\",\"name\":\"xChangeApi.com\",\"url\":\"https://xchangeapi.com/docs\",\"publisher\":{\"@id\":\"https://xchangeapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://xchangeapi.com/docs/http/currency-tools/convert#webpage\",\"url\":\"https://xchangeapi.com/docs/http/currency-tools/convert\",\"name\":\"Currency conversion\",\"dateModified\":\"2025-12-28T22:45:31.832Z\",\"isPartOf\":{\"@id\":\"https://xchangeapi.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://xchangeapi.com/docs/http/currency-tools/convert#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://xchangeapi.com/docs/http/currency-tools/convert#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"HTTP API Reference\",\"item\":\"https://xchangeapi.com/docs/http/live-data/latest\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Currency conversion\",\"item\":\"https://xchangeapi.com/docs/http/currency-tools/convert\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://xchangeapi.com/docs/http/currency-tools/convert#apireference\",\"headline\":\"Currency conversion\",\"name\":\"Currency conversion\",\"url\":\"https://xchangeapi.com/docs/http/currency-tools/convert\",\"mainEntityOfPage\":{\"@id\":\"https://xchangeapi.com/docs/http/currency-tools/convert#webpage\"},\"dateModified\":\"2025-12-28T22:45:31.832Z\",\"publisher\":{\"@id\":\"https://xchangeapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://xchangeapi.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"xChangeApi.com\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"xChangeApi.com\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/http/currency-tools/convert.md","siteName":"xChangeApi.com","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"group":"Quickstart","pages":[{"title":"Quickstart","href":"/quickstart"},{"title":"HTTP API Quickstart","href":"/quickstart/http-api"},{"title":"WebSocket API Quickstart","href":"/quickstart/websocket-api"}]},{"title":"Authentication","href":"/authentication"},{"title":"Rate Limits","href":"/rate-limits"}]},{"group":"HTTP API Reference","pages":[{"group":"Live Data","pages":[{"title":"Latest rates","api":"GET latest?base={base}","href":"/http/live-data/latest"},{"title":"Single currency rate","api":"GET {format}/currencies/{currency-pair}","href":"/http/live-data/single-currency"},{"title":"Multiple currencies rates","api":"GET {format}/currencies?pairs={currency-pairs}","href":"/http/live-data/many-currencies"},{"title":"Symbols","href":"/http/metadata/symbols"}]},{"group":"Historical Data","pages":[{"title":"Historical rates","api":"GET historical/{date}","href":"/http/historical-data/historical"},{"title":"OHLC chart data for date range","api":"GET {format}/chart/{currency-pair}?starttime={starttime}\u0026endtime={endtime}","href":"/http/historical-data/ohlc-date-range"},{"title":"OHLC chart data for selected period","api":"GET {format}/chart/{currency-pair}/{period}","description":null,"href":"/http/historical-data/ohlc-period"}]},{"group":"Currency Tools","pages":[{"title":"Currency conversion","api":"GET convert?amount={amount}\u0026from={from}\u0026to={to}","href":"/http/currency-tools/convert"}]},{"group":"Metadata","pages":[{"title":"Multipliers","description":"Understanding price precision and multipliers for low-value currencies.","api":"GET currencies/multipliers","href":"/http/metadata/multipliers"}]}]},{"group":"Websocket API Reference","pages":[{"title":"Protocol description","href":"/websocket/protocol"},{"title":"Available message codes","href":"/websocket/message-codes"},{"title":"Example implementation","href":"/websocket/example-implementation"}]},{"group":"Guides \u0026 Recipes","pages":[{"title":"Available Currencies","href":"/guides/available-currencies"},{"title":"Available Cryptocurrencies","href":"/guides/available-cryptocurrencies"},{"title":"Data Formats","href":"/guides/response-formatting"},{"title":"Response Structures","href":"/guides/data-properties"},{"title":"Developer Best Practices","href":"/guides/best-practices"}]}]},"basePath":"","title":"Currency conversion - xChangeApi.com","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js"]}