SharpAPI

SharpAPI Reference Data API

Sports, leagues, sportsbooks, markets, and teams

GitHub OpenAPI
Business capability
Sports, Betting & Fantasy AE-180.80

Operations 5

GET /sports List sports #
GET /leagues List leagues #
GET /sportsbooks List sportsbooks #
GET /markets List market types #
GET /teams List teams #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/sharpapi/openapi/sharpapi-reference-data-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/sharpapi/json-schema/sharpapi-odds-schema.json
📊
JSONSchema
https://artifacts.apis.io/sharpapi/json-schema/sharpapi-event-game-state-schema.json
📊
JSONSchema
https://artifacts.apis.io/sharpapi/json-schema/sharpapi-evopportunity-schema.json
📊
JSONSchema
https://artifacts.apis.io/sharpapi/json-schema/sharpapi-splits-game-schema.json
📊
JSONSchema
https://artifacts.apis.io/sharpapi/json-schema/sharpapi-store-readiness-schema.json
📊
JSONSchema
https://artifacts.apis.io/sharpapi/json-schema/sharpapi-middle-opportunity-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/sharpapi:sharpapi-reference-data-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

sharpapi-reference-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Sharp Reference Data API
  version: 3.28.0
  description: Real-time sports betting odds API with +EV detection, arbitrage, middles, and low-hold opportunities.
  contact:
    name: SharpAPI Support
    url: https://sharpapi.io
    email: support@sharpapi.io
  license:
    name: Proprietary
    url: https://sharpapi.io/terms
  x-generated-at: '2026-10-13T20:02:34Z'
  x-commit-sha: 850f5cb
servers:
- url: https://api.sharpapi.io/api/v1
  description: Production
security:
- ApiKeyHeader: []
- BearerAuth: []
tags:
- name: Reference Data
  description: Sports, leagues, sportsbooks, markets, and teams
paths:
  /sports:
    get:
      operationId: listSports
      summary: List sports
      description: Returns available sports with event and live counts. Public endpoint with optional API key for higher rate limits.
      tags:
      - Reference Data
      security:
      - ApiKeyHeader: []
      - BearerAuth: []
      - ApiKeyQuery: []
      parameters:
      - name: include_empty
        in: query
        description: Include sports with zero events
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: List of sports
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/DataEnvelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/Sport'
              example:
                success: true
                data:
                - id: basketball
                  name: Basketball
                  event_count: 42
                  live_count: 3
                  leagues:
                  - nba
                  - ncaab
                  - wnba
                - id: football
                  name: Football
                  event_count: 16
                  live_count: 0
                  leagues:
                  - nfl
                  - ncaaf
        '401':
          $ref: '#/components/responses/Unauthorized'
  /leagues:
    get:
      operationId: listLeagues
      summary: List leagues
      description: Returns available leagues with event counts. Optionally filter by sport.
      tags:
      - Reference Data
      security:
      - ApiKeyHeader: []
      - BearerAuth: []
      - ApiKeyQuery: []
      parameters:
      - name: sport
        in: query
        description: Filter by sport ID
        schema:
          type: string
        example: basketball
      - name: include_empty
        in: query
        description: Include leagues with zero events
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: List of leagues
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/DataEnvelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/League'
              example:
                success: true
                data:
                - id: nba
                  name: NBA
                  sport: basketball
                  event_count: 15
                  live_count: 2
                - id: ncaab
                  name: NCAAB
                  sport: basketball
                  event_count: 24
                  live_count: 1
        '401':
          $ref: '#/components/responses/Unauthorized'
  /sportsbooks:
    get:
      operationId: listSportsbooks
      summary: List sportsbooks
      description: Returns available sportsbooks with status, capabilities, and event counts. Use `catalog=true` for a config-based catalog that doesn't require live data.
      tags:
      - Reference Data
      security:
      - ApiKeyHeader: []
      - BearerAuth: []
      - ApiKeyQuery: []
      parameters:
      - name: region
        in: query
        description: Filter by region
        schema:
          type: string
          enum:
          - US
          - UK
          - EU
          - AU
          - GLOBAL
        example: US
      - name: sharp
        in: query
        description: Filter by sharp book status
        schema:
          type: boolean
      - name: catalog
        in: query
        description: Return config-based catalog (no Redis dependency)
        schema:
          type: boolean
          default: false
      - name: include_unlisted
        in: query
        description: Include unlisted sportsbooks
        schema:
          type: boolean
          default: false
      - name: include_inactive
        in: query
        description: Include inactive sportsbooks (zero events)
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: List of sportsbooks
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/DataEnvelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/Sportsbook'
              example:
                success: true
                data:
                - id: draftkings
                  name: draftkings
                  display_name: DraftKings
                  is_sharp: false
                  has_live_odds: true
                  has_player_props: true
                  has_limits: false
                  regions:
                  - US
                  requires_tier: free
                  status: active
                  event_count: 320
                  last_update: '2026-03-09T14:22:00Z'
                  unlisted: false
        '401':
          $ref: '#/components/responses/Unauthorized'
  /markets:
    get:
      operationId: listMarkets
      summary: List market types
      description: Returns available market types with descriptions, examples, and event counts.
      tags:
      - Reference Data
      security:
      - ApiKeyHeader: []
      - BearerAuth: []
      - ApiKeyQuery: []
      responses:
        '200':
          description: List of market types
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/DataEnvelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/Market'
              example:
                success: true
                data:
                - id: moneyline
                  name: Moneyline
                  description: Bet on which team will win the game outright
                  hasLine: false
                  examples:
                  - Lakers -150
                  - Celtics +130
                  event_count: 312
                  selection_count: 1840
                  sports:
                  - basketball
                  - football
                  - baseball
                  - hockey
        '401':
          $ref: '#/components/responses/Unauthorized'
  /teams:
    get:
      operationId: listTeams
      summary: List teams
      description: Returns teams aggregated from current odds snapshots.
      tags:
      - Reference Data
      security:
      - ApiKeyHeader: []
      - BearerAuth: []
      - ApiKeyQuery: []
      parameters:
      - name: sport
        in: query
        description: Filter by sport
        schema:
          type: string
      - name: league
        in: query
        description: Filter by league
        schema:
          type: string
      - name: q
        in: query
        description: Search team names (partial match)
        schema:
          type: string
      responses:
        '200':
          description: List of teams
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/DataEnvelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/Team'
              example:
                success: true
                data:
                - id: boston-celtics
                  name: Boston Celtics
                  sport: basketball
                  leagues:
                  - nba
                  aliases:
                  - Celtics
                  event_count: 3
                  live_count: 1
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    DataEnvelope:
      type: object
      description: Standard shape for non-paginated responses. Emitted by endpoints that return a single resource or a small fixed list. No `success` flag — HTTP status codes indicate success/failure.
      required:
      - data
      - updated_at
      properties:
        data: {}
        updated_at:
          type: string
          format: date-time
          description: Server emit time (RFC 3339).
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - missing_api_key
              - invalid_api_key
              - unauthorized
              - forbidden
              - tier_restricted
              - rate_limited
              - invalid_request
              - validation_error
              - not_found
              - streaming_not_available
              - stream_limit_exceeded
              - service_unavailable
              - internal_error
              description: Machine-readable error code
            message:
              type: string
              description: Human-readable error message
            docs:
              type: string
              format: uri
              description: Link to relevant documentation
            tier:
              type: string
              description: Current subscription tier
            required_tier:
              type: string
              description: Minimum tier required for this feature
            retry_after:
              type: integer
              description: Unix timestamp (ms) when request can be retried
            retryAfter:
              type: integer
              description: Seconds until the request can be retried — same instant as retry_after, different unit and casing
            max_books:
              type: integer
            requested_books:
              type: integer
    Team:
      type: object
      required:
      - id
      - name
      - sport
      - leagues
      - aliases
      - event_count
      - live_count
      properties:
        id:
          type: string
          example: boston-celtics
        name:
          type: string
          example: Boston Celtics
        sport:
          type: string
          example: basketball
        leagues:
          type: array
          items:
            type: string
        aliases:
          type: array
          items:
            type: string
        event_count:
          type: integer
        live_count:
          type: integer
    Sport:
      type: object
      required:
      - id
      - name
      - event_count
      - live_count
      - leagues
      properties:
        id:
          type: string
          example: basketball
        name:
          type: string
          example: Basketball
        event_count:
          type: integer
        live_count:
          type: integer
        leagues:
          type: array
          items:
            type: string
    Market:
      type: object
      required:
      - id
      - name
      - description
      - hasLine
      properties:
        id:
          type: string
          example: moneyline
        name:
          type: string
          example: Moneyline
        description:
          type: string
        hasLine:
          type: boolean
        examples:
          type: array
          items:
            type: string
        event_count:
          type:
          - integer
          - 'null'
        selection_count:
          type:
          - integer
          - 'null'
        sports:
          type: array
          items:
            type: string
    League:
      type: object
      required:
      - id
      - name
      - sport
      - event_count
      - live_count
      properties:
        id:
          type: string
          example: nba
        name:
          type: string
          example: NBA
        sport:
          type: string
          example: basketball
        event_count:
          type: integer
        live_count:
          type: integer
    Sportsbook:
      type: object
      required:
      - id
      - name
      - display_name
      - is_sharp
      - has_live_odds
      - has_player_props
      - has_limits
      - regions
      - requires_tier
      - status
      - event_count
      properties:
        id:
          type: string
          example: draftkings
        name:
          type: string
          example: draftkings
        display_name:
          type: string
          example: DraftKings
        is_sharp:
          type: boolean
        has_live_odds:
          type: boolean
        has_player_props:
          type: boolean
        has_limits:
          type:
          - boolean
          - 'null'
          description: Whether the book publishes per-selection bet limits (`max_bet` on odds rows). DERIVED from the book's currently-served snapshot on every recompute — not declared per book the way `has_live_odds` / `has_player_props` are. `true` = at least one row in the current snapshot carries `max_bet` (individual rows may still omit it); `false` = rows were observed and none carry it; `null` = no rows observed, so no claim is made (books not yet live and books with zero loaded rows). Key always present. Recomputed alongside `last_update` and inherits its staleness bound (worst case ~40s, typically <=15s). Added September 2026.
          example: false
        regions:
          type: array
          items:
            type: string
        requires_tier:
          type: string
          enum:
          - free
          - sharp
        status:
          type: string
          enum:
          - active
          - inactive
          - limited
        event_count:
          type: integer
        last_update:
          type:
          - string
          - 'null'
          format: date-time
        unlisted:
          type: boolean
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missing:
              summary: Missing API key
              value:
                error:
                  code: missing_api_key
                  message: API key required
                  docs: https://docs.sharpapi.io/en/authentication#authentication-methods
            invalid:
              summary: Invalid API key
              value:
                error:
                  code: invalid_api_key
                  message: Invalid API key
                  docs: https://docs.sharpapi.io/en/authentication#authentication-methods
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key passed in the `X-API-Key` header
    BearerAuth:
      type: http
      scheme: bearer
      description: API key passed as a Bearer token in the `Authorization` header
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key
      description: API key as query parameter (for SSE/EventSource only)