odds-api-io

Odds-API.io Node.js SDK

Official Node.js SDK for Odds-API.io - Real-time sports betting odds from 250+ bookmakers.

Features

• 🏀 20+ Sports - Basketball, football, tennis, and more
• 📊 Comprehensive Odds Data - Real-time odds from 250+ bookmakers
• 💰 Arbitrage Detection - Find risk-free betting opportunities
• 📈 Value Bets - Identify positive expected value bets
• 🔴 Live Events - Track in-play events and odds
• 🔍 Advanced Search - Search events, participants, and leagues
• ⚡ TypeScript First - Full type safety with TypeScript
• 📦 Dual Package - Works with both ESM and CommonJS
• 🛡️ Error Handling - Custom error classes for better debugging

Installation

npm install odds-api-io

Get Your API Key

Visit odds-api.io/#pricing to get your API key.

Quick Start

TypeScript

import { OddsAPIClient } from 'odds-api-io';

const client = new OddsAPIClient({
  apiKey: 'your-api-key-here'
});

// Get all available sports
const sports = await client.getSports();
console.log(`Found ${sports.length} sports`);

// Get upcoming NBA events
const events = await client.getEvents({
  sport: 'basketball',
  league: 'usa-nba'
});

// Search for specific games
const lakersGames = await client.searchEvents('Lakers');

// Get live events
const liveEvents = await client.getLiveEvents('basketball');

JavaScript (CommonJS)

const { OddsAPIClient } = require('odds-api-io');

const client = new OddsAPIClient({
  apiKey: 'your-api-key-here'
});

async function getOdds() {
  const events = await client.getEvents({
    sport: 'basketball',
    league: 'usa-nba'
  });
  
  const odds = await client.getEventOdds({
    eventId: events[0].id,
    bookmakers: 'singbet,bet365'
  });
  
  console.log(odds);
}

getOdds();

JavaScript (ESM)

import { OddsAPIClient } from 'odds-api-io';

const client = new OddsAPIClient({
  apiKey: 'your-api-key-here'
});

const sports = await client.getSports();

Examples

Finding Arbitrage Opportunities

import { OddsAPIClient } from 'odds-api-io';

const client = new OddsAPIClient({ apiKey: 'your-api-key' });

const arbs = await client.getArbitrageBets({
  bookmakers: 'singbet,bet365',
  limit: 10,
  includeEventDetails: true
});

arbs.forEach(arb => {
  console.log(`Profit: ${arb.profitPercentage}%`);
  console.log('Legs:', arb.legs);
});

Tracking Odds Movements

// Get odds for a specific event
const odds = await client.getEventOdds({
  eventId: '62924717',
  bookmakers: 'singbet,bet365'
});

// Track how odds change over time
const movements = await client.getOddsMovement({
  eventId: '62924717',
  bookmaker: 'singbet',
  market: 'moneyline'
});

Getting Value Bets

// Find value betting opportunities
const valueBets = await client.getValueBets({
  bookmaker: 'singbet',
  includeEventDetails: true
});

valueBets.forEach(bet => {
  console.log(`Value: ${bet.valuePercentage}%`);
  console.log(`Odds: ${bet.odds} (Fair: ${bet.fairOdds})`);
});

Working with Participants

// Search for teams/players
const warriors = await client.getParticipants({
  sport: 'basketball',
  search: 'Warriors'
});

// Get participant details by ID
const participant = await client.getParticipantById(3428);

Managing Bookmakers

// Get all available bookmakers
const bookmakers = await client.getBookmakers();

// Select specific bookmakers for your account
await client.selectBookmakers('singbet,bet365');

// Check which bookmakers you've selected
const selected = await client.getSelectedBookmakers();

// Clear selected bookmakers
await client.clearSelectedBookmakers();

API Reference

Sports & Leagues

Method	Description	Docs
getSports()	Get all available sports	Docs
getLeagues(sport)	Get leagues for a sport	Docs

Events

Method	Description	Docs
getEvents(params)	Get events with filters	Docs
getEventById(eventId)	Get specific event details	Docs
getLiveEvents(sport)	Get currently live events	Docs
searchEvents(query)	Search for events by keyword	Docs

Historical

Method	Description	Docs
getHistoricalEvents(params)	Get finished historical events in a date range	Docs
getHistoricalOdds(params)	Get closing odds for a historical event	Docs

Odds

Method	Description	Docs
getEventOdds(params)	Get odds for an event	Docs
getOddsMovement(params)	Track odds changes	Docs
getOddsForMultipleEvents(params)	Get odds for multiple events	Docs
getUpdatedOddsSince(params)	Get odds updated since timestamp	Docs

Participants

Method	Description	Docs
getParticipants(params)	Get participants/teams	Docs
getParticipantById(id)	Get participant by ID	Docs

Bookmakers

Method	Description	Docs
getBookmakers()	Get all available bookmakers	Docs
getSelectedBookmakers()	Get your selected bookmakers	Docs
selectBookmakers(bookmakers)	Select bookmakers for your account	Docs
clearSelectedBookmakers()	Clear bookmaker selection	Docs

Betting Analysis

Method	Description	Docs
getArbitrageBets(params)	Find arbitrage opportunities	Docs
getValueBets(params)	Find value bets	Docs

Error Handling

The SDK includes custom error classes for better error handling:

import {
  OddsAPIClient,
  OddsAPIError,
  InvalidAPIKeyError,
  RateLimitExceededError,
  NotFoundError,
  TimeoutError,
  NetworkError
} from 'odds-api-io';

const client = new OddsAPIClient({ apiKey: 'your-api-key' });

try {
  const events = await client.getEvents({ sport: 'basketball' });
} catch (error) {
  if (error instanceof InvalidAPIKeyError) {
    console.error('Your API key is invalid');
  } else if (error instanceof RateLimitExceededError) {
    console.error('Rate limit exceeded - wait before retrying');
  } else if (error instanceof NotFoundError) {
    console.error('Resource not found');
  } else if (error instanceof TimeoutError) {
    console.error('Request timeout');
  } else if (error instanceof NetworkError) {
    console.error('Network error');
  } else if (error instanceof OddsAPIError) {
    console.error('API error:', error.message);
  }
}

Configuration

const client = new OddsAPIClient({
  apiKey: 'your-api-key',
  baseUrl: 'https://api2.odds-api.io/v3', // Optional, default shown
  timeout: 10000 // Optional, default 10 seconds
});

TypeScript Support

This SDK is written in TypeScript and includes complete type definitions:

import type {
  Sport,
  League,
  Event,
  HistoricalEvent,
  Participant,
  Bookmaker,
  EventOdds,
  HistoricalEventOdds,
  ArbitrageBet,
  ValueBet,
  GetEventsParams,
  GetHistoricalEventsParams,
  GetHistoricalOddsParams
} from 'odds-api-io';

Free Tier Limitations

The free API tier has some restrictions:

• Limited bookmakers - Only 2 bookmakers can be selected at once
• Rate limits - Check the API documentation for current limits
• No WebSocket - Free tier uses HTTP requests only

Upgrade your plan for full access.

Resources

• 📘 API Documentation
• 🌐 Odds-API.io Website
• 💳 Get Your API Key
• 🐛 Report Issues

Examples Directory

Check the examples/ directory for more comprehensive examples:

• basic-usage.ts / basic-usage.js - Getting started
• arbitrage-betting.ts - Finding arbitrage opportunities
• odds-tracking.ts - Monitoring odds movements

License

MIT © Odds-API.io

Disclaimer

This is the official SDK for Odds-API.io. This tool is for informational purposes only and should not be used as the sole basis for betting decisions.

Built with ❤️ for the sports betting and analytics community