ExchangeRebel Reputation 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: Reputation
paths:
  /toll/reputation:
    get:
      tags:
      - Reputation
      summary: Reputation-Integrity Verdict service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a check includes, the prices, the coverage, and the exclusions (it does not include identity verification and is not a guarantee of future behaviour).'
      security: []
      operationId: getTollReputation
      x-operation-id-source: derived
  /toll/reputation/health:
    get:
      tags:
      - Reputation
      summary: Reputation-Integrity Verdict service health
      responses:
        '200':
          description: Success. Returns service liveness and the verdict signer address.
      security: []
      operationId: getTollReputationHealth
      x-operation-id-source: derived
  /toll/reputation/formula:
    get:
      tags:
      - Reputation
      summary: The published cost-to-fake formula
      responses:
        '200':
          description: Success. Returns the full cost-to-fake formula and parameters (formula id cost-to-fake/v1) behind every verdict's cost-to-fake factor, with a worked example; anyone can recompute a verdict from the 402 Open Book's public record.
      security: []
      operationId: getTollReputationFormula
      x-operation-id-source: derived
  /toll/reputation/check:
    get:
      tags:
      - Reputation
      summary: Check one key's standing record on the 402 Open Book
      parameters:
      - name: subject
        in: query
        required: true
        schema:
          type: string
        description: Solana base58 pubkey of the key/identity to check.
      - name: caller
        in: query
        required: false
        schema:
          type: string
        description: Caller wallet; keys the free tier (100 free checks/day per wallet, rate-limited, same fields as a paid check).
      - name: liveness_challenge_id
        in: query
        required: false
        schema:
          type: string
        description: Optional liveness challenge id from POST /toll/reputation/liveness/challenge.
      - name: liveness_nonce
        in: query
        required: false
        schema:
          type: string
        description: Optional liveness proof nonce answering the challenge.
      - name: liveness_signature
        in: query
        required: false
        schema:
          type: string
        description: Optional ed25519 signature from the subject key over the liveness answer.
      responses:
        '200':
          description: 'Success. Returns a signed verdict: a verdict line plus every factor value (behaviour history, reviewer quality, stake, accumulated-work tier, age, decay status, tombstone/expulsion flags, a forgery-cost factor — what it would cost to fabricate this record — from a published formula, and a liveness result where obtained), with the record''s as-of time. No composite score. Free within the caller''s daily allowance; once the allowance is exhausted the $0.01 payment applies.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 buys one check of one key/identity. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (10000 USDC units = $0.01) and a fresh memo. Pay in USDC on Solana with the memo attached via the Solana Memo program, then resubmit the same check with the payment transaction in the X-Payment-Tx header and ?toll_memo=<memo>. 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: getTollReputationCheck
      x-operation-id-source: derived
  /toll/reputation/liveness/challenge:
    post:
      tags:
      - Reputation
      summary: Issue a fresh liveness challenge for a subject key
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                subject:
                  type: string
                  description: Solana base58 pubkey of the subject key.
              required:
              - subject
      responses:
        '200':
          description: Success. Returns challenge_id, random, k and expires_at. The subject answers with a nonce whose hash meets k bits plus an ed25519 signature from the subject key; the answer is presented on /toll/reputation/check.
      security: []
      operationId: postTollReputationLivenessChallenge
      x-operation-id-source: derived
  /toll/reputation/attest:
    post:
      tags:
      - Reputation
      summary: One check plus a portable on-chain attestation of the snapshot
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                subject:
                  type: string
                  description: Solana base58 pubkey of the key/identity to check.
              required:
              - subject
      responses:
        '200':
          description: 'Success. Returns everything in one check, plus one portable on-chain attestation of that standing snapshot: the verdict''s hash written to Solana by the service''s own wallet (the service absorbs the write cost inside the $5.00), verifiable by third parties without calling this service.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $5.00 buys one check plus one portable on-chain attestation of the snapshot. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (5000000 USDC units = $5.00) and a fresh memo. Pay in USDC on Solana with the memo attached via the Solana Memo program, then resubmit with the payment transaction in the X-Payment-Tx header and ?toll_memo=<memo>. The PAYMENT-REQUIRED response header carries the same object in x402 v2 form.'
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '5.00'
      security:
      - x402Payment: []
      operationId: postTollReputationAttest
      x-operation-id-source: derived
  /toll/reputation/metrics:
    get:
      tags:
      - Reputation
      summary: Reputation-Integrity Verdict aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, attestations, distinct payers, free checks today) and the review-rule text. Aggregate only — no payer identities.
      security: []
      operationId: getTollReputationMetrics
      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.'