ExchangeRebel FEC Committees 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: FEC Committees
paths:
  /toll/fec-committees:
    get:
      tags:
      - FEC Committees
      summary: FEC Committees service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a committee-level lookup includes, the price ($0.01 per lookup), the published criteria (fec-committee/v1), the pinned test corpus, and the scope statement (committee-level FEC data only, served from the D1 committee-level store of 108,359 rows; the itemized-donor leg is statutorily barred under 52 U.S.C. 30111(a)(4) and never served).'
      security: []
      operationId: getTollFecCommittees
      x-operation-id-source: derived
  /toll/fec-committees/health:
    get:
      tags:
      - FEC Committees
      summary: FEC Committees service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollFecCommitteesHealth
      x-operation-id-source: derived
  /toll/fec-committees/criteria:
    get:
      tags:
      - FEC Committees
      summary: The published FEC committee-level criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (fec-committee/v1): the three lookup forms, the scope block with the statutory donor bar, the recount figures, and the pinned public test corpus identity; every answer is reproducible from them.'
      security: []
      operationId: getTollFecCommitteesCriteria
      x-operation-id-source: derived
  /toll/fec-committees/corpus:
    get:
      tags:
      - FEC Committees
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for fec-committee/v1: corpus id fec-committee-corpus/v1 and its SHA-256 pin 15ce0acbf0183aefa55eac0db46c2d1408efb19ac9db141b934732dbed784507 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollFecCommitteesCorpus
      x-operation-id-source: derived
  /toll/fec-committees/precheck:
    post:
      tags:
      - FEC Committees
      summary: Free pre-check of one committee-level lookup form
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                caller:
                  type: string
                  description: Solana base58 wallet of the operator; keys the free allowance (100/day per wallet).
                committee_id:
                  type: string
                  description: 'FEC committee id: the letter C followed by 8 digits (e.g. C00401224). Form (a) of the lookup; mutually exclusive with name_query.'
                name_query:
                  type: string
                  description: Committee name search string, 2-80 characters. Form (b) of the lookup; mutually exclusive with committee_id.
                cycle:
                  type: integer
                  description: 'Election cycle: 2024 or 2026. Optional with committee_id / name_query; on its own it is form (c), the cycle aggregate lookup.'
              required:
              - caller
      responses:
        '200':
          description: Success. Returns the recounted store size, coverage, and the donor-bar scope statement, signed, with assessability of the submitted lookup form. No committee figures are returned. A donor-shaped request is refused free (400 DONOR-LEG-BARRED, 52 U.S.C. 30111(a)(4)). When the caller's free allowance is exhausted, the response is the /toll/fec-committees/lookup payment challenge instead.
      security: []
      operationId: postTollFecCommitteesPrecheck
      x-operation-id-source: derived
  /toll/fec-committees/lookup:
    post:
      tags:
      - FEC Committees
      summary: One committee-level FEC lookup (committee id, name search, or cycle aggregate)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                committee_id:
                  type: string
                  description: 'FEC committee id: the letter C followed by 8 digits (e.g. C00401224). Form (a) of the lookup; mutually exclusive with name_query.'
                name_query:
                  type: string
                  description: Committee name search string, 2-80 characters. Form (b) of the lookup; mutually exclusive with committee_id.
                cycle:
                  type: integer
                  description: 'Election cycle: 2024 or 2026. Optional with committee_id / name_query; on its own it is form (c), the cycle aggregate lookup.'
      responses:
        '200':
          description: 'Success. Returns the signed lookup answer in exactly one form: (a) a committee profile by FEC committee id with its registration identity and committee-reported cycle aggregate figures printed as factors, plus linked candidates; (b) a name search with matching committees capped at 25; or (c) cycle aggregates for 2024 or 2026. An unknown committee is answered NOT-FOUND - a stated absence - and that answer is the delivered lookup.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per committee-level lookup - each lookup you submit is charged at $0.01; the payment includes one committee-level lookup in exactly one form - (a) a committee profile by FEC committee id (C + 8 digits), with an optional cycle (2024 or 2026): the committee''s registration identity for the cycle(s) and its committee-reported cycle aggregate figures (total receipts, total disbursements, contribution and loan aggregates, cash on hand, debts, independent expenditures, coverage end date) printed as factors, plus linked candidates; (b) a name search (2-80 characters): matching committees with identity factors and totals presence, capped at 25 matches; or (c) a cycle aggregate lookup (2024 or 2026): committee-level counts and sums for that cycle. An unknown committee is answered NOT-FOUND - a stated absence - and that answer is the delivered lookup. No composite score is computed. Every answer carries its provenance (FEC bulk downloads, public domain; store vintage and the firsthand-recounted store size). This service serves committee-level data ONLY: itemized-donor data is statutorily barred under 52 U.S.C. 30111(a)(4) and is never served, and itemized disbursement / independent-expenditure records are not served in this phase. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (10000 USDC units = $0.01 per lookup) and a fresh memo (prefix fec-lookup-). Pay in USDC on Solana with the memo attached via the Solana Memo program, then resubmit the same request with the payment transaction in the X-Payment-Tx header and ?toll_memo=<memo>, re-sending the lookup in the request body. 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: postTollFecCommitteesLookup
      x-operation-id-source: derived
  /toll/fec-committees/metrics:
    get:
      tags:
      - FEC Committees
      summary: FEC Committees aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid lookups, distinct payers, free pre-checks today). Aggregate only - no payer identities, no submitted name-query strings.
      security: []
      operationId: getTollFecCommitteesMetrics
      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.'