ExchangeRebel Failure Translator 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: Failure Translator
paths:
  /toll/failure-translator:
    get:
      tags:
      - Failure Translator
      summary: Failure Translator service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a failure translation includes, the price ($0.01 per failed-call outcome), the published criteria (failure-translation/v1, family payer-preflight/v1), the pinned test corpus, and the scope statement (a deterministic translation of the outcome artefacts you submit; no composite score; nothing is fetched).'
      security: []
      operationId: getTollFailureTranslator
      x-operation-id-source: derived
  /toll/failure-translator/health:
    get:
      tags:
      - Failure Translator
      summary: Failure Translator service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollFailureTranslatorHealth
      x-operation-id-source: derived
  /toll/failure-translator/criteria:
    get:
      tags:
      - Failure Translator
      summary: The published failure translation criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (failure-translation/v1): the published mapping table from outcome artefacts to reason class and retry verdict, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollFailureTranslatorCriteria
      x-operation-id-source: derived
  /toll/failure-translator/corpus:
    get:
      tags:
      - Failure Translator
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for the failure translator: corpus id failure-translation-corpus/v1 and its SHA-256 pin 95d16014bc6cd234294e2ab2cc28ad5138c2e591c4c28646ee59c1ed4482d7cc (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollFailureTranslatorCorpus
      x-operation-id-source: derived
  /toll/failure-translator/precheck:
    post:
      tags:
      - Failure Translator
      summary: Free headline pre-check of one submitted failed-call outcome
      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).
                outcome:
                  type: object
                  description: 'The outcome artefacts of one failed paid call: {http_status?, settle_attempted?, facilitator_error?, response_headers?, reissued_challenge?, original_payload?} in the published submission form. Processed in memory only, never stored.'
              required:
              - caller
              - outcome
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the outcome artefacts are translatable. No reason class and no retry verdict is returned. A malformed submission is refused free. When the caller''s free allowance is exhausted, the response is the /toll/failure-translator/translate payment challenge instead.'
      security: []
      operationId: postTollFailureTranslatorPrecheck
      x-operation-id-source: derived
  /toll/failure-translator/translate:
    post:
      tags:
      - Failure Translator
      summary: Full signed failure translation of one failed-call outcome
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                outcome:
                  type: object
                  description: 'The outcome artefacts of one failed paid call: {http_status?, settle_attempted?, facilitator_error?, response_headers?, reissued_challenge?, original_payload?} in the published submission form. Processed in memory only, never stored.'
              required:
              - outcome
      responses:
        '200':
          description: 'Success. Returns the full signed report: the reason class from the published mapping table, the retry verdict (RETRY / DO-NOT-RETRY / RECONCILE-FIRST), the raw reason printed verbatim, and an as-of timestamp. Submitted outcome artefacts are processed in memory only and are never stored.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per failed-call outcome - each submitted outcome is charged at $0.01; the payment includes one failure translation of the outcome artefacts you submit (the re-issued 402, the facilitator error body, the HTTP status/headers, the original payload''s nonce) — a reason class from the published mapping table of failure-translation/v1 and a RETRY / DO-NOT-RETRY / RECONCILE-FIRST verdict — computed mechanically from the artefacts exactly as submitted, returned as one signed report with all factors printed. An authorization-already-used outcome always routes to RECONCILE-FIRST, never to ''pay again''. The facilitator''s raw reason is printed verbatim where one was returned; where none was returned, the report says none exists. A free pre-check validates the artefact set''s shape before any payment and returns no class and no verdict. The submitted artefacts are processed in memory only and are never stored; the payments ledger records only the payer, the time, the price, the reason class, the verdict, 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 outcome) 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: postTollFailureTranslatorTranslate
      x-operation-id-source: derived
  /toll/failure-translator/metrics:
    get:
      tags:
      - Failure Translator
      summary: Failure Translator aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid translations, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted outcome content.
      security: []
      operationId: getTollFailureTranslatorMetrics
      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.'