ExchangeRebel Render Bundle 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: Render Bundle
paths:
  /toll/render:
    post:
      tags:
      - Render Bundle
      summary: Render + extract one public web page. $0.02
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                op: bundle
                requested_url: https://example.com/article
                final_url: https://example.com/article
                target_status: 200
                width: 1280
                height: 800
                wall_ms: 1234
                timed_out: false
                complete: true
                truncated_to_cap: false
                extraction:
                  format: markdown
                  content: '# Canary Title


                    Canary body text here.'
                  title: Canary Title
                  char_count: 38
                  total_char_count: 38
                  word_count: 7
                  total_word_count: 7
                  truncated: false
                  non_html: false
                image_png_base64: iVBORw0KGgoJCAcGBQ==
                content_type: image/png
                byte_size: 13
                envelope:
                  v: 1
                  service: render-bundle
                  as_of: '2026-10-21T21:18:26.366Z'
                  source: Self-rendered by our own headless Chromium (CDP, persistent browser) on our own infrastructure; no third-party screenshot or extraction API
                  grade: derived
                  max_age_seconds: 30
                  changes:
                    supported: false
        '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:
                url:
                  type: string
                  description: string (required) - the bare public URL to render. No credentials in the URL; caller cookies/headers are never accepted.
                op:
                  type: string
                  description: 'string - leg: bundle (default, viewport PNG + extraction, $0.02), full-page (full-page PNG + extraction, $0.05, height capped at 8,000 px), or read (extraction only, $0.01)'
                width:
                  type: integer
                  description: integer - viewport width in CSS pixels, 1..1920, default 1280
                height:
                  type: integer
                  description: integer - viewport height in CSS pixels, 1..1080, default 800. Bundle and read legs only; rejected with the full-page leg.
                format:
                  type: string
                  description: 'string - extraction format: markdown (default) or text'
                max_chars:
                  type: integer
                  description: integer - caller ceiling on returned extraction characters, 1000..262144; truncation is disclosed with untruncated totals
              required:
              - url
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
      security:
      - x402Payment: []
      operationId: postTollRender
      x-operation-id-source: derived
  /toll/render/preflight:
    post:
      tags:
      - Render Bundle
      summary: Free pre-check twin of the render bundle op
      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:
                url:
                  type: string
                  description: string (required) - the bare public URL to render. No credentials in the URL; caller cookies/headers are never accepted.
                op:
                  type: string
                  description: 'string - leg: bundle (default, viewport PNG + extraction, $0.02), full-page (full-page PNG + extraction, $0.05, height capped at 8,000 px), or read (extraction only, $0.01)'
                width:
                  type: integer
                  description: integer - viewport width in CSS pixels, 1..1920, default 1280
                height:
                  type: integer
                  description: integer - viewport height in CSS pixels, 1..1080, default 800. Bundle and read legs only; rejected with the full-page leg.
                format:
                  type: string
                  description: 'string - extraction format: markdown (default) or text'
                max_chars:
                  type: integer
                  description: integer - caller ceiling on returned extraction characters, 1000..262144; truncation is disclosed with untruncated totals
              required:
              - url
      security: []
      operationId: postTollRenderPreflight
      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.'