nba-stats-agent

Live NBA stats, scores, and player data via ESPN. Real-time game data, team rosters, league leaders, and matchup analysis for AI agents.

  • 6 Entrypoints
  • v1.0.0 Version
  • Enabled Payments
nba-stats-agent-production.up.railway.app
View Manifest List Entrypoints

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

overview

Invoke

Free NBA overview - today's games and league snapshot

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/overview/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://nba-stats-agent-production.up.railway.app/entrypoints/overview/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

scores

Invoke

Live NBA scores for today or specific date

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/scores/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "date": {
      "description": "Date in YYYYMMDD format (default: today)",
      "type": "string"
    }
  },
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://nba-stats-agent-production.up.railway.app/entrypoints/scores/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "date": "<Date in YYYYMMDD format (default: today)>"
      }
    }
  '

team

Invoke

Team profile with roster and recent games

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/team/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "Team abbreviation (LAL, BOS, GSW, etc.) or ESPN team ID"
    }
  },
  "required": [
    "team"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://nba-stats-agent-production.up.railway.app/entrypoints/team/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "team": "<Team abbreviation (LAL, BOS, GSW, etc.) or ESPN team ID>"
      }
    }
  '

leaders

Invoke

NBA league leaders by statistical category

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/leaders/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "category": {
      "default": "points",
      "type": "string",
      "enum": [
        "points",
        "rebounds",
        "assists",
        "steals",
        "blocks"
      ]
    },
    "limit": {
      "default": 10,
      "type": "number"
    }
  },
  "required": [
    "category",
    "limit"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://nba-stats-agent-production.up.railway.app/entrypoints/leaders/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "category": "points",
        "limit": 0
      }
    }
  '

player

Invoke

Full player profile with stats and career info

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/player/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "playerId": {
      "type": "string",
      "description": "ESPN player/athlete ID"
    }
  },
  "required": [
    "playerId"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://nba-stats-agent-production.up.railway.app/entrypoints/player/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "playerId": "<ESPN player/athlete ID>"
      }
    }
  '

matchup

Invoke

Full matchup preview comparing two teams

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/matchup/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "homeTeam": {
      "type": "string",
      "description": "Home team abbreviation or ID"
    },
    "awayTeam": {
      "type": "string",
      "description": "Away team abbreviation or ID"
    }
  },
  "required": [
    "homeTeam",
    "awayTeam"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://nba-stats-agent-production.up.railway.app/entrypoints/matchup/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "homeTeam": "<Home team abbreviation or ID>",
        "awayTeam": "<Away team abbreviation or ID>"
      }
    }
  '

Client Example: x402-fetch

Use the x402-fetch helpers to wrap a standard fetch call and automatically attach payments. This script loads configuration from .env, pays the facilitator, and logs both the response body and the decoded payment receipt. 

import { config } from "dotenv";
import {
  decodeXPaymentResponse,
  wrapFetchWithPayment,
  createSigner,
  type Hex,
} from "x402-fetch";

config();

const privateKey = process.env.AGENT_WALLET_PRIVATE_KEY as Hex | string;
const agentUrl = process.env.AGENT_URL as string; // e.g. https://agent.example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /entrypoints/echo/invoke
const url = `${agentUrl}${endpointPath}`;

if (!agentUrl || !privateKey || !endpointPath) {
  console.error("Missing required environment variables");
  console.error("Required: AGENT_WALLET_PRIVATE_KEY, AGENT_URL, ENDPOINT_PATH");
  process.exit(1);
}

/**
 * Demonstrates paying for a protected resource using x402-fetch.
 *
 * Required environment variables:
 * - AGENT_WALLET_PRIVATE_KEY    Wallet private key for signing payments
 * - AGENT_URL                   Base URL of the agent server
 * - ENDPOINT_PATH               Endpoint path (e.g. /entrypoints/echo/invoke)
 */
async function main(): Promise<void> {
  // const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
  const signer = await createSigner("base-sepolia", privateKey);
  const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

  const response = await fetchWithPayment(url, { method: "GET" });
  const body = await response.json();
  console.log(body);

  const paymentResponse = decodeXPaymentResponse(
    response.headers.get("x-payment-response")!
  );
  console.log(paymentResponse);
}

main().catch((error) => {
  console.error(error?.response?.data?.error ?? error);
  process.exit(1);
});

Manifest

Loading… 
Fetching agent card…