{"id":16776150,"url":"https://github.com/qcl/qcurrency","last_synced_at":"2025-07-19T07:04:42.521Z","repository":{"id":149176915,"uuid":"123726602","full_name":"qcl/QCurrency","owner":"qcl","description":"🇹🇼📈💵💴💶💷 Simple NTD foreign exchange rates API 新台幣匯率API","archived":false,"fork":false,"pushed_at":"2018-04-29T15:04:17.000Z","size":27,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-10T20:29:52.979Z","etag":null,"topics":["api","bank","exchange-rates","google-app-engine","new-taiwan-dollor","python","taiwan"],"latest_commit_sha":null,"homepage":"https://qcurrency-exchange-rates.appspot.com/","language":"Python","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/qcl.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":"2018-03-03T19:59:03.000Z","updated_at":"2018-05-15T08:04:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"54b8b31f-1cdf-489c-85da-72147196a870","html_url":"https://github.com/qcl/QCurrency","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/qcl/QCurrency","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qcl%2FQCurrency","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qcl%2FQCurrency/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qcl%2FQCurrency/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qcl%2FQCurrency/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qcl","download_url":"https://codeload.github.com/qcl/QCurrency/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qcl%2FQCurrency/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265899826,"owners_count":23845876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["api","bank","exchange-rates","google-app-engine","new-taiwan-dollor","python","taiwan"],"created_at":"2024-10-13T07:09:06.370Z","updated_at":"2025-07-19T07:04:42.477Z","avatar_url":"https://github.com/qcl.png","language":"Python","funding_links":["https://www.paypal.me/qclean/5eur"],"categories":[],"sub_categories":[],"readme":"# QCurrency\n\nA simple NTD foreign exchange rates API\n\n[![Build Status](https://travis-ci.org/qcl/QCurrency.svg?branch=master)](https://travis-ci.org/qcl/QCurrency)\n\nQCurrency is a API for getting almost realtime NTD (New Taiwan Dollar, NT\\$, ISO-4217 currency code **TWD**) foreign exchange rates that [published](http://rate.bot.com.tw/) by [Bank of Taiwan](http://www.bot.com.tw/). And also fetched from [Google Search](https://www.google.com/) result.\n\n## Usage\n\n### Directly use HTTP GET\n\n```HTTP\nGET API_ENDPOINT/latest\n```\n\nThen you will get the exchange rates response JSON object. See [APIs](#apis) for more infromation and excample.\n\n## APIs\n\nAPI endpoint: `https://qcurrency-exchange-rates.appspot.com/api`. You can also use this repository to build your own API server.\n\n### Get latest exchange rates\n\n```http\nGET /latest\n```\n\n#### Response\n\n- update: string, update time in ISO 8601 format.\n- source: string, name of soure.\n- rates: dictionary, currency name string in ISO 4217 to as key, and exchange rate in float as value.\n\n#### Sample response\n\n```json\n{\n    \"update\": \"2018-03-09T16:15:00+08:00\",\n    \"source\": \"Bank of Taiwan\",\n    \"rates\": {\n        \"THB\": 0.9586,\n        \"ZAR\": 2.5,\n        \"GBP\": 40.73,\n        \"NZD\": 21.42,\n        \"CHF\": 30.92,\n        \"CNY\": 4.647,\n        \"JPY\": 0.2765,\n        \"USD\": 29.34,\n        \"SGD\": 22.32,\n        \"HKD\": 3.766,\n        \"SEK\": 3.6,\n        \"CAD\": 22.86,\n        \"AUD\": 22.97,\n        \"EUR\": 36.27\n    }\n}\n```\n\n### Available exchange rates sources\n\n```HTTP\nGET /sources\n```\n\nTo be implemented.\n\n### Get latest exchange rates by source\n\n```HTTP\nGET /SOURCE_NAME/latest\n```\n\nTo be implemented.\n\n## How does it work?\n\nBasically, it's a Google App Engine instance that fetchs data and parses it from Bank of Taiwan every few minutes. \n\n## Develop\n\n### Google Cloud SDK\n\nInstall [Google Cloud SDK](https://cloud.google.com/sdk/downloads), so that you can start use `gcloud` commands.\n\nAfter installation, [install app engine component](https://cloud.google.com/appengine/docs/standard/python/download).\n\n```\n$ gcloud components install app-engine-python\n```\n\nIf you already have `gcloud`, you can also update it.\n\n```\n$ gcloud components update\n```\n\n### Python2.7\n\nDou to Google App Engine Python Standard Enviroment use `python2.7` as its python version. If the default `python` command in your computer (e.g. Using homebrew python on a Mac) is Python 3, please modify enviroment variable or `$PATH` to make `pathon2.7` as default one to make sure it will use `python2.7` to execute scroipt like `dev_appserver.py`.\n\nYou can also check `Makefile` for some useful command to help you developing.\n\n### Run local app engine\n\n```\n$ dev_appserver.py app.yaml\n```\n\nThen it will start a local app engine server for developing and testing.\n\n### Run test cases\n\n```\n$ python2.7 -m pytest tests/\n```\n\n### Depoly\n\n```\n$ gcloud app depoly --project=APP_ENGINE_PROJECT_NAME\n```\n\n### Deploy cron job\n\n```\n$ gcloud app depoly cron.yaml --project=APP_ENGINE_PROJECT_NAME\n```\n\n## License\n\nSee `LICENSE.md`.\n\n## Donate\n\n- [PayPal](https://www.paypal.me/qclean/5eur)\n- ETH `0x459E11281660e6D5192C746775c5d0EBC6287696`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqcl%2Fqcurrency","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqcl%2Fqcurrency","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqcl%2Fqcurrency/lists"}