ExchangeRebel True Cost 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: True Cost
paths:
  /toll/true-cost:
    get:
      tags:
      - True Cost
      summary: True Cost service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a true-cost quote includes, the price ($0.01 per quote), the published criteria (payer-preflight/v1, op true-cost) and its fee-model table, the pinned test corpus, and the scope statement (a deterministic all-in cost computation from the published fee model; no composite score).'
      security: []
      operationId: getTollTrueCost
      x-operation-id-source: derived
  /toll/true-cost/health:
    get:
      tags:
      - True Cost
      summary: True Cost service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollTrueCostHealth
      x-operation-id-source: derived
  /toll/true-cost/criteria:
    get:
      tags:
      - True Cost
      summary: The published true-cost criteria and fee model
      responses:
        '200':
          description: 'Success. Returns the full published criteria (payer-preflight/v1, op true-cost): the per-facilitator fee model with its source and vintage, and the pinned public test corpus identity; every quote is reproducible from them.'
      security: []
      operationId: getTollTrueCostCriteria
      x-operation-id-source: derived
  /toll/true-cost/corpus:
    get:
      tags:
      - True Cost
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for true-cost quotes: corpus id true-cost-corpus/v1 and its SHA-256 pin f4e5760c987581bd37160880ec340d6e1c99769c6cb134ada19933f9a1364c06 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollTrueCostCorpus
      x-operation-id-source: derived
  /toll/true-cost/precheck:
    post:
      tags:
      - True Cost
      summary: Free headline pre-check of one true-cost quote request
      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).
                quote:
                  type: object
                  description: 'The quote request: seller_price_micro, facilitator, scheme, and the facilitator''s position inputs where its fee model needs them (e.g. cdp_monthly_tx_position for CDP past the free tier).'
              required:
              - caller
              - quote
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the quote request is complete for the published fee model. No fee figures are returned. A malformed submission is refused free. When the caller''s free allowance is exhausted, the response is the /toll/true-cost payment challenge instead.'
      security: []
      operationId: postTollTrueCostPrecheck
      x-operation-id-source: derived
  /toll/true-cost/quote:
    post:
      tags:
      - True Cost
      summary: Full signed true-cost quote for one submitted price + facilitator + scheme
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                quote:
                  type: object
                  description: 'The quote request: seller_price_micro, facilitator, scheme, and the facilitator''s position inputs where its fee model needs them (e.g. cdp_monthly_tx_position for CDP past the free tier).'
              required:
              - quote
      responses:
        '200':
          description: 'Success. Returns the full signed report: every fee leg computed from the published fee model, the all-in total, the fee model''s source and vintage, and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per quote - each submitted quote is charged at $0.01; the payment includes one true-cost quote for the price + facilitator + scheme you submit — the seller price leg, the facilitator fee leg computed under the facilitator''s published fee model exactly as printed in the criteria (source and vintage date printed on every quote), and the per-leg count for batch/upto schemes — returned as one signed report with all legs printed. Where the facilitator''s published model is a daily-refreshed rate (PayAI), the quote reports the model, not a live number, and computes no total. Where no published model is on record for the facilitator, the quote returns MODEL-NOT-PUBLISHED and computes no fee and no total. A free pre-check validates the submission''s shape before any payment and returns no fee and no total. The submitted quote request is processed in memory only and is never stored; the payments ledger records only the payer, the time, the price, the facilitator, the scheme, the fee status, and the verdict line. 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 quote) and a fresh memo. 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: postTollTrueCostQuote
      x-operation-id-source: derived
  /toll/true-cost/metrics:
    get:
      tags:
      - True Cost
      summary: True Cost aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid quotes, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted prices.
      security: []
      operationId: getTollTrueCostMetrics
      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.'