ExchangeRebel Facilitator Fit 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: Facilitator Fit
paths:
  /toll/facilitator-fit:
    get:
      tags:
      - Facilitator Fit
      summary: Facilitator Fit service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a facilitator fit check includes, the price ($0.01 per challenge), the published criteria (payer-preflight/v1, op facilitator-fit) and its policy table, the pinned test corpus, and the scope statement (the facilitator''s /supported response graded exactly as served at check time; no composite score).'
      security: []
      operationId: getTollFacilitatorFit
      x-operation-id-source: derived
  /toll/facilitator-fit/health:
    get:
      tags:
      - Facilitator Fit
      summary: Facilitator Fit service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollFacilitatorFitHealth
      x-operation-id-source: derived
  /toll/facilitator-fit/criteria:
    get:
      tags:
      - Facilitator Fit
      summary: The published facilitator fit criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (payer-preflight/v1, op facilitator-fit): the fit states, the factor list, the guarantee absence rule, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollFacilitatorFitCriteria
      x-operation-id-source: derived
  /toll/facilitator-fit/corpus:
    get:
      tags:
      - Facilitator Fit
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for facilitator fit checks: corpus id facilitator-fit-corpus/v1 and its SHA-256 pin b954898dd234cd7ece4ec23f494dfa1ad9d1804fdfc43055f7ec32bfa1d46af7 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollFacilitatorFitCorpus
      x-operation-id-source: derived
  /toll/facilitator-fit/precheck:
    post:
      tags:
      - Facilitator Fit
      summary: Free headline pre-check of one facilitator fit submission
      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).
                network:
                  type: string
                  description: The challenge network (e.g. solana, base).
                scheme:
                  type: string
                  description: The challenge scheme (e.g. exact).
                facilitator_url:
                  type: string
                  description: The facilitator base URL whose /supported is graded; the host is reported, the path is never stored.
                payTo:
                  type: string
                  description: Optional seller wallet; required for the PayAI free-credits leg when the named facilitator is PayAI.
              required:
              - caller
              - network
              - scheme
              - facilitator_url
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the submission is well-formed. No fit state is returned. A malformed submission is refused free. When the caller''s free allowance is exhausted, the response is the /toll/facilitator-fit payment challenge instead.'
      security: []
      operationId: postTollFacilitatorFitPrecheck
      x-operation-id-source: derived
  /toll/facilitator-fit/check:
    post:
      tags:
      - Facilitator Fit
      summary: Full signed facilitator fit check of one challenge against its named facilitator
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                network:
                  type: string
                  description: The challenge network (e.g. solana, base).
                scheme:
                  type: string
                  description: The challenge scheme (e.g. exact).
                facilitator_url:
                  type: string
                  description: The facilitator base URL whose /supported is graded; the host is reported, the path is never stored.
                payTo:
                  type: string
                  description: Optional seller wallet; required for the PayAI free-credits leg when the named facilitator is PayAI.
              required:
              - network
              - scheme
              - facilitator_url
      responses:
        '200':
          description: 'Success. Returns the full signed report: the fit state graded from the facilitator''s live /supported response as observed, all factors printed, the guarantee map exactly as published (or the absence line), the credit state (NOT-PUBLISHED unless the named facilitator is PayAI), and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per challenge facilitator fit check - each submitted challenge is charged at $0.01; the payment includes one facilitator fit check for the challenge you submit (its network, its scheme, and the seller''s facilitator URL where the challenge or tooling names it) — this service reads that facilitator''s public /supported endpoint (a designed-purpose endpoint) and, where the named facilitator is PayAI, its public per-wallet free-credits lookup for the seller wallet you name — and returns one signed report giving the fit state (SERVES-KIND, TESTNET-ONLY, DOES-NOT-SERVE, RESPONSE-UNPARSEABLE, or FACILITATOR-UNREACHABLE), whether the facilitator serves this kind, whether the endpoint is testnet-only, whether signer addresses are present for the network (presence and count only — addresses are not printed), the guarantee-relevant fields exactly as published (most facilitators publish none, and the absence is the report — a guarantee field is never filled in or inferred), and the seller''s credit state where a per-wallet lookup is published (PayAI free credits: available / low / exhausted; CDP quota state and paid-credit balances are unpublished per-wallet and are reported NOT-PUBLISHED, never estimated). Every factor is printed; no composite score is computed. An unparseable or unreachable facilitator response is graded as observed, never guessed. A free pre-check validates the submitted challenge''s shape and the facilitator URL against the published URL policy before any payment; it performs no facilitator read and returns no fit result. The facilitator responses are processed in memory only and are never stored; the payments ledger records only the payer, the time, the price, the fit state, the serves-kind and testnet-only flags, the credit state, 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 challenge) 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: postTollFacilitatorFitCheck
      x-operation-id-source: derived
  /toll/facilitator-fit/metrics:
    get:
      tags:
      - Facilitator Fit
      summary: Facilitator Fit aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted URLs beyond the facilitator host.
      security: []
      operationId: getTollFacilitatorFitMetrics
      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.'