ExchangeRebel Context Audit 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: Context Audit
paths:
  /toll/context-audit:
    get:
      tags:
      - Context Audit
      summary: Context Audit service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a context-composition audit includes, the price ($0.05 per report), the published criteria (context-composition/v1), the pinned test corpus, and the scope statement (composition only - no judgement of the record, the agent, or any model; no composite score; records are processed in memory only and never stored).'
      security: []
      operationId: getTollContextAudit
      x-operation-id-source: derived
  /toll/context-audit/health:
    get:
      tags:
      - Context Audit
      summary: Context Audit service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollContextAuditHealth
      x-operation-id-source: derived
  /toll/context-audit/criteria:
    get:
      tags:
      - Context Audit
      summary: The published context-composition criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (context-composition/v1): the accepted record formats and adapters, the two-axis composition classes, the metric register M01-M15, factors F-1 to F-12 with their assessability rules, the estimate typography rule, the forbidden-vocabulary fence, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollContextAuditCriteria
      x-operation-id-source: derived
  /toll/context-audit/corpus:
    get:
      tags:
      - Context Audit
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for context audits: its SHA-256 pin 625702358c906f1326fc1492a409d888320c8e7c1b084dd2f8ee5bb0a0e9a9d3 (the SHA-256 of the corpus''s canonical serialization). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollContextAuditCorpus
      x-operation-id-source: derived
  /toll/context-audit/precheck:
    post:
      tags:
      - Context Audit
      summary: 'Free pre-check: input validation and the full per-format assessability…'
      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).
                envelope_version:
                  type: string
                  description: Must be "context-composition-envelope/1".
                declared_format_id:
                  type: string
                  description: letta-af | anthropic-messages | generic-message-list (the adapter set published in the criteria).
                record:
                  type: object
                  description: The session/context record in the declared format. Processed in memory only; never stored.
              required:
              - caller
              - envelope_version
              - declared_format_id
              - record
      responses:
        '200':
          description: 'Success. Returns the full per-format assessability disclosure: which of F-1 to F-12 are ASSESSABLE for this record and which are NOT-ASSESSABLE (so a LIMITED report is never a surprise). No factor table and no measurement are produced. A malformed envelope is refused free with named reasons. When the caller''s free allowance is exhausted, the response is the /toll/context-audit payment challenge instead.'
      security: []
      operationId: postTollContextAuditPrecheck
      x-operation-id-source: derived
  /toll/context-audit/audit:
    post:
      tags:
      - Context Audit
      summary: Audit one context record's composition ($0.05)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                envelope_version:
                  type: string
                  description: Must be "context-composition-envelope/1".
                declared_format_id:
                  type: string
                  description: letta-af | anthropic-messages | generic-message-list (the adapter set published in the criteria).
                record:
                  type: object
                  description: The session/context record in the declared format. Processed in memory only; never stored.
              required:
              - envelope_version
              - declared_format_id
              - record
      responses:
        '200':
          description: 'Success. Returns the signed composition report: the two-axis composition (10 provenance classes x 7 content classes), the metric register M01-M15 as the record supports, and factors F-1 to F-12 each ASSESSABLE or NOT-ASSESSABLE; whenever any factor is NOT-ASSESSABLE the measurement line carries LIMITED. Estimates are never printed with a count''s typography.'
        '402':
          description: '$0.05 buys one full context-composition measurement report for one submitted session/context record: the measurement line and every assessable factor under the published context-composition/v1 criteria (GET /criteria), returned as a signed report. Factors that are not assessable for the submitted format are disclosed free, before payment, by the pre-check. The payment includes exactly one measurement of the one record you send inline in envelope context-composition-envelope/1 (up to 5 MiB body, up to 10,000 entries, up to 1 MiB per entry) and one signed report stating: the two-axis composition (10 provenance classes x 7 content classes), metric register M01-M15 as the record supports, factors F-1 to F-12 with each factor ASSESSABLE or NOT-ASSESSABLE, and LIMITED in the measurement line whenever any factor is NOT-ASSESSABLE. Composition only: no report states or implies any judgement of the record, the agent, or any model. A free pre-check discloses the full per-format assessability for your submission before any payment. A could-not-measure submission on the paid route is returned unpaid. Records are processed in memory only and are never stored; the payments ledger records only the closed aggregate field list published in the criteria. 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 report) 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.05'
      security:
      - x402Payment: []
      operationId: postTollContextAuditAudit
      x-operation-id-source: derived
  /toll/context-audit/metrics:
    get:
      tags:
      - Context Audit
      summary: Context Audit aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid audits, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted content.
      security: []
      operationId: getTollContextAuditMetrics
      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.'