ExchangeRebel Artefact Correspondence 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: Artefact Correspondence
paths:
  /toll/artefact-correspondence:
    get:
      tags:
      - Artefact Correspondence
      summary: Artefact Correspondence service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a correspondence check includes, the price ($0.02 per report check), the published criteria (run-artefact-correspondence/v1) with the normalisation rules N1-N6 and the NOT-ASSESSABLE list, the pinned test corpus, and the scope statement (the service grades correspondence between submitted documents; it never observes a run).'
      security: []
      operationId: getTollArtefactCorrespondence
      x-operation-id-source: derived
  /toll/artefact-correspondence/health:
    get:
      tags:
      - Artefact Correspondence
      summary: Artefact Correspondence service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollArtefactCorrespondenceHealth
      x-operation-id-source: derived
  /toll/artefact-correspondence/criteria:
    get:
      tags:
      - Artefact Correspondence
      summary: The published correspondence criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (run-artefact-correspondence/v1): the Class A and Class B claim types and grades, the normalisation rules N1-N6, the NOT-ASSESSABLE list, and the pinned public test corpus identity; every grade is reproducible from them.'
      security: []
      operationId: getTollArtefactCorrespondenceCriteria
      x-operation-id-source: derived
  /toll/artefact-correspondence/corpus:
    get:
      tags:
      - Artefact Correspondence
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for correspondence checks: its SHA-256 pin ff2d77e8a9c16bf2a2987b688aa954f138e6b97ea0fb902a44631bf0b93173ef (the SHA-256 of the corpus''s canonical serialization). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollArtefactCorrespondenceCorpus
      x-operation-id-source: derived
  /toll/artefact-correspondence/precheck:
    post:
      tags:
      - Artefact Correspondence
      summary: 'Free pre-check: input validation and assessability only, with the…'
      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).
                transcript:
                  type: object
                  description: 'The run transcript artefact: {format: letta-af | anthropic-messages | run-transcript-jsonl, content: ...}.'
                report:
                  type: object
                  description: 'The report''s typed claims: {claims_a: [...], claims_b: [...]}.'
                evidence:
                  type: object
                  description: The evidence artefact the Class B completion claims are graded against.
              required:
              - caller
              - transcript
              - report
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the submitted documents are checkable, with any NOT-ASSESSABLE items named. No claim is graded. A malformed submission is refused free with named reasons. When the caller''s free allowance is exhausted, the response is the /toll/artefact-correspondence payment challenge instead.'
      security: []
      operationId: postTollArtefactCorrespondencePrecheck
      x-operation-id-source: derived
  /toll/artefact-correspondence/check:
    post:
      tags:
      - Artefact Correspondence
      summary: Grade a report's claims against its transcript + evidence ($0.02)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                transcript:
                  type: object
                  description: 'The run transcript artefact: {format: letta-af | anthropic-messages | run-transcript-jsonl, content: ...}.'
                report:
                  type: object
                  description: 'The report''s typed claims: {claims_a: [...], claims_b: [...]}.'
                evidence:
                  type: object
                  description: The evidence artefact the Class B completion claims are graded against.
              required:
              - transcript
              - report
      responses:
        '200':
          description: 'Success. Returns the signed correspondence report: Class A tool-result claims graded PRESENT / ABSENT / FOUND-AS-VARIANT against the transcript; Class B typed completion claims graded PRESENT-AND-MATCHING / PRESENT-BUT-DIFFERS (field named) / ABSENT against the evidence; counts per type only; no composite score.'
        '402':
          description: '$0.02 per report check. The payment includes exactly one correspondence check of the one submission you send (a transcript in one accepted format, a report''s typed claims, and one evidence artefact, inside a request body of up to 262,144 bytes, up to 200 claims per class) and one signed correspondence report under run-artefact-correspondence/v1 stating: per-claim grades for Class A tool-result claims (PRESENT / ABSENT / FOUND-AS-VARIANT, each variant citing the normalisation rules that matched it) graded against the submitted transcript, and for Class B typed completion claims (PRESENT-AND-MATCHING / PRESENT-BUT-DIFFERS with the field named / ABSENT) graded against the submitted evidence; counts per type; and the NOT-ASSESSABLE list. No report states or implies that a task or run is complete. A free pre-check validates the submission''s shape before any payment and returns assessability only — no grade is computed free. Submissions are processed in memory only and are never stored; the payments ledger records only the payer, the time, the price, the grade counts, and the verdict line. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (20000 USDC units = $0.02 per report 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.02'
      security:
      - x402Payment: []
      operationId: postTollArtefactCorrespondenceCheck
      x-operation-id-source: derived
  /toll/artefact-correspondence/metrics:
    get:
      tags:
      - Artefact Correspondence
      summary: Artefact Correspondence aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted content.
      security: []
      operationId: getTollArtefactCorrespondenceMetrics
      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.'