Fetching Snapshots

API Endpoints: Use https://txline.txodds.com/api/ for mainnet or https://txline-dev.txodds.com/api/ for devnet

Prerequisites: Complete Quickstart activation first. The snippets assume jwt is the guest JWT from /auth/guest/start and apiToken is the value returned by /api/token/activate. For a fixture outside your subscription bundle, book the fixture first, or scores and odds requests return 403.

Fetch Fixtures Snapshot

Get all fixtures for a specific competition or all competitions.

Participant1IsHome is the feed’s home/away designation for mapping Participant1 and Participant2; it is not a venue guarantee. For neutral competitions, Participant1IsHome: true means Participant1 is listed as the home side for feed purposes, even if the match is not played in that team’s country.

Fixture payloads include GameState in a backward-compatible format. Current values are 1 for scheduled fixtures and 6 for cancelled fixtures.

import axios from "axios";

const httpClient = axios.create({
  timeout: 30000,
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${jwt}`,
    "X-Api-Token": apiToken
  },
  baseURL: "https://txline.txodds.com",
});

// Get fixtures for specific competition
const fixturesResponse = await httpClient.get("/api/fixtures/snapshot", {
  params: {
    competitionId: 500005, // NCAA Division I FBS
  },
});
const fixtures = fixturesResponse.data;

console.log(`Retrieved ${fixtures.length} fixtures`);
fixtures.slice(0, 3).forEach((fixture, index) => {
  const homeTeam = fixture.Participant1IsHome
    ? fixture.Participant1
    : fixture.Participant2;
  const awayTeam = fixture.Participant1IsHome
    ? fixture.Participant2
    : fixture.Participant1;

  console.log(`${index + 1}. ${homeTeam} vs ${awayTeam}`);
  console.log(`   ID: ${fixture.FixtureId}, Start: ${new Date(fixture.StartTime).toISOString()}`);
  console.log(`   GameState: ${fixture.GameState ?? fixture.gameState}`);
});

// Get all fixtures
const allFixturesResponse = await httpClient.get("/api/fixtures/snapshot");
const allFixtures = allFixturesResponse.data;

console.log(`Retrieved ${allFixtures.length} total fixtures`);

Time Period Parameters

The updates endpoints return the records published in one period, identified by path parameters. All three are in UTC.

Parameter	Range	Meaning
`epochDay`	`0` and up	Whole days since 1 January 1970 UTC: `Math.floor(timestampMs / 86_400_000)`. See Epoch Day.
`hourOfDay`	`0`–`23`	The UTC hour within that day.
`interval`	`0`–`11`	The 5-minute slot within that hour: `Math.floor(utcMinutes / 5)`. Odds and scores only.

Odds and scores are published every 5 minutes, so their paths take all three: /api/odds/updates/{epochDay}/{hourOfDay}/{interval} and /api/scores/updates/{epochDay}/{hourOfDay}/{interval}. Fixtures are published hourly, so /api/fixtures/updates/{epochDay}/{hourOfDay} has no interval. Compute all three from one timestamp so they describe the same period:

function periodOf(timestampMs: number) {
  const date = new Date(timestampMs);
  return {
    epochDay: Math.floor(timestampMs / 86_400_000),
    hourOfDay: date.getUTCHours(),
    interval: Math.floor(date.getUTCMinutes() / 5),
  };
}

periodOf(Date.UTC(2026, 10, 1, 15, 20)); // 1 Nov 2026 15:20 UTC -> { epochDay: 20758, hourOfDay: 15, interval: 4 }

Fetch Odds Snapshot

Get odds data for a specific fixture or time period.

const fixtureId = 17271370;

// Get odds for specific fixture
const fixtureOddsResponse = await httpClient.get(
  `/api/odds/snapshot/${fixtureId}`
);
const fixtureOdds = fixtureOddsResponse.data;

console.log(`Retrieved ${fixtureOdds.length} odds entries`);

// Get odds published between 15:20 and 15:25 UTC on 1 November 2026
const { epochDay, hourOfDay, interval } = periodOf(Date.UTC(2026, 10, 1, 15, 20));

const updatesResponse = await httpClient.get(
  `/api/odds/updates/${epochDay}/${hourOfDay}/${interval}`
);
const updates = updatesResponse.data;

console.log(`Retrieved ${updates.length} odds updates`);

Fetch Scores Snapshot

Get scores data for a specific fixture or time period.

const fixtureId = 17271370;

// Get scores snapshot for fixture
const snapshotScoresResponse = await httpClient.get(
  `/api/scores/snapshot/${fixtureId}`
);
const snapshotScores = snapshotScoresResponse.data;

console.log(`Retrieved ${snapshotScores.length} snapshot scores entries`);

// Get live scores updates
const liveScoresResponse = await httpClient.get(
  `/api/scores/updates/${fixtureId}`
);
const liveScores = liveScoresResponse.data;

console.log(`Retrieved ${liveScores.length} live scores updates`);

// Get scores published between 15:20 and 15:25 UTC on 1 November 2026
const { epochDay, hourOfDay, interval } = periodOf(Date.UTC(2026, 10, 1, 15, 20));

const historicalUpdatesResponse = await httpClient.get(
  `/api/scores/updates/${epochDay}/${hourOfDay}/${interval}`
);
const historicalUpdates = historicalUpdatesResponse.data;

console.log(`Retrieved ${historicalUpdates.length} historical scores updates`);

Getting started

Odds

Scores

Solana Programs

Examples

Legal

Fetch Fixtures Snapshot

Time Period Parameters

Fetch Odds Snapshot

Fetch Scores Snapshot

​Fetch Fixtures Snapshot

​Time Period Parameters

​Fetch Odds Snapshot

​Fetch Scores Snapshot

Fetch Fixtures Snapshot

Time Period Parameters

Fetch Odds Snapshot

Fetch Scores Snapshot