ExchangeRebel Funding Check 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: Funding Check
paths:
  /toll/funding-check:
    get:
      tags:
      - Funding Check
      summary: Funding Check service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a funding check includes, the price ($0.01 per check), the published criteria (payer-preflight/v1, op funding-check) and its policy table, the pinned test corpus, and the scope statement (a point-in-time readiness read of one wallet against one challenge; the queried wallet is never stored; no composite score).'
      security: []
      operationId: getTollFundingCheck
      x-operation-id-source: derived
  /toll/funding-check/health:
    get:
      tags:
      - Funding Check
      summary: Funding Check service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollFundingCheckHealth
      x-operation-id-source: derived
  /toll/funding-check/criteria:
    get:
      tags:
      - Funding Check
      summary: The published funding readiness criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (payer-preflight/v1, op funding-check): what readiness means per network, the fee-coverage rules, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollFundingCheckCriteria
      x-operation-id-source: derived
  /toll/funding-check/corpus:
    get:
      tags:
      - Funding Check
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for funding checks: corpus id funding-check-corpus/v1 and its SHA-256 pin d6608308c21291275b1c263b578d74fc866df0e202482cbbd8e09c3f9baf98a6 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollFundingCheckCorpus
      x-operation-id-source: derived
  /toll/funding-check/precheck:
    post:
      tags:
      - Funding Check
      summary: Free headline pre-check of one funding 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).
                wallet_address:
                  type: string
                  description: The wallet whose readiness is checked (a Solana pubkey for network solana, an EVM address for network base). Never stored.
                challenge:
                  type: object
                  description: 'The payment challenge to check readiness against: network (solana or base), scheme, asset (mint or contract), amount_required (atomic units, string), facilitator when the client mode is facilitator.'
              required:
              - caller
              - wallet_address
              - challenge
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the submission is well-formed and the wallet can be read. No readiness verdict is returned. A malformed submission is refused free. When the caller''s free allowance is exhausted, the response is the /toll/funding-check/check payment challenge instead.'
      security: []
      operationId: postTollFundingCheckPrecheck
      x-operation-id-source: derived
  /toll/funding-check/check:
    post:
      tags:
      - Funding Check
      summary: Full signed funding-and-gas readiness check of one wallet against one challenge
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                wallet_address:
                  type: string
                  description: The wallet whose readiness is checked (a Solana pubkey for network solana, an EVM address for network base). Never stored.
                challenge:
                  type: object
                  description: 'The payment challenge to check readiness against: network (solana or base), scheme, asset (mint or contract), amount_required (atomic units, string), facilitator when the client mode is facilitator.'
              required:
              - wallet_address
              - challenge
      responses:
        '200':
          description: 'Success. Returns the full signed report: the READY / NOT-READY verdict with every missing item named, the balances read at check time, and an as-of timestamp. The queried wallet address is never stored.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per funding check - each submitted check is charged at $0.01; the payment includes one funding-and-gas readiness check of the wallet address and challenge you submit — one-off public chain reads on the supported networks reporting whether the wallet holds the exact asset named by the challenge (matched by contract address or mint, never by ticker) on the exact network, in at least the required amount, plus the scheme''s published preconditions (Permit2 approval, native gas, facilitator sponsorship of the approval, Solana ATA creation) — returned as one signed report with every readiness factor printed and, when the wallet is not ready, the missing items named exactly. There is no composite score. A free pre-check validates the submission''s shape before any payment and returns no readiness verdict. The check is one-off and store-nothing: nothing about the queried wallet is retained; the service''s own payments ledger is the fleet-standard closed list and never carries the queried address. 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 funding check) 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: postTollFundingCheckCheck
      x-operation-id-source: derived
  /toll/funding-check/metrics:
    get:
      tags:
      - Funding Check
      summary: Funding Check aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, distinct payers, free pre-checks today). Aggregate only - no payer identities, no queried wallet addresses.
      security: []
      operationId: getTollFundingCheckMetrics
      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.'