{ "info": { "author": "Christoforou Manolis", "author_email": "emchristoforou@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3" ], "description": "# CoinGecko API wrapper\n[![PyPi Version](https://img.shields.io/pypi/v/pycoingecko.svg)](https://pypi.python.org/pypi/pycoingecko/)\n\nPython3 wrapper around the [CoinGecko](https://www.coingecko.com/) API (V3)\n\n### Installation\nPyPI\n```bash\npip install pycoingecko\n```\nor from source\n```bash\ngit clone https://github.com/man-c/pycoingecko.git\ncd pycoingecko\npython3 setup.py install\n```\n\n### Usage\n\n```python\nfrom pycoingecko import CoinGeckoAPI\ncg = CoinGeckoAPI()\n```\n\n### Examples\nThe required parameters for each endpoint are defined as required (mandatory) parameters for the coresponding functions.\n**Any optional parameters** can be also passed using same names, as defined in CoinGecko API doc (https://www.coingecko.com/api/docs/v3)\n\n*Lists are also supported as input for multiple-valued comma-separated parameters (e.g. see /simple/price usage examples).*\n\nUsage examples:\n```python\n# /simple/price endpoint with the required parameters\n>>> cg.get_price(ids='bitcoin', vs_currencies='usd')\n{'bitcoin': {'usd': 3462.04}}\n\n>>> cg.get_price(ids='bitcoin,litecoin,ethereum', vs_currencies='usd')\n# OR (lists can be used for multiple-valued arguments)\n>>> cg.get_price(ids=['bitcoin', 'litecoin', 'ethereum'], vs_currencies='usd')\n{'bitcoin': {'usd': 3461.27}, 'ethereum': {'usd': 106.92}, 'litecoin': {'usd': 32.72}}\n\n>>> cg.get_price(ids='bitcoin,litecoin,ethereum', vs_currencies='usd,eur')\n# OR (lists can be used for multiple-valued arguments)\n>>> cg.get_price(ids=['bitcoin', 'litecoin', 'ethereum'], vs_currencies=['usd', 'eur'])\n{'bitcoin': {'usd': 3459.39, 'eur': 3019.33}, 'ethereum': {'usd': 106.91, 'eur': 93.31}, 'litecoin': {'usd': 32.72, 'eur': 28.56}}\n\n# optional parameteres can be passed as defined in the API doc (https://www.coingecko.com/api/docs/v3)\n>>> cg.get_price(ids='bitcoin', vs_currencies='usd', include_market_cap='true', include_24hr_vol='true', include_24hr_change='true', include_last_updated_at='true')\n{'bitcoin': {'usd': 3458.74, 'usd_market_cap': 60574330199.29028, 'usd_24h_vol': 4182664683.6247883, 'usd_24h_change': 1.2295378479069035, 'last_updated_at': 1549071865}}\n```\n\n### API documentation\nhttps://www.coingecko.com/api/docs/v3\n\n### Endpoints included\n- ping\n - /ping (Check API server status)\n ```python \n cg.ping()\n ```\n- simple\n - /simple/price (Get the current price of any cryptocurrencies in any other supported currencies that you need)\n ```python \n cg.get_price()\n ```\n - /simple/token_price/{id} (Get current price of tokens (using contract addresses) for a given platform in any other currency that you need)\n ```python \n cg.get_token_price()\n ``` \n - /simple/supported_vs_currencies (Get list of supported_vs_currencies)\n ```python \n cg.get_supported_vs_currencies()\n ```\n- coins\n - /coins/list (List all supported coins id, name and symbol (no pagination required))\n ```python \n cg.get_coins_list()\n ```\n - /coins/markets (List all supported coins price, market cap, volume, and market related data (no pagination required))\n ```python \n cg.get_coins_markets()\n ```\n - /coins/{id} (Get current data (name, price, market, ... including exchange tickers) for a coin)\n ```python \n cg.get_coin_by_id()\n ```\n - /coins/{id}/tickers (Get coin tickers (paginated to 100 items))\n ```python \n cg.get_coin_ticker_by_id()\n ```\n - /coins/{id}/history (Get historical data (name, price, market, stats) at a given date for a coin)\n ```python \n cg.get_coin_history_by_id()\n ```\n - /coins/{id}/market_chart (Get historical market data include price, market cap, and 24h volume (granularity auto))\n ```python \n cg.get_coin_market_chart_by_id()\n ```\n - /coins/{id}/status_updates (Get status updates for a given coin (beta))\n ```python \n cg.get_coin_status_updates_by_id()\n ```\n - /coins/{id}/contract/{contract_address} (Get coin info from contract address)\n ```python \n cg.get_coin_info_from_contract_address_by_id()\n ```\n- exchanges (beta)\n - /exchanges (List all exchanges)\n ```python\n cg.get_exchanges_list()\n ```\n - /exchanges/list (List all supported markets id and name (no pagination required))\n ```python\n cg.get_exchanges_id_name_list()\n ```\n - /exchanges/{id} (Get exchange volume in BTC and top 100 tickers only)\n ```python\n cg.get_exchanges_by_id()\n ```\n - /exchanges/{id}/tickers (Get exchange tickers (paginated))\n ```python\n cg.get_exchanges_tickers_by_id()\n ```\n - /exchanges/{id}/status_updates (Get status updates for a given exchange (beta))\n ```python\n cg.get_exchanges_status_updates_by_id()\n ```\n - /exchanges/{id}/volume_chart (Get volume_chart data for a given exchange (beta))\n ```python\n cg.get_exchanges_volume_chart_by_id()\n ```\n- status_updates (beta)\n - /status_updates (List all status_updates with data (description, category, created_at, user, user_title and pin))\n ```python\n cg.get_status_updates()\n ```\n- events\n - /events (Get events, paginated by 100)\n ```python\n cg.get_events()\n ```\n - /events/countries (Get list of event countries)\n ```python\n cg.get_events_countries()\n ```\n - /events/types (Get list of events types)\n ```python\n cg.get_events_types()\n ```\n- exchange_rates\n - /exchange_rates (Get BTC-to-Currency exchange rates)\n ```python\n cg.get_exchange_rates()\n ```\n- global\n - /global (Get cryptocurrency global data)\n ```python\n cg.get_global()\n ```\n\n### Test\n\nRun unit tests with:\n\n```\n# after installing pytest using pip3\npytest tests\n```\n\n## License\n[MIT](https://choosealicense.com/licenses/mit/)", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/man-c/pycoingecko", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "pycoingecko", "package_url": "https://pypi.org/project/pycoingecko/", "platform": "", "project_url": "https://pypi.org/project/pycoingecko/", "project_urls": { "Homepage": "https://github.com/man-c/pycoingecko" }, "release_url": "https://pypi.org/project/pycoingecko/0.4.0/", "requires_dist": null, "requires_python": "", "summary": "Python wrapper around the CoinGecko API", "version": "0.4.0" }, "last_serial": 5702783, "releases": { "0.1.5": [ { "comment_text": "", "digests": { "md5": "de19d50b4a7dddfb2a9bb3e9a22d73db", "sha256": "354b9383da2381eb14ab449a85f851ddb1da10f2a3c69678eae9d7702971c67c" }, "downloads": -1, "filename": "pycoingecko-0.1.5-py3.7.egg", "has_sig": false, "md5_digest": "de19d50b4a7dddfb2a9bb3e9a22d73db", "packagetype": "bdist_egg", "python_version": "3.7", "requires_python": null, "size": 6967, "upload_time": "2019-01-10T14:03:37", "url": "https://files.pythonhosted.org/packages/9f/87/337c84367b2d5f6aa340ace40fd7dc3d65ec0f0b388576c5665f93c66842/pycoingecko-0.1.5-py3.7.egg" }, { "comment_text": "", "digests": { "md5": "06a5313633bac6c94dcc743cc574160c", "sha256": "a2b8ae722f7403fe5775e6aacf343a7a1c81b8370176a2eb1b767ce7b232f0bc" }, "downloads": -1, "filename": "pycoingecko-0.1.5-py3-none-any.whl", "has_sig": false, "md5_digest": "06a5313633bac6c94dcc743cc574160c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4774, "upload_time": "2019-01-10T14:03:35", "url": "https://files.pythonhosted.org/packages/5e/cc/502e35a5f221e25ad3d278c0ab7764a51856d12653138e360f68a8bd6574/pycoingecko-0.1.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "91e82c5013dc33642db0b9a4fb198cf4", "sha256": "e288b4af09842c9d9bf01fd3f4c96bc6e496b374c4a99e95c281f5daef6caeb1" }, "downloads": -1, "filename": "pycoingecko-0.1.5.tar.gz", "has_sig": false, "md5_digest": "91e82c5013dc33642db0b9a4fb198cf4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3243, "upload_time": "2019-01-10T14:03:38", "url": "https://files.pythonhosted.org/packages/d6/8e/3595f1471c4882952821d6a4900f626130d87db456d76a531c3b51f0c56d/pycoingecko-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "e2994aea7af07ef83d42123f735daa85", "sha256": "dadc718ac75b5c6d73f6d0087e14afe6705304f5b798b8c920cf62880636e204" }, "downloads": -1, "filename": "pycoingecko-0.1.6-py3-none-any.whl", "has_sig": false, "md5_digest": "e2994aea7af07ef83d42123f735daa85", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5496, "upload_time": "2019-02-02T02:43:07", "url": "https://files.pythonhosted.org/packages/d2/62/2defe8b10cf6004ef5cc477305b3fafd29134aaca64e18149cd9f51c44ae/pycoingecko-0.1.6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6d9d7004a02e96d07b160956f0a6966b", "sha256": "169786b4a3924ff5cbf6c7bfc6d68e080fc225e100aad0db55ec88b57ad8e9f9" }, "downloads": -1, "filename": "pycoingecko-0.1.6.tar.gz", "has_sig": false, "md5_digest": "6d9d7004a02e96d07b160956f0a6966b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4262, "upload_time": "2019-02-02T02:43:09", "url": "https://files.pythonhosted.org/packages/58/a6/90ea690fb42b98a6c53583c7fa41dee19f82440d3c79287bf8189b12f987/pycoingecko-0.1.6.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "40895d80fe437ba4c931d941d9f4b6cb", "sha256": "755229680d6f731e7c42d298e80f56d91b92704ee5864132871547209599bbb9" }, "downloads": -1, "filename": "pycoingecko-0.2.0.tar.gz", "has_sig": false, "md5_digest": "40895d80fe437ba4c931d941d9f4b6cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4412, "upload_time": "2019-05-16T22:14:13", "url": "https://files.pythonhosted.org/packages/ca/6b/ae76a496b3fcfa1bb87515d2ecc4b17d2452a84d38f822a50a8440076cd0/pycoingecko-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "dae5448897501731d8ed2a404c5cf9f4", "sha256": "9bd66e0ed3e53c11ddfb002c43fd73c8b31f1688cad8f530e8ad0845ae3050cf" }, "downloads": -1, "filename": "pycoingecko-0.3.0.tar.gz", "has_sig": false, "md5_digest": "dae5448897501731d8ed2a404c5cf9f4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4885, "upload_time": "2019-05-30T21:46:53", "url": "https://files.pythonhosted.org/packages/1a/48/02eecf16209677ca9cd0a5c787f7a29714d677499a82cd8ccff8a592c108/pycoingecko-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "06391518427196572705ed047ba19cab", "sha256": "5a7fede9321fc973ad44e14842201ff103167a4361714878c51ca1d6780d41fd" }, "downloads": -1, "filename": "pycoingecko-0.4.0.tar.gz", "has_sig": false, "md5_digest": "06391518427196572705ed047ba19cab", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4940, "upload_time": "2019-08-20T11:20:41", "url": "https://files.pythonhosted.org/packages/68/08/5bd66c5b2c16873faddb004f10fbd99b2474b6a363324c0f9d4971cb4dda/pycoingecko-0.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "06391518427196572705ed047ba19cab", "sha256": "5a7fede9321fc973ad44e14842201ff103167a4361714878c51ca1d6780d41fd" }, "downloads": -1, "filename": "pycoingecko-0.4.0.tar.gz", "has_sig": false, "md5_digest": "06391518427196572705ed047ba19cab", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4940, "upload_time": "2019-08-20T11:20:41", "url": "https://files.pythonhosted.org/packages/68/08/5bd66c5b2c16873faddb004f10fbd99b2474b6a363324c0f9d4971cb4dda/pycoingecko-0.4.0.tar.gz" } ] }