{"id":28337227,"url":"https://github.com/hamid/dollar-tomans-api","last_synced_at":"2025-07-06T06:32:41.970Z","repository":{"id":65522894,"uuid":"474011533","full_name":"hamid/dollar-tomans-api","owner":"hamid","description":"return last price of currency like dollar, pound, euro, bitcoin plus oil and gold price in rials(tomans)","archived":false,"fork":false,"pushed_at":"2022-03-28T10:59:51.000Z","size":13,"stargazers_count":41,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-03T03:15:51.291Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hamid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-25T13:02:34.000Z","updated_at":"2025-03-28T21:14:23.000Z","dependencies_parsed_at":"2023-01-27T05:55:15.456Z","dependency_job_id":null,"html_url":"https://github.com/hamid/dollar-tomans-api","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/hamid/dollar-tomans-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamid%2Fdollar-tomans-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamid%2Fdollar-tomans-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamid%2Fdollar-tomans-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamid%2Fdollar-tomans-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hamid","download_url":"https://codeload.github.com/hamid/dollar-tomans-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamid%2Fdollar-tomans-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260392228,"owners_count":23002264,"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":[],"created_at":"2025-05-26T23:18:56.104Z","updated_at":"2025-07-06T06:32:41.946Z","avatar_url":"https://github.com/hamid.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dollar-tomans-api \nReturn last price of currency like dollar, pound, euro, bitcoin plus oil and gold price in rials(tomans) \n\n\n# گرفتن آخرین قیمت دلار\nدر واقع API برای دریافت اخرین قیمت دلارو یورو پوند و سایر ارز های مهم به ریال ، همراه با اخرین قیمت بیت کوین،نفت،طلا، بورس و حتی جدول لیگ برترایران به زبان node.js\n\n\n## لیست ارز ها\n- دلار آمریکا، کانادا، استرالیا : USD\n- یورو : EUR\n- پوند :‌GBP\n- درهم امارات :‌AED\n- لیر ترکیه :‌TRY\n- فرانک سویس :‌CHF\n- یوان چین :‌CNY\n- دینار عراق :‌IQD\n- کرون سوئد :‌SEK\n- ریال عربستان :‌SAR\n- ریال قطر :‌QAR\n- ریال عمان :‌OMR\n- روبل روسیه :‌RUB\n\n### دیگر موارد\n- بیت کوین \n- سکه\n- انس طلا\n- مثقال طلا\n- طلای ۱۸\n- نفت برنت\n- بورس\n- جدول لیگ برتر\n\n\n\n## نصب\n```sh\nnpm i dollar-tomans-api\n```\n\n## نحوه استفاده\n```javascript\nconst  { fetchAll, fetchFootbalLeageTable } = require('dollar-tomans-api');\n...\n...\nvar lastPrice = await fetchAll();\n\nvar leageTable = await fetchFootbalLeageTable();\n\n```  \n\n\n## خروجی\n```javascript\n\nlastPrice = {\n  \"timestamp\": 1648463109494,\n  \"currency\": {\n    \"dollar\": {\n      \"price\": \"264,240\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.63%)\"\n      },\n      \"codes\": \"USD\",\n      \"symbol\": \"$\"\n    },\n    \"euro\": {\n      \"price\": \"290,060\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.57%)\"\n      },\n      \"codes\": \"EUR\",\n      \"symbol\": \"€\"\n    },\n    \"bitcoin\": {\n      \"price\": \"47036.03\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(4.88%)\"\n      },\n      \"codes\": \"BTC\",\n      \"symbol\": \"₿\"\n    },\n    \"pound\": {\n      \"price\": \"347,880\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.22%) 760\"\n      },\n      \"codes\": \"GBP\",\n      \"symbol\": \"£\"\n    },\n    \"canadaDollar\": {\n      \"price\": \"211,400\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.48%) 1,000\"\n      },\n      \"codes\": \"CAD\",\n      \"symbol\": \"$\"\n    },\n    \"austDollar\": {\n      \"price\": \"201,600\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.65%) 1,300\"\n      },\n      \"codes\": \"AUD\",\n      \"symbol\": \"$\"\n    },\n    \"franc\": {\n      \"price\": \"285,000\",\n      \"change\": {\n        \"type\": \"none\",\n        \"change\": \"(0.07%) 200\"\n      },\n      \"codes\": \"CHF\",\n      \"symbol\": \"fr\"\n    },\n    \"sweedSek\": {\n      \"price\": \"28,000\",\n      \"change\": {\n        \"type\": \"none\",\n        \"change\": \"(0%) 0\"\n      },\n      \"codes\": \"SEK\",\n      \"symbol\": \"kr\"\n    },\n    \"lier\": {\n      \"price\": \"18,800\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.53%) 100\"\n      },\n      \"codes\": \"TRY\",\n      \"symbol\": \"₺\"\n    },\n    \"yuan\": {\n      \"price\": \"42,000\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.48%) 200\"\n      },\n      \"codes\": \"CNY\",\n      \"symbol\": \"¥\"\n    },\n    \"roble\": {\n      \"price\": \"2,800\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(2.56%) 70\"\n      },\n      \"codes\": \"RUB\",\n      \"symbol\": \"₽\"\n    },\n    \"uae\": {\n      \"price\": \"71,930\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.63%) 450\"\n      },\n      \"codes\": \"AED\",\n      \"symbol\": \"د.إ\"\n    },\n    \"iraqDinar\": {\n      \"price\": \"181\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.56%) 1\"\n      },\n      \"codes\": \"IQD\",\n      \"symbol\": \"د.ع\"\n    },\n    \"saudiArabiaRials\": {\n      \"price\": \"77,630\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.57%) 440\"\n      },\n      \"codes\": \"SAR\",\n      \"symbol\": \"﷼\"\n    },\n    \"qatarRials\": {\n      \"price\": \"74,100\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.82%) 600\"\n      },\n      \"codes\": \"QAR\",\n      \"symbol\": \"﷼\"\n    },\n    \"omanRials\": {\n      \"price\": \"695,200\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(0.89%) 6,100\"\n      },\n      \"codes\": \"OMR\",\n      \"symbol\": \"﷼\"\n    }\n  },\n  \"gold\": {\n    \"seke\": \"124,480,000\",\n    \"goldOns\": \"1,928.72\",\n    \"goldMesghal\": \"53,880,000\",\n    \"gold18\": \"12,425,000\"\n  },\n  \"oil\": {\n    \"oilBrent\": \"113.56\"\n  },\n  \"other\": {\n    \"iranstock\": \"1,418,611.5\",\n    \"bitcoin\": {\n      \"price\": \"47036.03\",\n      \"change\": {\n        \"type\": \"positive\",\n        \"change\": \"(4.88%)\"\n      },\n      \"codes\": \"BTC\",\n      \"symbol\": \"₿\"\n    }\n  }\n}\n\n```  \n\n## رفع مشکلات \nاز انجایی که این یک crawler است ممکن است با بوجود آمدن تعیرات در سایت اصلی این کتابخانه دچار مشکل شود بنابراین به محض مشاهده خطا \n[من](https://github.com/hamid)    رو از طریق ایجاد  [issue](https://github.com/hamid/dollar-tomans-api/issues/new)  مطلع کنید.\n\n## ارز های دیگر\nاین لیستی بود که من فکر میکردم مهم هست و اگر ارز دیگه ای میدونید مهم هست که اینجا باید باشه بگید تا اضافه کنم و یا خودتون هم به راحتی میتونید اضافه کنید😊\n\n## توجه\nتوجه داشته باشید که این کد درواقع یک crawler \nاز سایت tgju است و به صورت آزمایشی برای تحلیل قیمت دلار استفاده شده است بنابراین برای استفاده از این کتابخانه مجوز ها و موارد قانونی لازم را در نظر بگیرید.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamid%2Fdollar-tomans-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhamid%2Fdollar-tomans-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamid%2Fdollar-tomans-api/lists"}