ExchangeRebel Composite Inventory 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: Composite Inventory
paths:
  /toll/composite-inventory:
    get:
      tags:
      - Composite Inventory
      summary: Composite Inventory service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: The cleared-sources composite inventory (composite-inventory/v1, Q-15): submit one topic and receive one answer section per requested leg — Anthropic Economic Index (CC-BY), OpenAI Signals (CC BY 4.0), WildChat aggregates (ODC-BY), Radar web-graph material only (CC BY 4.0), Glama display leg only under its credit/link conditions — each section carrying its provider, class H1, licence, attribution, freshness and load state. Legs are NEVER merged; there is no composite score and no merged ranking. Agent-issued search data (class A1) does not exist anywhere: the composite carries that absence statement wherever it is shown, and an A1 question returns it. Radar API data (CC BY-NC) is barred — never a leg, never loaded, never served. A leg whose data is not loaded grades NOT-LOADED.'
      security: []
      operationId: getTollCompositeInventory
      x-operation-id-source: derived
  /toll/composite-inventory/health:
    get:
      tags:
      - Composite Inventory
      summary: Composite Inventory service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollCompositeInventoryHealth
      x-operation-id-source: derived
  /toll/composite-inventory/criteria:
    get:
      tags:
      - Composite Inventory
      summary: The published composite-inventory/v1 criteria
      responses:
        '200':
          description: Success. Returns the full published criteria (composite-inventory/v1) with the pinned public test corpus (SHA-256 b0f23ef7076f926ecf37814efa37e4242f9933ba554558eb8792bbefd94e60be); every paid answer is reproducible from them. The price is $0.01 per lookup (ruled 2026-11-03).
      security: []
      operationId: getTollCompositeInventoryCriteria
      x-operation-id-source: derived
  /toll/composite-inventory/corpus:
    get:
      tags:
      - Composite Inventory
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity: its SHA-256 pin b0f23ef7076f926ecf37814efa37e4242f9933ba554558eb8792bbefd94e60be (the SHA-256 of the corpus''s canonical serialization). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollCompositeInventoryCorpus
      x-operation-id-source: derived
  /toll/composite-inventory/precheck:
    post:
      tags:
      - Composite Inventory
      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).
                topic:
                  type: string
                  description: The topic to look up in each requested leg.
                legs:
                  type: array
                  items:
                    type: string
                  description: Leg ids to include; defaults to all cleared legs.
                question_class:
                  type: string
                  description: Optional question class for the lookup.
              required:
              - caller
              - topic
      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: postTollCompositeInventoryPrecheck
      x-operation-id-source: derived
  /toll/composite-inventory/lookup:
    post:
      tags:
      - Composite Inventory
      summary: One lookup ($0.01)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                topic:
                  type: string
                  description: The topic to look up in each requested leg.
                legs:
                  type: array
                  items:
                    type: string
                  description: Leg ids to include; defaults to all cleared legs.
                question_class:
                  type: string
                  description: Optional question class for the lookup.
              required:
              - topic
      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.01 per lookup - the payment includes: Your payment includes one composite lookup for the topic you submit: one answer section per requested leg (provider, class H1, licence, attribution, that leg''s freshness, and its load state printed on every section), the matching entries from each loaded leg, the per-leg factors, and the A1 absence statement. Legs are never merged and no composite score or merged ranking is included. It does not include any agent-issued search-query data (class A1 — none is published by anyone), any Radar API data (barred, CC BY-NC), any verbatim WildChat prompts, or retention of your submitted topic (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 (10000 USDC units = $0.01 per lookup) and a fresh memo (prefix ci-lookup-). 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.01'
      security:
      - x402Payment: []
      operationId: postTollCompositeInventoryLookup
      x-operation-id-source: derived
  /toll/composite-inventory/metrics:
    get:
      tags:
      - Composite Inventory
      summary: Composite Inventory 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: getTollCompositeInventoryMetrics
      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.'