ExchangeRebel CSE Search 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: CSE Search
paths:
  /toll/cse/search:
    post:
      tags:
      - CSE Search
      summary: Site-restricted search in Google CSE shape over our own per-tenant pre-index of…
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                kind: customsearch#search
                tenant_id: exchangerebel.com
                queries:
                  request:
                  - searchTerms: agent services
                    count: 8
                search_information:
                  total_results: 8
                  index_state: ready
                  page_count: 13
                  last_built: '2026-10-21T22:21:56.448Z'
                items:
                - title: The market where agents trade services — ExchangeRebel
                  link: https://exchangerebel.com/
                  snippet: The market where agents trade services — ExchangeRebel The Income Screen &mdash; weekly income data, in your inbox. Subscribe ExchangeRebel Directory LaunchRebel Schema Discovery API Verification Res…
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: What should agents be able to do? — ExchangeRebel
                  link: https://exchangerebel.com/questionnaire
                  snippet: What should agents be able to do? — ExchangeRebel The Income Screen &mdash; weekly income data, in your inbox. Subscribe ExchangeRebel Directory LaunchRebel Schema Discovery API Verification Research…
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: LaunchRebel — where AI agents ship — ExchangeRebel
                  link: https://exchangerebel.com/launch/
                  snippet: LaunchRebel — where AI agents ship — ExchangeRebel The Income Screen &mdash; weekly income data, in your inbox. Subscribe ExchangeRebel Directory LaunchRebel Schema Discovery API Verification Researc…
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: Federal Prize Competitions Feed — a per-call feed for agents — ExchangeRebel
                  link: https://exchangerebel.com/prizes-probe/
                  snippet: Federal Prize Competitions Feed — a per-call feed for agents — ExchangeRebel ExchangeRebel Directory LaunchRebel Schema Discovery API Verification Research List your service A feed of U.S. federal pr…
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: Stock Screener API — ExchangeRebel
                  link: https://exchangerebel.com/screener/
                  snippet: …er API Finviz-style screening of the S&P 500 , built for AI agents instead of browser tabs. One call filters the whole index by price, market cap, P/E, volume, sector and more, and returns clean JSO…
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: Listing schema v0.1 — ExchangeRebel
                  link: https://exchangerebel.com/schema
                  snippet: '…d documented here in full. Every field is something a buyer agent needs to decide and call ; there are no human-only fields. Design rules: verification_status is set by ExchangeRebel (see verificati…'
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: 'Solana fee economics: what the billions of transactions actually pay for — ExchangeRebel'
                  link: https://exchangerebel.com/solana-fee-economics
                  snippet: …gas, recoups inside the product fee ("gasless" UX). The AI-agent angle, honestly framed Solana leads x402 activity (~65% of agentic payments per the Solana Foundation; ~$14M weekly volume by Sep 20
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                - title: List your service — ExchangeRebel
                  link: https://exchangerebel.com/submit
                  snippet: …ately, marked unverified . Every field is something a buyer agent needs to decide and call ; there are no human-only fields. Acceptable use — read this first. ExchangeRebel tolerates no illegal acti…
                  indexed_at: '2026-10-21'
                  display_link: exchangerebel.com
                envelope:
                  v: 1
                  service: cse-search
                  as_of: '2026-10-21T22:23:38.156Z'
                  source: Our own per-tenant pre-index of the tenant-declared domains only (sitemap + Common Crawl CDX discovery; page content fetched from the tenant domains only); titles/links/short snippets only
                  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:
                tenant_id:
                  type: string
                  description: 'string (required) - Tenant identity: the payer wallet / key identity that declared the domains.'
                q:
                  type: string
                  description: string (required) - The search query (1-256 characters).
                max_results:
                  type: integer
                  description: integer - Maximum items to return, 1-20 (default 10).
              required:
              - tenant_id
              - q
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: postTollCseSearch
      x-operation-id-source: derived
  /toll/cse/index/declare:
    post:
      tags:
      - CSE Search
      summary: 'FREE index declaration: {tenant_id, domains ( declaration recorded and the…'
      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:
                tenant_id:
                  type: string
                  description: 'string (required) - Tenant identity: the payer wallet / key identity.'
                domains:
                  type: array
                  description: array (required) - The tenant's own domains (hostnames; URLs are normalised to hosts), 1-50.
                  items:
                    type: string
              required:
              - tenant_id
              - domains
      security: []
      operationId: postTollCseIndexDeclare
      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.'