ExchangeRebel Dialect 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: Dialect
paths:
  /toll/dialect:
    get:
      tags:
      - Dialect
      summary: Dialect Check service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a dialect report includes, the price ($0.01 per endpoint), the published criteria (payability/v1, family A2), the pinned test corpus, and the scope statement (a deterministic x402 dialect conformance report: which dialect the endpoint''s challenge speaks, per axis - carrier, client-header names, payload shape, amount field name, network-ID form, receipt headers; no composite score, and payability is not graded - that is the Payability Verdict''s ground).'
      security: []
      operationId: getTollDialect
      x-operation-id-source: derived
  /toll/dialect/health:
    get:
      tags:
      - Dialect
      summary: Dialect Check service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollDialectHealth
      x-operation-id-source: derived
  /toll/dialect/criteria:
    get:
      tags:
      - Dialect
      summary: The published dialect conformance criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (payability/v1, family A2): the two modes (probe / submitted), the six axes and their grading rules, the cross-leg union semantics, the scope block including the A1 boundary, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollDialectCriteria
      x-operation-id-source: derived
  /toll/dialect/corpus:
    get:
      tags:
      - Dialect
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for the dialect check: corpus id dialect-corpus/v1 and its SHA-256 pin 9c3d10dc0dcd8fac4fea0cdd9294066f250eb50d1d7f305216a4bee3e1ed48b2 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollDialectCorpus
      x-operation-id-source: derived
  /toll/dialect/precheck:
    post:
      tags:
      - Dialect
      summary: Free headline dialect pre-check of one endpoint URL or artefact set
      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).
                mode:
                  type: string
                  description: 'The check mode: ''probe'' (name one endpoint URL) or ''submitted'' (submit one captured artefact set).'
                url:
                  type: string
                  description: 'Probe mode: the one endpoint URL whose live 402 challenge is fetched and graded. Never stored.'
                artefact:
                  type: object
                  description: 'Submitted mode: one captured challenge/payload set (status?, body_obj?/body_raw?, header_obj?/payment_required_header?, payload_obj?, payload_headers?, response_headers?). Processed in memory only, never stored.'
              required:
              - caller
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the URL or artefact is in-policy. No fetch is performed, no artefact is analysed, and no dialect finding is returned. When the caller''s free allowance is exhausted, the response is the /toll/dialect/check payment challenge instead.'
      security: []
      operationId: postTollDialectPrecheck
      x-operation-id-source: derived
  /toll/dialect/check:
    post:
      tags:
      - Dialect
      summary: Full signed dialect conformance report for one endpoint or artefact set
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                mode:
                  type: string
                  description: 'The check mode: ''probe'' (name one endpoint URL) or ''submitted'' (submit one captured artefact set).'
                url:
                  type: string
                  description: 'Probe mode: the one endpoint URL whose live 402 challenge is fetched and graded. Never stored.'
                artefact:
                  type: object
                  description: 'Submitted mode: one captured challenge/payload set (status?, body_obj?/body_raw?, header_obj?/payment_required_header?, payload_obj?, payload_headers?, response_headers?). Processed in memory only, never stored.'
              required:
              - mode
      responses:
        '200':
          description: 'Success. Returns the full signed report: the dialect summary and the per-axis findings (challenge carrier, client-header names, payload shape, amount field name, network-ID form, receipt headers), every mismatch named, every undeterminable axis reported UNDETERMINED, and an as-of timestamp. Artefacts are processed in memory only and are never stored.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per endpoint - each endpoint (probe mode) or submitted artefact set you submit is charged at $0.01; the payment includes one endpoint dialect report — this service analyses that one endpoint''s 402 challenge artefact (fetched live exactly as an unauthenticated stranger would in probe mode, or submitted by you in submitted mode) and returns one signed report naming, per axis, the challenge carrier (v1 body / v2 header / both), the client-header names accepted where the artefact evidences them, the payload shape (scheme/network top-level vs inside accepted) where a payload was submitted, the amount field name, the network-ID form (slug vs CAIP-2), and the receipt headers emitted where a paid-response artefact was submitted, with every mismatch named per axis, every axis that cannot be determined from the artefact reported as UNDETERMINED (never guessed), and an as-of timestamp. A free pre-check validates the submitted URL or artefact against the published policy only — it performs no fetch and returns no report. The artefact is processed in memory only and never stored; the payments ledger records only the payer, the time, the price, the dialect summary, the carrier, and the report 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 endpoint) 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: postTollDialectCheck
      x-operation-id-source: derived
  /toll/dialect/metrics:
    get:
      tags:
      - Dialect
      summary: Dialect Check aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, distinct payers, free pre-checks today). Aggregate only - no payer identities, no probed URL or artefact content.
      security: []
      operationId: getTollDialectMetrics
      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.'