Skip to main content

Documentation Index

Fetch the complete documentation index at: https://txline-docs.txodds.com/llms.txt

Use this file to discover all available pages before exploring further.

Start Building with Free World Cup Data

Experience the power of TxLINE’s real-time sports data API with our complimentary free tier. Get instant access to EPL and World Cup data with no payment required, no credit card needed, and no commitment.

What’s Included

EPL + World Cup Data

Complete access to English Premier League and World Cup matches with 60-second delay.

Historical Replay

Full access to historical data for past matches and events analysis.

On-Chain Verification

Cryptographically verifiable data with Solana blockchain anchoring.

Production Ready

Same reliable infrastructure as our premium tiers with comprehensive documentation.
Perfect For: Developers building proof-of-concepts, hobbyist projects, learning platforms, or testing TxLINE before upgrading to real-time data.

Getting Started

Step 1: Set Up Your Solana Wallet

You’ll need a Solana wallet to subscribe. If you don’t have one:
npm install @solana/web3.js @coral-xyz/anchor
import * as anchor from "@coral-xyz/anchor";
import { Connection, Keypair } from "@solana/web3.js";

// Set up your connection
const connection = new Connection("https://api.mainnet-beta.solana.com");
const provider = new anchor.AnchorProvider(
  connection,
  wallet,
  { commitment: "confirmed" }
);

Step 2: Subscribe to Free Tier

Subscribe to service level ID 0 for free access. No TxL tokens required!
import * as anchor from "@coral-xyz/anchor";
import { TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID } from "@solana/spl-token";
import { SystemProgram } from "@solana/web3.js";

// Free tier configuration
const SERVICE_LEVEL_ID = 0; // Free tier: EPL + World Cup
const DURATION_WEEKS = 1; // Subscribe for 1 week at a time
const SELECTED_LEAGUES: number[] = []; // Empty for standard bundle

// Subscribe on-chain
const txSig = await program.methods
  .subscribe(SERVICE_LEVEL_ID, DURATION_WEEKS)
  .accounts({
    user: provider.wallet.publicKey,
    pricingMatrix: pricingMatrixPda,
    tokenMint: SUBSCRIPTION_TOKEN_MINT,
    userTokenAccount: userTokenAccount.address,
    tokenTreasuryVault,
    tokenTreasuryPda,
    tokenProgram: TOKEN_2022_PROGRAM_ID,
    associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
    systemProgram: SystemProgram.programId,
  })
  .rpc();

console.log("Subscription transaction:", txSig);
No Payment Required: Since this is the free tier (ID 0), you won’t be charged any TxL tokens. The transaction simply registers your subscription on-chain.

Step 3: Activate Your API Access

After subscribing on-chain, activate your API token by signing and calling our activation endpoint.
import axios from "axios";
import nacl from "tweetnacl";

// Get guest authentication token
const authResponse = await axios.post(
  "https://txline.txodds.com/auth/guest/start"
);
const jwt = authResponse.data.token;

// Create message to sign
const messageString = `${txSig}:${SELECTED_LEAGUES.join(",")}:${jwt}`;
const message = new TextEncoder().encode(messageString);

// Sign with your wallet
const signatureBytes = nacl.sign.detached(
  message,
  provider.wallet.payer!.secretKey
);
const walletSignature = Buffer.from(signatureBytes).toString("base64");

// Activate your API access
const activationResponse = await axios.post(
  "https://txline.txodds.com/api/token/activate",
  {
    txSig,
    walletSignature,
    leagues: SELECTED_LEAGUES,
  },
  {
    headers: { Authorization: `Bearer ${jwt}` }
  }
);

// Save your API token
const apiToken = activationResponse.data.token || activationResponse.data;
console.log("API Token activated successfully!");

Step 4: Make Your First API Call

You’re all set! Start fetching World Cup and EPL data using your API token. Check out the complete API Reference for all available endpoints including:
  • Live Matches - Get real-time match data and scores
  • League Standings - Access current league tables and rankings
  • Historical Data - Replay past matches and events
  • Player Statistics - Detailed player performance metrics
  • Match Events - Goals, cards, substitutions, and more
All endpoints require the Authorization: Bearer ${apiToken} header for authentication.

Ready for More?

Love the free tier? Upgrade to unlock:

Real-Time Data

Zero delay live data for time-sensitive applications

100+ Leagues

Access to all major leagues worldwide

Custom Leagues

Choose exactly which leagues you need
View our Subscription Tiers to see all available options. Paid tiers start from just 125,000 TxL ($125) per week.

Frequently Asked Questions

Yes, free tier subscriptions are valid for 1 week at a time. Simply re-subscribe when your access expires. There’s no cost to renew.
Absolutely! You can upgrade at any time by subscribing to a paid tier. Your new subscription will take effect immediately.
No rate limits on API calls. However, data has a 60-second delay compared to premium real-time tiers.
Your API access will expire after the subscription period ends. You can re-subscribe at any time to regain access.
Yes! The free tier can be used for commercial projects. However, for production applications, we recommend upgrading to real-time data for the best user experience.

Ready to start? Follow the steps above to get your free API access in under 5 minutes. No credit card required.