{"id":19520623,"url":"https://github.com/forexrateapi/forexrateapi-nodejs","last_synced_at":"2026-03-01T02:33:24.041Z","repository":{"id":65423313,"uuid":"590991051","full_name":"forexrateapi/forexrateapi-nodejs","owner":"forexrateapi","description":"Currency exchange rates library | Official Node.js API wrapper for ForexRateAPI","archived":false,"fork":false,"pushed_at":"2026-02-25T13:58:41.000Z","size":8,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-25T15:54:01.368Z","etag":null,"topics":["currency","currency-converter","foreign-exchange-rates","foreignexchange","forex","nodejs","price-tracker"],"latest_commit_sha":null,"homepage":"https://forexrateapi.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/forexrateapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-01-19T17:24:44.000Z","updated_at":"2026-02-25T13:58:44.000Z","dependencies_parsed_at":"2024-10-04T12:39:48.708Z","dependency_job_id":"c6121dbc-1165-4981-8d51-fe07226de152","html_url":"https://github.com/forexrateapi/forexrateapi-nodejs","commit_stats":{"total_commits":1,"total_committers":1,"mean_commits":1.0,"dds":0.0,"last_synced_commit":"867b32d090ba7c11b72bf40a870b28b7043cc7f2"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/forexrateapi/forexrateapi-nodejs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-nodejs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-nodejs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-nodejs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-nodejs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/forexrateapi","download_url":"https://codeload.github.com/forexrateapi/forexrateapi-nodejs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-nodejs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29959121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T01:47:18.291Z","status":"online","status_checked_at":"2026-03-01T02:00:07.437Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["currency","currency-converter","foreign-exchange-rates","foreignexchange","forex","nodejs","price-tracker"],"created_at":"2024-11-11T00:26:54.096Z","updated_at":"2026-03-01T02:33:23.965Z","avatar_url":"https://github.com/forexrateapi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ForexRateAPI\n\nforexrateapi is the official Node.js wrapper for ForexRateAPI.com. This allows you to quickly integrate our foreign exchange rate API and currency conversion API into your application. Check https://forexrateapi.com documentation for more information.\n\n\n\n## Installation\n\n#### NPM\n\n```\n$ npm i forexrateapi\n```\n---\n## Usage\n\n```js\nconst api = require('forexrateapi');\n\napi.setAPIKey('SET_YOUR_API_KEY_HERE');\nawait api.fetchLive('USD', ['AUD', 'CAD', 'GBP', 'JPY']);\n```\n---\n## Documentation\n\n#### setAPIKey(apiKey)\n\n- `apiKey` \u003c[string]\u003e API Key\n\nIn order to use this library, you must first call this function with an API key.\n\n```js\napi.setAPIKey('SET_YOUR_API_KEY_HERE');\n```\n---\n#### fetchSymbols()\n```js\nawait api.fetchSymbols();\n```\n\n[Link](https://forexrateapi.com/documentation#api_symbol)\n\n---\n#### fetchLive(base, currencies)\n\n- `base` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `currencies` \u003c[Array]\u003c[string]\u003e\u003e Optional. Pass in an array of currencies to return values for.\n\n```js\nawait api.fetchLive('USD', ['AUD', 'CAD', 'GBP', 'JPY']);\n```\n\n[Link](https://forexrateapi.com/documentation#api_realtime)\n\n---\n#### fetchHistorical(date, base, currencies)\n\n- `date` \u003c[string]\u003e Required. Pass in a string with format `YYYY-MM-DD`\n- `base` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `currencies` \u003c[Array]\u003c[string]\u003e\u003e Optional. Pass in an array of currencies to return values for.\n\n```js\nawait api.fetchHistorical('2024-02-05', 'USD', ['AUD', 'CAD', 'GBP', 'JPY']);\n```\n\n[Link](https://forexrateapi.com/documentation#api_historical)\n\n---\n#### ohlc(base, currency, date, dateType)\n\n- `base` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `currency` \u003c[string]\u003e Required. Specify currency you would like to get OHLC for.\n- `date` \u003c[string]\u003e Required. Specify date to use historical midpoint value for conversion with format `YYYY-MM-DD`. Otherwise, it will use live exchange rate date if value not passed in.\n- `dateType` \u003c[string]\u003e Optional. Pass in a date type, overrides date parameter if passed in.\n\n```js\nawait api.ohlc('USD', 'EUR', '2024-02-05', null);\n```\n\n[Link](https://forexrateapi.com/documentation#api_ohlc)\n\n---\n#### convert(from, to, amount, date)\n\n- `from` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `to` \u003c[string]\u003e Required. Specify currency you would like to convert to.\n- `amount` \u003c[number]\u003e Required. The amount to convert.\n- `date` \u003c[string]\u003e Optional. Specify date to use historical midpoint value for conversion with format `YYYY-MM-DD`. Otherwise, it will use live exchange rate date if value not passed in.\n\n```js\nawait api.convert('USD', 'EUR', 100, '2024-02-05');\n```\n\n[Link](https://forexrateapi.com/documentation#api_convert)\n\n---\n#### timeframe(start_date, end_date, base, currencies)\n\n- `start_date` \u003c[string]\u003e Required. Specify the start date of your timeframe using the format `YYYY-MM-DD`.\n- `end_date` \u003c[string]\u003e Required. Specify the end date of your timeframe using the format `YYYY-MM-DD`.\n- `base` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `currencies` \u003c[Array]\u003c[string]\u003e\u003e Optional. Pass in an array of currencies to return values for.\n\n```js\nawait api.timeframe('2024-02-05', '2024-02-06', 'USD', ['AUD', 'CAD', 'GBP', 'JPY']);\n```\n\n[Link](https://forexrateapi.com/documentation#api_timeframe)\n\n---\n#### change(start_date, end_date, base, currencies)\n\n- `start_date` \u003c[string]\u003e Required. Specify the start date of your timeframe using the format `YYYY-MM-DD`.\n- `end_date` \u003c[string]\u003e Required. Specify the end date of your timeframe using the format `YYYY-MM-DD`.\n- `base` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `currencies` \u003c[Array]\u003c[string]\u003e\u003e Optional. Pass in an array of currencies to return values for.\n\n```js\nawait api.change('2024-02-05', '2024-02-06', 'USD', ['AUD', 'CAD', 'GBP', 'JPY']);\n```\n\n[Link](https://forexrateapi.com/documentation#api_change)\n\n---\n#### usage()\n\n```js\nawait api.usage();\n```\n\n[Link](https://forexrateapi.com/documentation#api_usage)\n\n---\n**[Official documentation](https://forexrateapi.com/documentation)**\n\n\n---\n## FAQ\n\n- How do I get an API Key?\n\n    Free API Keys are available [here](https://forexrateapi.com).\n\n- I want more information\n\n    Checkout our FAQs [here](https://forexrateapi.com/faq).\n\n\n## Support\n\nFor support, get in touch using [this form](https://forexrateapi.com/contact).\n\n\n[array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array 'Array'\n[number]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type 'Number'\n[string]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type 'String'","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforexrateapi%2Fforexrateapi-nodejs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforexrateapi%2Fforexrateapi-nodejs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforexrateapi%2Fforexrateapi-nodejs/lists"}