ExchangeRebel Macro & Civic API

The Macro & Civic API from ExchangeRebel — 7 operation(s) for macro & civic.

GitHub OpenAPI

Operations 7

GET /toll/macro/cpi US CPI series (BLS, public domain) #
GET /toll/macro/unemployment US unemployment series (BLS, public domain) #
GET /toll/macro/payrolls US payrolls series (BLS, public domain) #
GET /toll/macro/fed-rate Federal funds rate (FRED, public domain) #
GET /toll/macro/bills Congress bills (Congress.gov, public domain) #
GET /toll/macro/census/population Population data (US Census, public domain) #
GET /toll/macro/health Service status, sources, tolls #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/exchangerebel-com:exchangerebel-com-macro-civic-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

exchangerebel-com-macro-civic-api-openapi.yml Raw ↑
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: Macro & Civic
paths:
  /toll/macro/cpi:
    get:
      tags:
      - Macro & Civic
      summary: US CPI series (BLS, public domain)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                series: CUUR0000SA0
                title: 'Consumer Price Index for All Urban Consumers: All Items (CPI-U)'
                unit: index
                change_unit: percent
                points:
                - date: '2025-06-01'
                  value: 300.5
                  pct_change_mom: null
                  pct_change_yoy: null
                - date: '2025-07-01'
                  value: 303.1
                  pct_change_mom: 0.87
                  pct_change_yoy: null
                point_count: 2
                range:
                  start: 2025-01
                  end: 2025-12
                source: bls
                attribution: U.S. Bureau of Labor Statistics (bls.gov) — public domain
                cached: true
                stale: false
                paid_via: payai
                envelope:
                  v: 1
                  service: macro-civic
                  as_of: '2026-10-12T00:00:00Z'
                  source: bls
                  grade: official
                  capture_cadence: daily
                  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>''.'
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
        description: Start period
      - name: end
        in: query
        required: false
        schema:
          type: string
        description: End period
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: getTollMacroCpi
      x-operation-id-source: derived
  /toll/macro/unemployment:
    get:
      tags:
      - Macro & Civic
      summary: US unemployment series (BLS, public domain)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                series: LNS14000000
                title: Unemployment Rate, seasonally adjusted
                unit: percent
                change_unit: percentage_points
                points: []
                point_count: 0
                range:
                  start: 2025-01
                  end: 2025-12
                source: bls
                attribution: U.S. Bureau of Labor Statistics (bls.gov) — public domain
                cached: true
                stale: false
                paid_via: payai
                envelope:
                  v: 1
                  service: macro-civic
                  as_of: '2026-10-12T00:00:00Z'
                  source: bls
                  grade: official
                  capture_cadence: daily
                  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>''.'
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
        description: Start period
      - name: end
        in: query
        required: false
        schema:
          type: string
        description: End period
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: getTollMacroUnemployment
      x-operation-id-source: derived
  /toll/macro/payrolls:
    get:
      tags:
      - Macro & Civic
      summary: US payrolls series (BLS, public domain)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                series: CES0000000001
                title: Total Nonfarm Payrolls, seasonally adjusted
                unit: thousands
                change_unit: percent
                points:
                - date: '2025-06-01'
                  value: 159000
                  pct_change_mom: null
                  pct_change_yoy: null
                - date: '2025-07-01'
                  value: 159100
                  pct_change_mom: 0.06
                  pct_change_yoy: null
                point_count: 2
                range:
                  start: 2025-01
                  end: 2025-12
                source: bls
                attribution: U.S. Bureau of Labor Statistics (bls.gov) — public domain
                cached: true
                stale: true
                paid_via: payai
                envelope:
                  v: 1
                  service: macro-civic
                  as_of: '2026-10-01T00:00:00Z'
                  source: bls
                  grade: official
                  capture_cadence: daily
                  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>''.'
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
        description: Start period
      - name: end
        in: query
        required: false
        schema:
          type: string
        description: End period
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: getTollMacroPayrolls
      x-operation-id-source: derived
  /toll/macro/fed-rate:
    get:
      tags:
      - Macro & Civic
      summary: Federal funds rate (FRED, public domain)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                target_range_lower: 3.75
                target_range_upper: 4
                effective_date: '2026-10-09'
                series:
                - DFEDTARL
                - DFEDTARU
                series_label: Federal Funds Target Range
                unit: percent
                source: fred
                attribution: Federal Reserve Bank of St. Louis FRED — public domain
                fetched_at: '2026-10-12T00:00:00Z'
                cached: false
                paid_via: payai
                envelope:
                  v: 1
                  service: macro-civic
                  as_of: '2026-10-12T00:00:00Z'
                  source: fred
                  grade: official
                  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>''.'
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: getTollMacroFedRate
      x-operation-id-source: derived
  /toll/macro/bills:
    get:
      tags:
      - Macro & Civic
      summary: Congress bills (Congress.gov, public domain)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                congress: 119
                bills:
                - congress: 119
                  type: hr
                  number: '1234'
                  title: A bill to do things
                  update_date: '2026-10-10T12:00:00Z'
                  latest_action: Referred to committee.
                  latest_action_date: '2026-10-09'
                  url: https://www.congress.gov/bill/119th-congress/hr-bill/1234
                - congress: 119
                  type: s
                  number: '567'
                  title: Another bill
                  update_date: null
                  latest_action: null
                  latest_action_date: null
                  url: https://www.congress.gov/bill/119th-congress/s-bill/567
                count: 2
                source: congress.gov
                attribution: Congress.gov (Library of Congress) — public domain
                fetched_at: '2026-10-12T00:00:00Z'
                cached: false
                paid_via: payai
                envelope:
                  v: 1
                  service: macro-civic
                  as_of: '2026-10-12T00:00:00Z'
                  source: congress.gov
                  grade: official
                  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>''.'
      parameters:
      - name: congress
        in: query
        required: false
        schema:
          type: string
        description: Congress number
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Result limit
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: getTollMacroBills
      x-operation-id-source: derived
  /toll/macro/census/population:
    get:
      tags:
      - Macro & Civic
      summary: Population data (US Census, public domain)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                dataset: 2023 ACS 5-year
                variable: B01003_001E
                variable_label: Total population
                states:
                - state: CA
                  state_fips: '06'
                  state_name: California
                  population: 39431263
                - state: TX
                  state_fips: '48'
                  state_name: Texas
                  population: 30029572
                - state: PR
                  state_fips: '72'
                  state_name: Puerto Rico
                  population: 3262054
                state_count: 3
                source: census
                attribution: U.S. Census Bureau, 2023 American Community Survey 5-year estimates — public domain
                fetched_at: '2026-10-12T00:00:00Z'
                cached: false
                paid_via: payai
                envelope:
                  v: 1
                  service: macro-civic
                  as_of: '2026-10-12T00:00:00Z'
                  source: census
                  grade: official
                  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>''.'
      parameters:
      - name: state
        in: query
        required: false
        schema:
          type: string
        description: State filter
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: getTollMacroCensusPopulation
      x-operation-id-source: derived
  /toll/macro/health:
    get:
      tags:
      - Macro & Civic
      summary: Service status, sources, tolls
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollMacroHealth
      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.'