ExchangeRebel Rail Router 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: Rail Router
paths:
  /toll/rail-router:
    get:
      tags:
      - Rail Router
      summary: Rail Router service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a rail identification includes, the price ($0.01 per challenge), the published criteria (payer-preflight/v1, op rail-router) and its grammar table, the pinned test corpus, and the scope statement (a deterministic identification of the rail of the one 402 artefact you submit; the MPP-signals reading is a disclosed construction; no composite score).'
      security: []
      operationId: getTollRailRouter
      x-operation-id-source: derived
  /toll/rail-router/health:
    get:
      tags:
      - Rail Router
      summary: Rail Router service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollRailRouterHealth
      x-operation-id-source: derived
  /toll/rail-router/criteria:
    get:
      tags:
      - Rail Router
      summary: The published rail identification criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (payer-preflight/v1, op rail-router): the rail grammar for each x402 form, the disclosed MPP-signals construction, and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollRailRouterCriteria
      x-operation-id-source: derived
  /toll/rail-router/corpus:
    get:
      tags:
      - Rail Router
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for rail routing: corpus id rail-router-corpus/v1 and its SHA-256 pin 8022e577a86e1fb4805de5f3d173323720f491087e68a300e5a9aa0917bbf254 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollRailRouterCorpus
      x-operation-id-source: derived
  /toll/rail-router/precheck:
    post:
      tags:
      - Rail Router
      summary: Free headline pre-check of one rail artefact
      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).
                artefact:
                  type: object
                  description: 'The one 402 artefact to identify: its status, headers and body in the form received. Processed in memory only, never stored.'
              required:
              - caller
              - artefact
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the artefact carries a readable 402 form. No rail identification is returned. A malformed submission is refused free. When the caller''s free allowance is exhausted, the response is the /toll/rail-router payment challenge instead.'
      security: []
      operationId: postTollRailRouterPrecheck
      x-operation-id-source: derived
  /toll/rail-router/route:
    post:
      tags:
      - Rail Router
      summary: Full signed rail identification of one submitted 402 artefact
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                artefact:
                  type: object
                  description: 'The one 402 artefact to identify: its status, headers and body in the form received. Processed in memory only, never stored.'
              required:
              - artefact
      responses:
        '200':
          description: 'Success. Returns the full signed report: the identified rail for the submitted artefact, the grammar evidence for the identification, and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per challenge - each submitted artefact is charged at $0.01; the payment includes one rail identification of the one 402 response (or its headers) you submit — the rail (x402-EVM / x402-SVM / L402 / MPP / unknown), the discriminating evidence printed, any conflicting signals with the published rule that resolved them, and for the identified rail the asset, the wallet capability required, and the first incompatibility to expect, each with its provenance — and an as-of timestamp. Unknown is a first-class answer: an unidentifiable response is reported unknown with the evidence printed, never forced into a known rail. Factors printed; no composite score. 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 (10000 USDC units = $0.01 per challenge) 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: postTollRailRouterRoute
      x-operation-id-source: derived
  /toll/rail-router/metrics:
    get:
      tags:
      - Rail Router
      summary: Rail Router aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted artefacts.
      security: []
      operationId: getTollRailRouterMetrics
      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.'