{"id":20283064,"url":"https://github.com/sarartur/oddsapi","last_synced_at":"2025-04-11T08:21:00.352Z","repository":{"id":50166574,"uuid":"273417051","full_name":"sarartur/oddsapi","owner":"sarartur","description":"Python wrapper around The Odds-Api","archived":false,"fork":false,"pushed_at":"2023-07-20T15:16:43.000Z","size":41,"stargazers_count":13,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-25T05:51:18.355Z","etag":null,"topics":["api-client","api-wrapper","odds-api","python","python-wrapper","sports"],"latest_commit_sha":null,"homepage":"","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/sarartur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-06-19T06:05:28.000Z","updated_at":"2024-11-21T12:51:24.000Z","dependencies_parsed_at":"2022-09-10T12:51:50.278Z","dependency_job_id":"5b459166-0cbf-4cb4-b944-e18bce9f103d","html_url":"https://github.com/sarartur/oddsapi","commit_stats":{"total_commits":15,"total_committers":1,"mean_commits":15.0,"dds":0.0,"last_synced_commit":"e5e8274b1cc37ce4b04023be11c66c60dcc61eca"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarartur%2Foddsapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarartur%2Foddsapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarartur%2Foddsapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarartur%2Foddsapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sarartur","download_url":"https://codeload.github.com/sarartur/oddsapi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248360883,"owners_count":21090778,"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-client","api-wrapper","odds-api","python","python-wrapper","sports"],"created_at":"2024-11-14T14:13:00.073Z","updated_at":"2025-04-11T08:21:00.328Z","avatar_url":"https://github.com/sarartur.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://img.shields.io/github/issues/sarartur/oddsapi\"\u003e  \u003cimg src=\"https://img.shields.io/github/forks/sarartur/oddsapi\"\u003e   \u003cimg src=\"https://img.shields.io/github/stars/sarartur/oddsapi\"\u003e   \u003cimg src=\"https://img.shields.io/github/license/sarartur/oddsapi\"\u003e\n# The Odds-Api\n### Installation\nThe package requires Python 3.7 or higher.\nInstall latest version from PyPI: `pip install oddsapi`\n### Description\nThe Odds-API provides sports odds data for loads of sports from bookmakers around the world. Get your free API key [here](https://the-odds-api.com/).\n### Usage\nPlease refer to [documentation](https://the-odds-api.com/liveapi/guides/v3/) for detailed instructions for The Odds-Api.\n\nTo start using the wrapper import and initialize the `OddsApiClient` from the package. \n``` python\nfrom oddsapi import OddsApiClient\n\nclient = OddsApiClient(api_key='YOUR KEY')\nresponse = client.retrieve_sports()\n```\nThe response is a custom object that stores the data in nested namespaces and dictionary format.\n```python\nresponse.data[0]\n\n\u003e\u003e\u003e Collection(active=True, \n        details='US College Football', \n        group='American Football', \n        has_outrights=False, \n        key='americanfootball_ncaaf', \n        title='NCAAF')\n\n#alternatively\nresponse.json['data'][0]\n\u003e\u003e\u003e {'key': 'americanfootball_ncaaf', \n        'active': True, \n        'group': 'American Football', \n        'details': 'US College Football', \n        'title': 'NCAAF', \n        'has_outrights': False}\n\nresponse.rate_info\n\u003e\u003e\u003e {'requests_remaining': '479', 'requests_used': '21'}\n```\nThe client can also be configured to work with `asyncio`.\n\n```python\nfrom asyncio import gather\n\nclient.aio = True\ncors = [client.retrieve_odds(\n    sport_key=sport.key,\n    region='us',\n    mkt='spreads'\n) for sport in response.data[:4]] \nresponses = client.loop.run_until_complete(gather(*cors))\n```\nKeep in mind that `rate_info` will not be recorded in order.\n### Contact\nEmail me at sarartur.ruk@gmail.com or open a new [Issue](https://github.com/sarartur/oddsapi/issues) on Github.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsarartur%2Foddsapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsarartur%2Foddsapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsarartur%2Foddsapi/lists"}