ExchangeRebel Trending Digest 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: Trending Digest
paths:
  /toll/trending-digest:
    get:
      tags:
      - Trending Digest
      summary: Trending Digest service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what the digest is and is not (within-source category-share movement only; no cross-source ranking, no composite score), the cadence, the routes, and the pinned corpus identity. The digest is a FREE publication - no per-call fee exists.'
      security: []
      operationId: getTollTrendingDigest
      x-operation-id-source: derived
  /toll/trending-digest/health:
    get:
      tags:
      - Trending Digest
      summary: Trending Digest service health
      responses:
        '200':
          description: Success. Returns liveness, the criteria id (trending-digest/v1) and the corpus pin.
      security: []
      operationId: getTollTrendingDigestHealth
      x-operation-id-source: derived
  /toll/trending-digest/criteria:
    get:
      tags:
      - Trending Digest
      summary: The published trending-digest criteria
      responses:
        '200':
          description: 'Success. Returns the criteria document (trending-digest/v1) serialised from the engine''s own config: the legs and their licences, the within-source method, the load/trend states (NOT-LOADED, NO-TREND-CLAIM), and the pinned public test corpus identity.'
      security: []
      operationId: getTollTrendingDigestCriteria
      x-operation-id-source: derived
  /toll/trending-digest/corpus:
    get:
      tags:
      - Trending Digest
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity: corpus trending-digest-corpus/v1, pin 6fcab97ddd5ef05dc659ee1501649e76bf8b890e8959536c5ae5767c31a24494 (verifiable with the published harness).'
      security: []
      operationId: getTollTrendingDigestCorpus
      x-operation-id-source: derived
  /toll/trending-digest/digest:
    get:
      tags:
      - Trending Digest
      summary: The current digest edition (free, signed)
      responses:
        '200':
          description: 'Success. Returns the current weekly digest edition: the per-leg table with each leg''s load state and trend state computed within that source across its own two compared releases (named and dated). Legs without a loaded release pair state NOT-LOADED / NO-TREND-CLAIM - never a synthesised trend. The edition is signed (ed25519) by the service wallet when signing is configured.'
      security: []
      operationId: getTollTrendingDigestDigest
      x-operation-id-source: derived
  /toll/trending-digest/sample:
    get:
      tags:
      - Trending Digest
      summary: The FIXTURE reference digest (free)
      responses:
        '200':
          description: 'Success. Returns a FIXTURE reference digest generated from the pinned corpus release-pairs - labelled FIXTURE in the body (fixture: true), illustrative values, NOT source data, unsigned.'
      security: []
      operationId: getTollTrendingDigestSample
      x-operation-id-source: derived
  /toll/trending-digest/request:
    post:
      tags:
      - Trending Digest
      summary: Validate a digest query and read the leg table (free)
      responses:
        '200':
          description: Success. Returns the leg table for the requested legs (leg_id, provider, licence, load_state, trend_state). A malformed body is refused FREE with a named refusal (400); the barred radar-api-data leg form is refused as BARRED:radar-api-data. Nothing is charged - the digest is a free publication.
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                leg:
                  type: string
                  description: One leg_id to read.
                legs:
                  type: array
                  items:
                    type: string
                  description: Several leg_ids to read.
      operationId: postTollTrendingDigestRequest
      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.'