eloedge-com API

openapi: 3.1.0
info:
  title: eloedge-com API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 29 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; eloedge-com has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 25
    pages-with-code: 3
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://eloedge.com/mcp.md
  - https://eloedge.com/data.md
  - https://eloedge.com/docs/agent
paths:
  /api/mcp/mcp:
    get:
      operationId: get_api_mcp_mcp
      tags:
      - Api
      summary: MCP server endpoint for tools.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_mcp_mcp
      tags:
      - Api
      summary: POST /api/mcp/mcp
      x-source: https://eloedge.com/mcp.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMcpMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s https://eloedge.com/api/mcp/mcp -H "Authorization: Bearer ek_your_key"  -H "Content-Type: application/json" -H "Accept:
          application/json, text/event-stream"  -d ''{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crypto15m_windows","arguments":{}}}''

          ```'
  /api/v1/catalysts:
    get:
      operationId: get_api_v1_catalysts
      tags:
      - Api
      summary: Catalysts data.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CatalystsResponse'
      x-evidence:
        kind: documentation
  /api/v1/commodity15m/health:
    get:
      operationId: get_api_v1_commodity15m_health
      tags:
      - Api
      summary: Health status of the commodity 15‑minute producer.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1Commodity15MHealthResponse'
      x-evidence:
        kind: documentation
  /api/v1/commodity15m/history:
    get:
      operationId: get_api_v1_commodity15m_history
      tags:
      - Api
      summary: Historical commodity 15‑minute data (heavy call).
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor.
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum results per page.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1Commodity15MHistoryResponse'
      x-evidence:
        kind: documentation
  /api/v1/commodity15m/windows:
    get:
      operationId: get_api_v1_commodity15m_windows
      tags:
      - Api
      summary: Running and next 15‑minute windows for commodity books.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
        description: Filter by commodity asset.
      - name: book
        in: query
        required: false
        schema:
          type: string
        description: Commodity book identifier.
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated tickers.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1Commodity15MWindowsResponse'
      x-evidence:
        kind: documentation
  /api/v1/coverage:
    get:
      operationId: get_api_v1_coverage
      tags:
      - Api
      summary: market_coverage lists every book served now.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CoverageResponse'
      x-evidence:
        kind: documentation
  /api/v1/daily-updown:
    get:
      operationId: get_api_v1_daily_updown
      tags:
      - Api
      summary: Equity daily up/down data.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1DailyUpdownResponse'
      x-evidence:
        kind: documentation
  /api/v1/data:
    get:
      operationId: get_api_v1_data
      tags:
      - Api
      summary: 'EloEdge data reference: the historical store'
      x-source: https://eloedge.com/data.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/data/{id}:
    get:
      operationId: get_api_v1_data_id
      tags:
      - Api
      summary: 'EloEdge data reference: the historical store'
      x-source: https://eloedge.com/data.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: sample
        in: query
        required: false
        schema:
          type: boolean
        description: optional, default true
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/data/{id}/files/{name}:
    get:
      operationId: get_api_v1_data_id_files_name
      tags:
      - Api
      summary: 'EloEdge data reference: the historical store'
      x-source: https://eloedge.com/data.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/data/{id}/query:
    post:
      operationId: post_api_v1_data_id_query
      tags:
      - Api
      summary: 'EloEdge data reference: the historical store'
      x-source: https://eloedge.com/data.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1DataIdQueryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/event-contracts:
    get:
      operationId: get_api_v1_event_contracts
      tags:
      - Api
      summary: List of event contracts across all sections and underlyings.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: section
        in: query
        required: false
        schema:
          type: string
        description: Filter by section.
      - name: underlying
        in: query
        required: false
        schema:
          type: string
        description: Filter by underlying asset.
      - name: series
        in: query
        required: false
        schema:
          type: string
        description: Filter by series.
      - name: event_ticker
        in: query
        required: false
        schema:
          type: string
        description: Filter by event ticker.
      - name: interval
        in: query
        required: false
        schema:
          type: string
        description: Filter by interval.
      - name: numbers_only
        in: query
        required: false
        schema:
          type: string
        description: If true, only contracts with numbers are returned.
      - name: validated_only
        in: query
        required: false
        schema:
          type: string
        description: If true, only validated contracts are returned.
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated tickers to filter.
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of contracts.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1EventContractsResponse'
      x-evidence:
        kind: documentation
  /api/v1/health:
    get:
      operationId: get_api_v1_health
      tags:
      - Api
      summary: Health status of the crypto 15‑minute producer.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1HealthResponse'
      x-evidence:
        kind: documentation
  /api/v1/history:
    get:
      operationId: get_api_v1_history
      tags:
      - Api
      summary: Crypto 15‑minute history (heavy call, costs 5 units).
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor (`next_before`).
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of results per page.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1HistoryResponse'
      x-evidence:
        kind: documentation
  /api/v1/ladder:
    get:
      operationId: get_api_v1_ladder
      tags:
      - Api
      summary: GET /api/v1/ladder
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
      - name: cadence
        in: query
        required: false
        schema:
          type: string
      - name: near
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "Authorization: Bearer ek_your_key" "https://eloedge.com/api/v1/ladder?asset=BTC&cadence=hourly&near=5"

          ```'
  /api/v1/model-p-at:
    get:
      operationId: get_api_v1_model_p_at
      tags:
      - Api
      summary: The model probability in force at a specific second for a crypto 15‑minute market.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: ticker
        in: query
        required: true
        schema:
          type: string
        description: Kalshi or Polymarket US ticker.
      - name: at
        in: query
        required: true
        schema:
          type: string
        description: ISO‑8601 timestamp or epoch seconds.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ModelPAtResponse'
      x-evidence:
        kind: documentation
  /api/v1/outliers:
    get:
      operationId: get_api_v1_outliers
      tags:
      - Api
      summary: Outliers list (Pro only).
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OutliersResponse'
      x-evidence:
        kind: documentation
  /api/v1/outliers/markets:
    get:
      operationId: get_api_v1_outliers_markets
      tags:
      - Api
      summary: Outlier markets list (Pro only).
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OutliersMarketsResponse'
      x-evidence:
        kind: documentation
  /api/v1/outliers/revisions:
    get:
      operationId: get_api_v1_outliers_revisions
      tags:
      - Api
      summary: Outlier revisions (Pro only).
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OutliersRevisionsResponse'
      x-evidence:
        kind: documentation
  /api/v1/outliers/scorecard:
    get:
      operationId: get_api_v1_outliers_scorecard
      tags:
      - Api
      summary: Outlier scorecard (Pro only).
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OutliersScorecardResponse'
      x-evidence:
        kind: documentation
  /api/v1/outliers/wallets:
    get:
      operationId: get_api_v1_outliers_wallets
      tags:
      - Api
      summary: Outlier wallets list (Pro only).
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OutliersWalletsResponse'
      x-evidence:
        kind: documentation
  /api/v1/polymarket/crypto/hourly:
    get:
      operationId: get_api_v1_polymarket_crypto_hourly
      tags:
      - Api
      summary: Polymarket US's own hourly crypto markets that no Kalshi contract matches.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
        description: One of BTC, ETH, SOL, XRP.
      - name: close
        in: query
        required: false
        schema:
          type: string
        description: ISO‑8601 hour close time.
      - name: book
        in: query
        required: false
        schema:
          type: string
        description: '`above`, `range` or `updown`.'
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated Polymarket US tickers.
      - name: numbers_only
        in: query
        required: false
        schema:
          type: string
        description: If true, drops contracts with no number.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1PolymarketCryptoHourlyResponse'
      x-evidence:
        kind: documentation
  /api/v1/polymarket/crypto5m/history:
    get:
      operationId: get_api_v1_polymarket_crypto5m_history
      tags:
      - Api
      summary: The REST‑only route for recorded five‑minute results (currently returns 503 unavailable).
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1PolymarketCrypto5MHistoryResponse'
      x-evidence:
        kind: documentation
  /api/v1/polymarket/crypto5m/windows:
    get:
      operationId: get_api_v1_polymarket_crypto5m_windows
      tags:
      - Api
      summary: Polymarket US five‑minute BTC, ETH, SOL and XRP windows whose model is approved for publication.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
        description: One published coin to filter the windows.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1PolymarketCrypto5MWindowsResponse'
      x-evidence:
        kind: documentation
  /api/v1/stream:
    get:
      operationId: get_api_v1_stream
      tags:
      - Api
      summary: Live push stream of 15‑minute windows.
      x-source: https://eloedge.com/mcp.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/windows:
    get:
      operationId: get_api_v1_windows
      tags:
      - Api
      summary: Open 15‑minute windows of the crypto assets.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
        description: Filter by asset code.
      - name: close
        in: query
        required: false
        schema:
          type: string
        description: ISO‑8601 closing time to fetch a specific window.
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated tickers to filter.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1WindowsResponse'
      x-evidence:
        kind: documentation
  /v1/markets/{polymarketUsTicker}/book:
    get:
      operationId: get_v1_markets_polymarketUsTicker_book
      tags:
      - Markets
      summary: Polymarket US market book.
      x-source: https://eloedge.com/mcp.md
      parameters:
      - name: polymarketUsTicker
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1MarketsPolymarketustickerBookResponse'
      x-evidence:
        kind: documentation
  /v1/orders:
    post:
      operationId: post_v1_orders
      tags:
      - Orders
      summary: Place an order on Polymarket US.
      x-source: https://eloedge.com/mcp.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1OrdersRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1OrdersResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiMcpMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            name:
              type: string
            arguments:
              type: object
    GetApiV1CatalystsResponse:
      type: object
      properties:
        now:
          type: string
        window:
          type: object
        filters:
          type: object
        coverage:
          type: object
        producer:
          type: object
        events:
          type: array
    GetApiV1Commodity15MHealthResponse:
      type: object
      properties:
        now:
          type: string
          description: Current server time.
        assets:
          type: array
          description: List of commodity assets.
        producer:
          type: object
          description: Producer health metrics.
        producer.status:
          type: string
          description: Producer status (live, stale, idle, unavailable).
        producer.price_age_sec:
          type: number
          description: Age of the latest price.
    GetApiV1Commodity15MHistoryResponse:
      type: object
      properties:
        results:
          type: array
          description: Historical result objects.
        results[].market:
          type: object
          description: Market metadata.
        results[].model_p_at:
          type: object
          description: Model probabilities at various seconds.
        next_before:
          type: string
          description: Cursor for next page.
    GetApiV1Commodity15MWindowsResponse:
      type: object
      properties:
        windows:
          type: array
          description: Array of commodity window objects.
        windows[].market:
          type: object
          description: Market metadata.
        windows[].model_p:
          type: number
          description: Probability of YES; null if no number.
        windows[].status:
          type: string
          description: Status of the window.
        windows[].age_sec:
          type: number
          description: Age of the model reading.
    GetApiV1CoverageResponse:
      type: object
      properties:
        now:
          type: string
        producer:
          type: object
        filters:
          type: object
        counts:
          type: object
        columns:
          type: array
        reasons:
          type: array
        rows:
          type: array
    GetApiV1DailyUpdownResponse:
      type: object
      properties:
        now:
          type: string
        assets:
          type: array
        marks:
          type: array
        books:
          type: array
    PostApiV1DataIdQueryRequest:
      type: object
      properties:
        columns:
          type: array
          description: list of column names
        where:
          type: string
          description: filter expression
        order_by:
          type: string
          description: ordering
        limit:
          type: integer
          description: max rows (≤5000, default 1000)
        offset:
          type: integer
        count:
          type: boolean
        sql:
          type: string
          description: SQL query
    GetApiV1EventContractsResponse:
      type: object
      properties:
        now:
          type: string
          description: Current server time.
        producer:
          type: object
          description: Producer health metrics.
        matching:
          type: object
          description: Matched events and contracts.
        books:
          type: array
          description: List of books when no filters are given.
        events:
          type: array
          description: List of events when filters are given.
    GetApiV1HealthResponse:
      type: object
      properties:
        now:
          type: string
          description: Current server time.
        assets:
          type: array
          description: List of asset codes.
        producer:
          type: object
          description: Producer health metrics.
        producer.price_age_sec:
          type: number
          description: Age of the latest price.
        producer.model_age_sec:
          type: number
          description: Age of the latest model reading.
    GetApiV1HistoryResponse:
      type: object
      properties:
        results:
          type: array
          description: Historical result objects.
        results[].market:
          type: object
          description: Market metadata.
        results[].result:
          type: string
          description: Result of the market.
        results[].model_p_at:
          type: object
          description: Model probabilities at various seconds.
        next_before:
          type: string
          description: Cursor for the next page.
    GetApiV1ModelPAtResponse:
      type: object
      properties:
        ticker:
          type: string
          description: Echoed request ticker.
        status:
          type: string
          description: Result status (ok, pending, no_reading, etc.).
        model_p:
          type: number
          description: Model probability if status is ok.
        model_ts:
          type: string
          description: Timestamp when the model reading was computed.
        reason:
          type: string
          description: Reason when status is not ok.
    GetApiV1OutliersResponse:
      type: object
      properties:
        source:
          type: string
        cycle:
          type: object
        counts:
          type: object
        outliers:
          type: array
        next_before:
          type: string
    GetApiV1OutliersMarketsResponse:
      type: object
      properties:
        source:
          type: string
        cycle:
          type: object
        markets:
          type: array
        next_offset:
          type: string
    GetApiV1OutliersRevisionsResponse:
      type: object
      properties:
        source:
          type: string
        cycle:
          type: object
        revisions:
          type: array
    GetApiV1OutliersScorecardResponse:
      type: object
      properties:
        source:
          type: string
        cycle:
          type: object
        days:
          type: array
        since:
          type: string
        rows:
          type: array
        first_unknown:
          type: object
        strategy:
          type: object
    GetApiV1OutliersWalletsResponse:
      type: object
      properties:
        source:
          type: string
        cycle:
          type: object
        board:
          type: object
        wallets:
          type: array
    GetApiV1PolymarketCryptoHourlyResponse:
      type: object
      properties:
        windows:
          type: array
          description: Array of hourly window objects.
        windows[].market:
          type: object
          description: Market metadata.
        windows[].model_p:
          type: number
          description: Probability that the market settles YES.
        windows[].status:
          type: string
          description: Status (ok, held, stale, upcoming, closed, unavailable).
        windows[].reason:
          type: string
          description: Reason for non‑ok status.
    GetApiV1PolymarketCrypto5MHistoryResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message when the route is unavailable.
    GetApiV1PolymarketCrypto5MWindowsResponse:
      type: object
      properties:
        windows:
          type: array
          description: Array of window objects.
        windows[].market:
          type: object
          description: Market metadata.
        windows[].market.venue:
          type: string
          description: Venue name (Polymarket US).
        windows[].market.series:
          type: string
          description: Series identifier.
        windows[].market.ticker:
          type: string
          description: Polymarket US ticker.
        windows[].market.strike:
          type: string
          description: Exact decimal string, null until opening target is known.
        windows[].market.opens_at:
          type: string
          description: ISO‑8601 opening time.
        windows[].market.closes_at:
          type: string
          description: ISO‑8601 closing time.
        windows[].model_p:
          type: number
          description: Probability that the market settles YES.
        windows[].status:
          type: string
          description: Status of the window (e.g., open, upcoming, unscored).
        windows[].age_sec:
          type: number
          description: Age of the model reading in seconds.
    GetApiV1WindowsResponse:
      type: object
      properties:
        windows:
          type: array
          description: Array of 15‑minute window rows.
        windows[].market:
          type: object
          description: Market metadata.
        windows[].model_p:
          type: number
          description: Probability of YES; null if no number.
        windows[].status:
          type: string
          description: State of the window (open, upcoming, unscored, etc.).
        windows[].age_sec:
          type: number
          description: Age of the model reading.
    GetV1MarketsPolymarketustickerBookResponse:
      type: object
      properties:
        book:
          type: object
    PostV1OrdersRequest:
      type: object
      properties:
        marketSlug:
          type: string
        order_intent:
          type: string
        side:
          type: string
      required:
      - marketSlug
      - order_intent
      - side
    PostV1OrdersResponse:
      type: object
      properties:
        orderId:
          type: string
        status:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Markets
- name: Orders