gadgethumans-com Prediction Odds API

openapi: 3.2.0
info:
  title: Gadgethumans Com Prediction Odds API
  version: 1.1.0
  contact:
    name: GadgetHumans
    email: gadgethumans@agentmail.to
  x-guidance: 'Pay-per-call utility API for agents. Every GET route below takes its listed query parameters (first is required) and returns JSON; POST /swish/v1/chat/completions takes an OpenAI-style JSON body (messages[]). Unauthenticated calls receive HTTP 402 with an x402 challenge in the body (v2, accepts[] carries two entries) and the Payment-Required header: pay the accepted USDC amount either on Base (eip155:8453) to its payTo, or on Solana mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, USDC) to its payTo, then retry with the X-PAYMENT header carrying the base64 payment payload. MCP clients can instead install https://api.gadgethumans.com/mcp (49 tools). Route index and per-route parameters are in paths[] below.'
  description: 'Operations tagged Prediction Odds across 2 of this provider''s published API definitions: gadgethumans-com-openapi.json, gadgethumans-com-openapi2.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.gadgethumans.com
tags:
- name: Prediction Odds
paths:
  /prediction-odds:
    get:
      summary: Fetch prediction-market odds for every matching event
      description: 'Prediction-market odds - Send a topic or event name (?q=...) and get live prediction-market odds for every matching market: implied probability, decimal odds, best bid and ask, spread, book liquidity, 24h and 1-week volume, days to resolution, and a deterministic 0-100 edge score with named flags.'
      parameters:
      - name: q
        in: query
        required: true
        description: Event or topic in the venue's own wording, e.g. 'Fed rate decision'
        schema:
          type: string
          description: Event or topic in the venue's own wording, e.g. 'Fed rate decision' (required)
      - name: limit
        in: query
        required: false
        description: Max markets (1-10, default 5)
        schema:
          type: integer
          description: Max markets (1-10, default 5) (optional)
      x-price: $0.010
      x-payment-protocol: x402
      x-payment-info:
        protocols:
        - x402: {}
        - mpp:
            method: evm
            intent: charge
            currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        payTo: '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        offers:
        - method: evm
          intent: charge
          amount: '10000'
          currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          chainId: 8453
          payTo: '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'
          description: USDC on Base
        - method: x402
          intent: charge
          amount: '10000'
          currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          chainId: 8453
          payTo: '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'
          description: USDC on Base
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: x402 exact scheme, USDC on Base'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      tags:
      - Prediction Odds
      operationId: getPredictionOdds
      x-operation-id-source: derived
    servers:
    - url: https://api.gadgethumans.com
x-refined-from:
- gadgethumans-com-openapi.json
- gadgethumans-com-openapi2.json
x-discovery:
  ownershipProofs:
  - '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'