@bigballsdata/sdk

Official TypeScript SDK for the Big Ball Sports API.

Install

npm install @bigballsdata/sdk

Quick start

import { BigBallSportsClient } from '@bigballsdata/sdk';

const client = new BigBallSportsClient('bbs_your_api_key');

const today = await client.matches.list({ sport: 'football', date: '2026-04-17' });
console.log(today.data);

const live = await client.matches.get('m-123', ['scores', 'odds', 'lineups']);
console.log(live.data.scores, live.data.odds);

WebSocket subscriptions

import { io } from 'socket.io-client';

const unsubscribe = client.subscribe(
  'match:m-123',
  (event) => console.log(event.type, event.data),
  { socketIo: io },
);

// later:
unsubscribe();

Zero runtime dependencies. socket.io-client is required only if you use subscribe() — pass it in via { socketIo: io }.