ExchangeRebel Demand Verdict API

openapi: 3.2.0
info:
  title: ExchangeRebel — pay-per-call APIs for AI agents (x402 on…
  version: 1.0.0
  contact:
    name: 'ExchangeRebel (operator: Rebel Data)'
    url: https://exchangerebel.com
    email: sound.money.investing@gmail.com
  x-guidance: 'All paid operations use x402 on Solana: call without payment to get a 402 challenge (SOL recipient + USDC token account + fresh memo), pay with the memo attached via the Solana Memo program, then retry with header X-Payment-Tx: <signature> and ?toll_memo=<memo>. Challenges are dual-version: the PAYMENT-REQUIRED header carries the x402 v2 PaymentRequired object and the response body carries the same challenge in x402 v1 form for compatibility. Free operations (security: []) include each service''s /health catalog with full response shapes. Prices in x-payment-info are USD per call unless the summary says otherwise (RPC is per 1,000-request block; Telegram provisioning is per bot-month; transcription is per minute of audio).'
  description: '67 data and utility APIs behind x402 tolls, settled in SOL or USDC on Solana. Call a paid endpoint without payment to receive a 402 x402 challenge (recipient + fresh memo), pay with the memo attached via the Solana Memo program, then retry with the X-Payment-Tx header and toll_memo query parameter. Free catalog/health endpoints are marked without x-payment-info. Full catalogs: GET /toll/discovery and each service''s /health.'
servers:
- url: https://exchangerebel.com
tags:
- name: Demand Verdict
paths:
  /toll/demand-verdict:
    get:
      tags:
      - Demand Verdict
      summary: Demand Verdict service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: Demand Verdict for Builders (demand-verdict/v1, Q-35): submit one tool/service description and receive a per-request mechanical verdict — one labelled demand claim per requested H1 leg (Anthropic Economic Index CC-BY, OpenAI Signals CC BY 4.0, WildChat aggregates ODC-BY, via the M-12 composite assembly''s leg shapes and leg-load seam): ASKED-FOR, NOT-ASKED-FOR (stated as absence in that leg only, never absence in the world), or NOT-ASSESSABLE when the leg is not loaded — plus the served-leg grade against the stated supply (our own fleet listings + our own firsthand probe results + Glama only in its §15 credit/link display form): ALREADY-SERVED, NOT-SERVED (against the stated supply only), or NOT-ASSESSABLE. The MCP Registry compilation is EXCLUDED from the served leg (terms unclear). ShareChat and Radar API data (CC BY-NC) are barred in any form and never used. Claim ceiling, printed on every verdict: H1 only; at A1 (agent-issued queries) this verdict can claim nothing — the A1 absence statement is part of every answer. Factors printed; no composite score.'
      security: []
      operationId: getTollDemandVerdict
      x-operation-id-source: derived
  /toll/demand-verdict/health:
    get:
      tags:
      - Demand Verdict
      summary: Demand Verdict service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollDemandVerdictHealth
      x-operation-id-source: derived
  /toll/demand-verdict/criteria:
    get:
      tags:
      - Demand Verdict
      summary: The published demand-verdict/v1 criteria
      responses:
        '200':
          description: Success. Returns the full published criteria (demand-verdict/v1) with the pinned public test corpus (SHA-256 8fa2a2d903f7279cd0189b640badf84101aa2c72da148d9ecbbc13a32d7e6f0b); every paid answer is reproducible from them. The price is $0.02 per verdict (ruled 2026-11-03).
      security: []
      operationId: getTollDemandVerdictCriteria
      x-operation-id-source: derived
  /toll/demand-verdict/corpus:
    get:
      tags:
      - Demand Verdict
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity: its SHA-256 pin 8fa2a2d903f7279cd0189b640badf84101aa2c72da148d9ecbbc13a32d7e6f0b (the SHA-256 of the corpus''s canonical serialization). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollDemandVerdictCorpus
      x-operation-id-source: derived
  /toll/demand-verdict/precheck:
    post:
      tags:
      - Demand Verdict
      summary: 'Free pre-check: input validation and the full load-state / assessability…'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                caller:
                  type: string
                  description: Solana base58 wallet of the operator; keys the free allowance (100/day per wallet).
                description:
                  type: string
                  description: The tool or service description to assess demand for.
                legs:
                  type: array
                  items:
                    type: string
                  description: H1 leg ids to include; defaults to all cleared legs.
                question_class:
                  type: string
                  description: Optional question class for the verdict.
              required:
              - caller
              - description
      responses:
        '200':
          description: Success. Returns validation plus the per-leg load states and answerability disclosure, before any payment. No answer entries are produced. When the caller's free allowance is exhausted, the response is the payment challenge instead.
      security: []
      operationId: postTollDemandVerdictPrecheck
      x-operation-id-source: derived
  /toll/demand-verdict/verdict:
    post:
      tags:
      - Demand Verdict
      summary: One verdict ($0.02)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                description:
                  type: string
                  description: The tool or service description to assess demand for.
                legs:
                  type: array
                  items:
                    type: string
                  description: H1 leg ids to include; defaults to all cleared legs.
                question_class:
                  type: string
                  description: Optional question class for the verdict.
              required:
              - description
      responses:
        '200':
          description: Success. Returns the signed paid answer described in the payment-inclusion statement.
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.02 per verdict - the payment includes: Your payment includes one demand verdict for the tool or service description you submit: one labelled demand claim per requested H1 leg (provider, class H1, licence, attribution, that leg''s data-date, and its grade — ASKED-FOR, NOT-ASKED-FOR stated as absence in that leg only, or NOT-ASSESSABLE when the leg is not loaded), the served-leg grade against the stated supply (ALREADY-SERVED with each matching supply record labelled, NOT-SERVED against the stated supply only, or NOT-ASSESSABLE), the printed claim ceiling (H1 only; at A1 this verdict can claim nothing), the A1 absence statement, and the per-leg factors. No composite score is included. It does not include any agent-issued search-query data (class A1 — none is published by anyone), any claim sourced from ShareChat or Radar API data (barred, CC BY-NC), any MCP Registry compilation data (terms unclear — excluded), or retention of your submitted description (it is discarded; only its hash is kept). The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (20000 USDC units = $0.02 per verdict) and a fresh memo (prefix dv-verdict-). Pay in USDC on Solana with the memo attached via the Solana Memo program, then resubmit the same request with the payment transaction in the X-Payment-Tx header and ?toll_memo=<memo>, re-sending the request body. The PAYMENT-REQUIRED response header carries the same object in x402 v2 form.'
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
      security:
      - x402Payment: []
      operationId: postTollDemandVerdictVerdict
      x-operation-id-source: derived
  /toll/demand-verdict/metrics:
    get:
      tags:
      - Demand Verdict
      summary: Demand Verdict aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid calls, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted content.
      security: []
      operationId: getTollDemandVerdictMetrics
      x-operation-id-source: derived
components:
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: X-Payment-Tx
      description: 'x402 toll payment proof: the Solana transaction signature of a payment carrying the memo from the 402 challenge; send together with ?toll_memo=<memo>. Payment itself is made on-chain in SOL or USDC to the recipient named in the challenge.'