{"id":19520591,"url":"https://github.com/forexrateapi/forexrateapi-ruby","last_synced_at":"2026-02-12T03:03:27.115Z","repository":{"id":65371235,"uuid":"591048160","full_name":"forexrateapi/forexrateapi-ruby","owner":"forexrateapi","description":"Currency forex rates library | Official Ruby API wrapper for ForexRateAPI","archived":false,"fork":false,"pushed_at":"2025-02-03T23:49:59.000Z","size":8,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-08T17:31:57.102Z","etag":null,"topics":["currency-converter","foreign-exchange","foreign-exchange-rates","forex"],"latest_commit_sha":null,"homepage":"https://forexrateapi.com/","language":"Ruby","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.md","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}},"created_at":"2023-01-19T20:08:37.000Z","updated_at":"2025-02-03T23:49:56.000Z","dependencies_parsed_at":"2025-02-26T00:25:39.184Z","dependency_job_id":"9432f2ad-0cfe-4bb3-ae2b-d460a602f19f","html_url":"https://github.com/forexrateapi/forexrateapi-ruby","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/forexrateapi/forexrateapi-ruby","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/forexrateapi","download_url":"https://codeload.github.com/forexrateapi/forexrateapi-ruby/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forexrateapi%2Fforexrateapi-ruby/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29355859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T01:03:07.613Z","status":"online","status_checked_at":"2026-02-12T02:00:06.911Z","response_time":55,"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-converter","foreign-exchange","foreign-exchange-rates","forex"],"created_at":"2024-11-11T00:26:44.187Z","updated_at":"2026-02-12T03:03:27.099Z","avatar_url":"https://github.com/forexrateapi.png","language":"Ruby","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## Installation\nAdd to Gemfile.\n\n```\ngem 'forexrateapi'\n```\n\n## Usage\n\n```ruby\n\napi_key = 'SET_YOUR_API_KEY_HERE'\nclient = ForexRateAPI::Client.new(api_key: api_key)\n```\n---\n## Documentation\n\n#### fetchSymbols()\n```ruby\nclient.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```ruby\nclient.fetchLive(base='USD', currencies=['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```ruby\nclient.fetchHistorical(date='2021-04-05', base='USD', currencies=['AUD', 'CAD', 'GBP', 'JPY'])\n```\n\n[Link](https://forexrateapi.com/documentation#api_historical)\n\n---\n#### ohlc(base, currency, date, date_type)\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 get OHLC for specific date using format `YYYY-MM-DD`.\n- `date_type` \u003c[string]\u003e Optional. Pass in a date type, overrides date parameter if passed in.\n\n```ruby\nclient.ohlc(base='USD', currency='EUR', date='2021-04-05', date_type=nil)\n```\n\n[Link](https://forexrateapi.com/documentation#api_ohlc)\n\n---\n#### convert(from_currency, to_currency, amount, date)\n\n- `from_currency` \u003c[string]\u003e Optional. Pass in a base currency, defaults to USD.\n- `to_currency` \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```ruby\nclient.convert(from_currency='USD', to_currency='EUR', amount=100, date='2021-04-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```ruby\nclient.timeframe(start_date='2021-04-05', end_date='2021-04-06', base='USD', currencies=['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```ruby\nclient.change(start_date='2021-04-05', end_date='2021-04-06', base='USD', currencies=['AUD', 'CAD', 'GBP', 'JPY'])\n```\n\n[Link](https://forexrateapi.com/documentation#api_change)\n\n---\n#### usage()\n\n```ruby\nclient.usage()\n```\n\n[Link](https://forexrateapi.com/documentation#api_usage)\n\n---\n**[Official documentation](https://forexrateapi.com/documentation)**\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://www.geeksforgeeks.org/ruby-data-types/ 'Array'\n[number]: https://www.geeksforgeeks.org/ruby-data-types/ 'Number'\n[string]: https://apidock.com/ruby/String 'String'","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforexrateapi%2Fforexrateapi-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforexrateapi%2Fforexrateapi-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforexrateapi%2Fforexrateapi-ruby/lists"}