ExchangeRebel Agent Data Core Arena 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: Agent Data Core Arena
paths:
  /toll/arena:
    get:
      tags:
      - Agent Data Core Arena
      summary: 'Arena catalog: counts and labels only (free)'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      description: 'Free: arena catalog — counts and labels only; paid entries carry RULED prices ($25 standard / $50 full-service / $10 re-test) plus what each price includes.'
      operationId: getTollArena
      x-operation-id-source: derived
  /toll/arena/catalog:
    get:
      tags:
      - Agent Data Core Arena
      summary: 'Free arena catalog: counts and labels only'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      description: 'Free: arena catalog — counts and labels only; paid entries carry RULED prices ($25 standard / $50 full-service / $10 re-test) plus what each price includes.'
      operationId: getTollArenaCatalog
      x-operation-id-source: derived
  /toll/arena/eligible:
    get:
      tags:
      - Agent Data Core Arena
      summary: Arena-eligible targets (free, no prices)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      description: 'Free: eligible-target descriptors (service id, name, category, verification state, endpoint method/path/summary). No prices.'
      operationId: getTollArenaEligible
      x-operation-id-source: derived
  /toll/arena/health:
    get:
      tags:
      - Agent Data Core Arena
      summary: Arena health + eligible counts (free)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      description: 'Free: service health, snapshot load state, eligible endpoint count. Counts only.'
      operationId: getTollArenaHealth
      x-operation-id-source: derived
  /toll/arena/mcp:
    post:
      tags:
      - Agent Data Core Arena
      summary: Arena MCP endpoint (Streamable HTTP)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      description: 'MCP dispatch (JSON-RPC): tools/list, arena_eligible, arena_quote and arena_result are free; arena_run is toll-gated at the same RULED tier prices ($25 standard / $50 full-service / $10 re-test).'
      operationId: postTollArenaMcp
      x-operation-id-source: derived
  /toll/arena/run:
    get:
      tags:
      - Agent Data Core Arena
      summary: Read one run's status/result (free)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: query
        required: true
        schema:
          type: string
        description: Run id returned by arena_run
      security: []
      description: 'Free: lifecycle state, verdict, per-call records (digests only, never payloads), and write-back events, by ?id=.'
      operationId: getTollArenaRun
      x-operation-id-source: derived
    post:
      tags:
      - Agent Data Core Arena
      summary: Arena verification run — single endpoint ($25)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                service_id:
                  type: string
                  description: string (required) - The Layer 0 service id to test (see /toll/arena/eligible).
                endpoint_path:
                  type: string
                  description: string (optional) - The specific paid endpoint path to test.
                seller_ref:
                  type: string
                  description: string (optional) - The seller's reference for this run.
                run_id:
                  type: string
                  description: string (optional) - Caller-chosen run id; one is generated when omitted.
              required:
              - service_id
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '25'
      security:
      - x402Payment: []
      description: 'Start one paid-and-judged verification run of a single endpoint. Price RULED $25. Includes: one arena-executed verification run of a single endpoint — the fixed 3-call suite (1 free pre-check call judged on challenge quality + 2 settled paid calls with per-run varied inputs, executed by the arena itself, never by the seller), judging on settled / delivered / payload_valid / challenge_ok with latency recorded, one verdict (pass / partial / fail) with per-dimension summaries, Layer 0 write-back events (verification evidence, delivery-proof delta, and a state recommendation on pass only), leaderboard eligibility from the same evidence, and the run record retained as digests + call records (payloads never stored). The run price is the full price of the run: the constituent test-call costs (2 x the target endpoint''s listed price) are the arena''s cost, not an additional charge.'
      x-price-status: RULED
      operationId: postTollArenaRun
      x-operation-id-source: derived
  /toll/arena/run/full-service:
    post:
      tags:
      - Agent Data Core Arena
      summary: Arena verification run — full service ($50)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                service_id:
                  type: string
                  description: string (required) - The Layer 0 service id to test (see /toll/arena/eligible).
                seller_ref:
                  type: string
                  description: string (optional) - The seller's reference for this run.
                run_id:
                  type: string
                  description: string (optional) - Caller-chosen run id; one is generated when omitted.
              required:
              - service_id
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '50'
      security:
      - x402Payment: []
      description: 'Start one paid-and-judged verification run covering every paid endpoint of a single service. Price RULED $50. Includes: the fixed 3-call suite (1 free pre-check call judged on challenge quality + 2 settled paid calls with per-run varied inputs, executed by the arena itself, never by the seller) executed per endpoint, judging per endpoint on settled / delivered / payload_valid / challenge_ok with latency recorded, one verdict per endpoint plus a service-level dimension summary, Layer 0 write-back per endpoint (verification evidence, delivery-proof delta, and a state recommendation on pass only), leaderboard eligibility from the same evidence, and run records retained as digests + call records (payloads never stored). The run price is the full price of the run: constituent test-call costs are the arena''s cost, not an additional charge.'
      x-price-status: RULED
      operationId: postTollArenaRunFullService
      x-operation-id-source: derived
  /toll/arena/run/quote:
    post:
      tags:
      - Agent Data Core Arena
      summary: Free quote for one verification run
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                service_id:
                  type: string
                  description: string (required) - The Layer 0 service id to test (see /toll/arena/eligible).
                endpoint_path:
                  type: string
                  description: string (optional) - The specific paid endpoint path to test.
              required:
              - service_id
      security: []
      description: 'Free: the fixed 3-call plan for the target plus the constituent test-call cost summed from the target endpoint''s own listed prices. Unknown or ineligible targets are refused free, pre-gate.'
      operationId: postTollArenaRunQuote
      x-operation-id-source: derived
  /toll/arena/run/retest:
    post:
      tags:
      - Agent Data Core Arena
      summary: Arena verification run — re-test ($10)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                service_id:
                  type: string
                  description: string (required) - The Layer 0 service id to test (see /toll/arena/eligible).
                endpoint_path:
                  type: string
                  description: string (optional) - The specific paid endpoint path to test.
                seller_ref:
                  type: string
                  description: string (optional) - The seller's reference for this run (must match a prior run).
                run_id:
                  type: string
                  description: string (optional) - Caller-chosen run id; one is generated when omitted.
              required:
              - service_id
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '10'
      security:
      - x402Payment: []
      description: 'Start one re-test verification run of an endpoint the same seller has already run. Price RULED $10. Includes: the identical fixed 3-call suite (1 free pre-check call judged on challenge quality + 2 settled paid calls with per-run varied inputs, executed by the arena itself, never by the seller), identical judging (settled / delivered / payload_valid / challenge_ok, latency recorded), one verdict (pass / partial / fail) with per-dimension summaries, and Layer 0 write-back (verification evidence, delivery-proof delta, and a state recommendation on pass only). A re-test inside the 24h reputation window is delivered in full but flagged reputation_counted: false — it buys fresh evidence, not faster reputation. The run price is the full price of the run: constituent test-call costs are the arena''s cost, not an additional charge. A seller with no prior run of the target is refused free, pre-gate.'
      x-price-status: RULED
      operationId: postTollArenaRunRetest
      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.'