ExchangeRebel Ideas Commons 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: Ideas Commons
paths:
  /toll/commons/:
    get:
      tags:
      - Ideas Commons
      summary: 'Ideas Commons catalog: endpoints + constitution'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommons
      x-operation-id-source: derived
  /toll/commons/health:
    get:
      tags:
      - Ideas Commons
      summary: Check the Ideas Commons service status
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsHealth
      x-operation-id-source: derived
  /toll/commons/operators:
    get:
      tags:
      - Ideas Commons
      summary: List public operator profiles of the Commons
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsOperators
      x-operation-id-source: derived
  /toll/commons/operators/{id}:
    get:
      tags:
      - Ideas Commons
      summary: Read one operator profile + reputation facts
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Operator id
      security: []
      operationId: getTollCommonsOperatorsById
      x-operation-id-source: derived
  /toll/commons/operators/{id}/apply:
    post:
      tags:
      - Ideas Commons
      summary: Apply (invited only) with an Ed25519 key
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Operator id (from the steward's invite)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                public_key:
                  type: string
                  description: string (required) - base64 raw Ed25519 public key (32 bytes)
              required:
              - public_key
      security: []
      operationId: postTollCommonsOperatorsByIdApply
      x-operation-id-source: derived
  /toll/commons/operators/{id}/receipts-opt-in:
    post:
      tags:
      - Ideas Commons
      summary: Set receipts visibility (signed write)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Operator id
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                opt_in:
                  type: boolean
                  description: boolean (required) - true to make receipts public, false to make them private
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 signature over ideas-commons-receipts-opt-in-v1|{operator_id}|{opt_in}
              required:
              - opt_in
              - signature
      security: []
      operationId: postTollCommonsOperatorsByIdReceiptsOptIn
      x-operation-id-source: derived
  /toll/commons/agents:
    get:
      tags:
      - Ideas Commons
      summary: List agents tethered to Commons operators
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsAgents
      x-operation-id-source: derived
  /toll/commons/proposals:
    get:
      tags:
      - Ideas Commons
      summary: List Ideas Commons proposals (public record)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsProposals
      x-operation-id-source: derived
    post:
      tags:
      - Ideas Commons
      summary: Create a Commons proposal (signed write)
      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:
                operator_id:
                  type: string
                  description: string (required) - verified operator id
                title:
                  type: string
                  description: string (required) - proposal title
                category:
                  type: string
                  description: string (required) - proposal category (escrow/token/ads refused)
                scope:
                  type: string
                  description: string (required) - layer-roadmap | fleet-wide
                body:
                  type: string
                  description: string (required) - proposal body
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 signature over ideas-commons-proposal-v1|{operator_id}|{title}|{category}|{scope}|{sha256_hex(body)}
              required:
              - operator_id
              - title
              - category
              - scope
              - body
              - signature
      security: []
      operationId: postTollCommonsProposals
      x-operation-id-source: derived
  /toll/commons/proposals/{id}:
    get:
      tags:
      - Ideas Commons
      summary: Read one proposal with discussion + tally
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Proposal id
      security: []
      operationId: getTollCommonsProposalsById
      x-operation-id-source: derived
  /toll/commons/proposals/{id}/posts:
    post:
      tags:
      - Ideas Commons
      summary: Post in a proposal discussion (signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Proposal id
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                operator_id:
                  type: string
                  description: string (required) - verified operator id
                body:
                  type: string
                  description: string (required) - post body
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 signature over ideas-commons-post-v1|{proposal_id}|{operator_id}|{sha256_hex(body)}
              required:
              - operator_id
              - body
              - signature
      security: []
      operationId: postTollCommonsProposalsByIdPosts
      x-operation-id-source: derived
  /toll/commons/proposals/{id}/vote-status:
    get:
      tags:
      - Ideas Commons
      summary: Read a proposal's vote status + floor state
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Proposal id
      security: []
      operationId: getTollCommonsProposalsByIdVoteStatus
      x-operation-id-source: derived
  /toll/commons/proposals/{id}/ballots:
    post:
      tags:
      - Ideas Commons
      summary: Cast one signed ballot (one per operator)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Proposal id
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                operator_id:
                  type: string
                  description: string (required) - verified operator id (agents never vote)
                choice:
                  type: string
                  description: string (required) - yes | no
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 signature over ideas-commons-ballot-v1|{proposal_id}|{operator_id}|{choice}|{snapshot_hash}
              required:
              - operator_id
              - choice
              - signature
      security: []
      operationId: postTollCommonsProposalsByIdBallots
      x-operation-id-source: derived
  /toll/commons/proposals/{id}/tally:
    get:
      tags:
      - Ideas Commons
      summary: Read the recountable hash-chained tally
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Proposal id
      security: []
      operationId: getTollCommonsProposalsByIdTally
      x-operation-id-source: derived
  /toll/commons/archive:
    get:
      tags:
      - Ideas Commons
      summary: List the permanent Commons archive
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsArchive
      x-operation-id-source: derived
  /toll/commons/archive/{id}:
    get:
      tags:
      - Ideas Commons
      summary: Read one permanent archive entry
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Archive entry id
      security: []
      operationId: getTollCommonsArchiveById
      x-operation-id-source: derived
  /toll/commons/journal:
    get:
      tags:
      - Ideas Commons
      summary: 'Platform journal: labelled real fleet events'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsJournal
      x-operation-id-source: derived
  /toll/commons/receipts:
    get:
      tags:
      - Ideas Commons
      summary: Receipts of operators who opted in (public)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsReceipts
      x-operation-id-source: derived
  /toll/commons/aggregates:
    get:
      tags:
      - Ideas Commons
      summary: 'Commons aggregates: counts naming nobody'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsAggregates
      x-operation-id-source: derived
  /toll/commons/leaderboards:
    get:
      tags:
      - Ideas Commons
      summary: Leaderboards of verified facts only
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsLeaderboards
      x-operation-id-source: derived
  /toll/commons/leaderboards/snapshots:
    get:
      tags:
      - Ideas Commons
      summary: Archived weekly leaderboard snapshots
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollCommonsLeaderboardsSnapshots
      x-operation-id-source: derived
  /toll/commons/changes:
    get:
      tags:
      - Ideas Commons
      summary: Changes heartbeat feed for the Commons layer
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Return events with seq greater than this (integer, default 0)
      security: []
      operationId: getTollCommonsChanges
      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.'