ExchangeRebel Probe Grade 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: Probe Grade
paths:
  /toll/probe-grade:
    get:
      tags:
      - Probe Grade
      summary: Probe Grade service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a probe-transcript grade includes, the price ($0.05 per grade), the published criteria (memory-probe-grade/v1), the pinned test corpus, and the scope statement (you run a published probe script against your own memory store in a synthetic namespace and submit the transcript; five probes are graded deterministically per family against the family''s published expectation table; the service executes nothing against any store; the grade grades the submitted transcript of a challenge run only - it is not a certification of your production store).'
      security: []
      operationId: getTollProbeGrade
      x-operation-id-source: derived
  /toll/probe-grade/health:
    get:
      tags:
      - Probe Grade
      summary: Probe Grade service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollProbeGradeHealth
      x-operation-id-source: derived
  /toll/probe-grade/criteria:
    get:
      tags:
      - Probe Grade
      summary: The published probe-grade criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (memory-probe-grade/v1): the input contract, the five probes, the per-family expectation tables, the binding-strength wording, the extraction caveats, the fence, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollProbeGradeCriteria
      x-operation-id-source: derived
  /toll/probe-grade/corpus:
    get:
      tags:
      - Probe Grade
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for memory-probe-grade/v1: corpus id probe-grade-corpus/v1 and its SHA-256 pin 33974c67885ec97a9a8991b55ddfb80753e95f6706efaeba7c7a22f2a1f097a5 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollProbeGradeCorpus
      x-operation-id-source: derived
  /toll/probe-grade/precheck:
    post:
      tags:
      - Probe Grade
      summary: Free probe-grade pre-check of one probe transcript (validation +…
      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).
                family:
                  type: string
                  description: 'The memory-store family the probe run targeted: mem0, zep-cloud, graphiti, or letta.'
                script_id:
                  type: string
                  description: The published probe script id the run followed (probe-script/<family>/v1).
                issued_nonce:
                  type: string
                  description: The per-run nonce the published script issued for this run (8-256 characters).
                canary_echo:
                  type: string
                  description: The nonce exactly as it came back through the store's read paths (the canary echo).
                variant:
                  type: string
                  description: Optional family variant (e.g. platform / oss).
                declared_scope:
                  type: string
                  description: Optional declared scope of the run ("synthetic" for a script run).
                claimed_expectations:
                  type: object
                  description: 'Optional claimed expectations: probe ids mapped to RUNNABLE / PARTIAL / NOT RUNNABLE.'
                probes:
                  type: object
                  description: Entries for the five probes (persistence_truth, scope_coherence, replay_duplication, repeatable_read, feature_liveness), each with status observed-pass / observed-fail / not-run and an evidence object.
              required:
              - caller
              - family
              - script_id
              - issued_nonce
              - canary_echo
              - probes
      responses:
        '200':
          description: 'Success. Returns assessability only: the declared family''s published expectation table and binding-strength wording, disclosed before payment. No grades are returned. When the caller''s free allowance is exhausted, the response is the /toll/probe-grade/grade payment challenge instead.'
      security: []
      operationId: postTollProbeGradePrecheck
      x-operation-id-source: derived
  /toll/probe-grade/grade:
    post:
      tags:
      - Probe Grade
      summary: Full signed probe-transcript grade for one submitted transcript
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                family:
                  type: string
                  description: 'The memory-store family the probe run targeted: mem0, zep-cloud, graphiti, or letta.'
                script_id:
                  type: string
                  description: The published probe script id the run followed (probe-script/<family>/v1).
                issued_nonce:
                  type: string
                  description: The per-run nonce the published script issued for this run (8-256 characters).
                canary_echo:
                  type: string
                  description: The nonce exactly as it came back through the store's read paths (the canary echo).
                variant:
                  type: string
                  description: Optional family variant (e.g. platform / oss).
                declared_scope:
                  type: string
                  description: Optional declared scope of the run ("synthetic" for a script run).
                claimed_expectations:
                  type: object
                  description: 'Optional claimed expectations: probe ids mapped to RUNNABLE / PARTIAL / NOT RUNNABLE.'
                probes:
                  type: object
                  description: Entries for the five probes (persistence_truth, scope_coherence, replay_duplication, repeatable_read, feature_liveness), each with status observed-pass / observed-fail / not-run and an evidence object.
              required:
              - family
              - script_id
              - issued_nonce
              - canary_echo
              - probes
      responses:
        '200':
          description: 'Success. Returns the full signed report: the five probes (persistence truth; scope coherence; replay duplication; repeatable read; feature liveness) each graded RUNNABLE / PARTIAL / NOT RUNNABLE against the declared family''s published expectation table with the table entry cited per probe, a behavioural outcome per probe, the family''s binding-strength wording, the canary status, and the factors. Factors printed; no composite score. The submitted transcript is never stored beyond the payments ledger''s closed field list.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.05 per grade - the payment includes one deterministic grade of the one probe transcript you submit — five probes (persistence truth; scope coherence; replay duplication; repeatable read; feature liveness) each graded RUNNABLE / PARTIAL / NOT RUNNABLE against the declared family''s published expectation table with the table entry cited per probe, a behavioural outcome per probe read from the transcript''s evidence, the family''s binding-strength wording, the canary status, and the factors. Factors printed; no composite score. The grade grades the submitted transcript of a challenge run only — it is not a certification of your production store. Nothing submitted is stored beyond the payments ledger''s closed field list. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (50000 USDC units = $0.05 per grade) 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 transcript in 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.05'
      security:
      - x402Payment: []
      operationId: postTollProbeGradeGrade
      x-operation-id-source: derived
  /toll/probe-grade/metrics:
    get:
      tags:
      - Probe Grade
      summary: Probe Grade aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid grades, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted transcript content.
      security: []
      operationId: getTollProbeGradeMetrics
      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.'