DripMetrics AI

DripMetrics AI Polymarket API

The Polymarket API from DripMetrics AI — 8 operation(s) for polymarket.

GitHub OpenAPI

Operations 8

GET /polymarket/vpin Compute Polymarket vpin #
GET /polymarket/kyle-lambda Compute Polymarket kyle-lambda #
GET /polymarket/flow-imbalance Compute Polymarket flow-imbalance #
GET /polymarket/two-sidedness Compute Polymarket two-sidedness #
GET /polymarket/wallet-concentration Compute Polymarket wallet-concentration #
GET /polymarket/wallet-novelty Compute Polymarket wallet-novelty #
GET /polymarket/probability-shock Compute Polymarket probability-shock #
GET /polymarket/leakage-score Compute Polymarket leakage-score #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dripmetrics-ai/openapi/dripmetrics-ai-polymarket-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/dripmetrics-ai/json-schema/dripmetrics-ai-aerodrome-amm-flow-impact-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dripmetrics-ai/json-schema/dripmetrics-ai-catalog-schema.json
📊
JSONSchema
https://artifacts.apis.io/dripmetrics-ai/json-schema/dripmetrics-ai-aerodrome-order-flow-concentration-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dripmetrics-ai/json-schema/dripmetrics-ai-aerodrome-active-pairs-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dripmetrics-ai/json-schema/dripmetrics-ai-aerodrome-trade-activity-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dripmetrics-ai/json-schema/dripmetrics-ai-hyperliquid-participant-concentration-result-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/dripmetrics-ai:dripmetrics-ai-polymarket-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

dripmetrics-ai-polymarket-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DripMetrics Polymarket API
  version: 1.0.0
  description: DripMetricsAI provides on-demand crypto market microstructure, risk, prediction-market, Hyperliquid, and on-chain metrics. Paid endpoints use x402 (USDC on Base or USDG on Robinhood Chain) and return structured JSON without subscriptions or API keys. Also available over MCP (Streamable HTTP) at https://mcp.dripmetrics.ai/mcp with free discovery tools.
  x-mcp: https://mcp.dripmetrics.ai/mcp
  x-guidance: 'Use /openapi.json for discovery. Routes with x-payment-info are x402-paid resources: first call the endpoint without PAYMENT-SIGNATURE to receive a 402 challenge, then retry with a valid x402 v2 PAYMENT-SIGNATURE. Routes with security: [] are public discovery or health routes and should not be probed for payment.'
  contact:
    email: drip@dripmetrics.ai
    url: https://dripmetrics.ai/
servers:
- url: https://api.dripmetrics.ai
tags:
- name: Polymarket
paths:
  /polymarket/vpin:
    get:
      operationId: getPolymarketVpin
      summary: Compute Polymarket vpin
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/kyle-lambda:
    get:
      operationId: getPolymarketKyleLambda
      summary: Compute Polymarket kyle-lambda
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: true
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/flow-imbalance:
    get:
      operationId: getPolymarketFlowImbalance
      summary: Compute Polymarket flow-imbalance
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/two-sidedness:
    get:
      operationId: getPolymarketTwoSidedness
      summary: Compute Polymarket two-sidedness
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/wallet-concentration:
    get:
      operationId: getPolymarketWalletConcentration
      summary: Compute Polymarket wallet-concentration
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/wallet-novelty:
    get:
      operationId: getPolymarketWalletNovelty
      summary: Compute Polymarket wallet-novelty
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/probability-shock:
    get:
      operationId: getPolymarketProbabilityShock
      summary: Compute Polymarket probability-shock
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: true
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
  /polymarket/leakage-score:
    get:
      operationId: getPolymarketLeakageScore
      summary: Compute Polymarket leakage-score
      description: Computes a prediction-market metric from public Polymarket data. Many markets require a slug and may also require conditionId or outcome identifiers.
      tags:
      - Polymarket
      parameters:
      - name: slug
        in: query
        required: false
        description: Polymarket market slug.
        schema:
          type: string
          example: fed-decision-in-october
      - name: conditionId
        in: query
        required: false
        description: Polymarket condition id.
        schema:
          type: string
      - name: tokenId
        in: query
        required: false
        description: Polymarket outcome token id.
        schema:
          type: string
      - name: assetId
        in: query
        required: false
        description: Alias for tokenId.
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        description: Outcome side.
        schema:
          type: string
          enum:
          - 'YES'
          - 'NO'
      - name: windowMinutes
        in: query
        required: false
        description: Lookback window in minutes.
        schema:
          type: integer
          minimum: 1
          default: 60
      - name: limit
        in: query
        required: false
        description: Maximum trades to sample.
        schema:
          type: integer
          minimum: 1
          maximum: 5000
          default: 500
      - name: startTs
        in: query
        required: false
        description: Optional unix timestamp lower bound.
        schema:
          type: integer
      - name: endTs
        in: query
        required: false
        description: Optional unix timestamp upper bound.
        schema:
          type: integer
      - name: lookbackMinutes
        in: query
        required: false
        description: Probability-shock lookback window.
        schema:
          type: integer
          minimum: 1
          default: 1440
      - name: newsTs
        in: query
        required: false
        description: Optional event/news unix timestamp for leakage-score.
        schema:
          type: integer
      security:
      - x402: []
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '0.05'
        protocols:
        - x402: {}
      x-dripmetrics-paid: true
      x-x402:
        priceUsd: '0.05'
        asset: USDC
        network: eip155:8453
        scheme: exact
        paymentOptions:
        - network: eip155:8453
          asset: USDC
          scheme: exact
        - network: eip155:4663
          asset: USDG
          scheme: exact
      responses:
        '200':
          description: Successful paid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolymarketMetricResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '422':
          $ref: '#/components/responses/MetricNotComputable'
        '503':
          $ref: '#/components/responses/UpstreamUnavailable'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        metric:
          type: string
        components:
          type: object
          additionalProperties: true
      required:
      - error
      additionalProperties: true
    PolymarketMetricResult:
      type: object
      properties:
        metric:
          type: string
          enum:
          - vpin
          - kyle-lambda
          - flow-imbalance
          - two-sidedness
          - wallet-concentration
          - wallet-novelty
          - probability-shock
          - leakage-score
        conditionId:
          type:
          - string
          - 'null'
        tokenId:
          type:
          - string
          - 'null'
        assetId:
          type:
          - string
          - 'null'
        slug:
          type:
          - string
          - 'null'
        outcome:
          type:
          - string
          - 'null'
        window:
          type: object
          additionalProperties: true
        value:
          type:
          - number
          - 'null'
        components:
          type: object
          additionalProperties: true
        sampleSize:
          type: object
          additionalProperties: true
        source:
          type: object
          additionalProperties: true
        computedAt:
          type: string
          format: date-time
      required:
      - metric
      - value
      - components
      - sampleSize
      - source
      - computedAt
      additionalProperties: true
  responses:
    UpstreamUnavailable:
      description: Upstream data source unavailable or insufficient.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    PaymentRequired:
      description: x402 payment required. Programmatic clients should read payment requirements and retry with a valid PAYMENT-SIGNATURE header.
      headers:
        PAYMENT-REQUIRED:
          description: Base64-encoded x402 v2 payment requirements.
          schema:
            type: string
        PAYMENT-RESPONSE:
          description: Base64-encoded x402 payment response after verification or settlement.
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
    MetricNotComputable:
      description: Metric could not be computed from available data.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    x402:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 v2 payment signature header supplied after reading the 402 PAYMENT-REQUIRED response.