ExchangeRebel Quote Registry 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: Quote Registry
paths:
  /toll/quote-registry:
    get:
      tags:
      - Quote Registry
      summary: Quote Registry service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what the registry is, the free phase-1 terms (listing + query free; pricing is an open item), the published criteria (quote-registry/v1), and the SELLER-ASSERTED label carried on every entry.'
      security: []
      operationId: getTollQuoteRegistry
      x-operation-id-source: derived
  /toll/quote-registry/health:
    get:
      tags:
      - Quote Registry
      summary: Quote Registry service health
      responses:
        '200':
          description: Success. Returns liveness and the report signer address.
      security: []
      operationId: getTollQuoteRegistryHealth
      x-operation-id-source: derived
  /toll/quote-registry/criteria:
    get:
      tags:
      - Quote Registry
      summary: The published quote-registry criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (quote-registry/v1), serialised from the engine''s own config: the listing fields, the per-field free validation reasons, duplicate handling (409 DUPLICATE-ENDPOINT), the query states (LISTED / NOT-LISTED), the caps, and the pinned public test corpus identity.'
      security: []
      operationId: getTollQuoteRegistryCriteria
      x-operation-id-source: derived
  /toll/quote-registry/corpus:
    get:
      tags:
      - Quote Registry
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity: corpus pin 7305671a3ec37d89fa8ccdd6a0d5aa41886cff3436582c49f8bc2b9b887a5228 (verifiable with the published harness).'
      security: []
      operationId: getTollQuoteRegistryCorpus
      x-operation-id-source: derived
  /toll/quote-registry/metrics:
    get:
      tags:
      - Quote Registry
      summary: Quote Registry aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (listings total). Aggregate only.
      security: []
      operationId: getTollQuoteRegistryMetrics
      x-operation-id-source: derived
  /toll/quote-registry/list:
    post:
      tags:
      - Quote Registry
      summary: List your own endpoint + terms (free, SELLER-ASSERTED)
      responses:
        '200':
          description: 'Created. Returns the signed listing receipt (201): listing id, the recorded terms exactly as submitted, and the SELLER-ASSERTED label. A second listing for the same normalized endpoint_url + method is refused free as DUPLICATE-ENDPOINT (409) naming the existing listing_id. Per-field validation fails free with named reasons.'
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                seller_key:
                  type: string
                  description: 'Seller identifier (the listing key; per-key caps apply: 100/day, 1s minimum interval).'
                endpoint_url:
                  type: string
                  description: The endpoint being listed (http/https, no embedded credentials). Validated only — never fetched.
                method:
                  type: string
                  description: HTTP method of the listed endpoint.
                price_amount:
                  type: string
                price_asset:
                  type: string
                price_network:
                  type: string
                delivery_time_statement:
                  type: string
                description:
                  type: string
                contact:
                  type: string
              required:
              - seller_key
              - endpoint_url
              - method
              - price_amount
              - price_asset
              - price_network
              - delivery_time_statement
      operationId: postTollQuoteRegistryList
      x-operation-id-source: derived
  /toll/quote-registry/query:
    post:
      tags:
      - Quote Registry
      summary: Query terms per endpoint (free)
      responses:
        '200':
          description: 'Success. Returns the signed query answer: LISTED with the originally listed terms (label SELLER-ASSERTED), or NOT-LISTED — a stated absence for an unknown endpoint, never an error dressed as data.'
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                endpoint_url:
                  type: string
                method:
                  type: string
              required:
              - endpoint_url
      operationId: postTollQuoteRegistryQuery
      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.'