ExchangeRebel ETF Distributions API

The ETF Distributions API from ExchangeRebel — 4 operation(s) for etf distributions.

GitHub OpenAPI

Operations 4

GET /toll/etf/distributions/{ticker} Fetch an ETF's full distribution history #
POST /toll/etf/distributions/simulate Simulate an income portfolio and its distribution flywheel #
GET /toll/etf/screener Top ETFs ranked by annualized distribution $/share (free) #
GET /toll/etf/health Service info + endpoint catalog #

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-etf-distributions-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-etf-distributions-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: ETF Distributions
paths:
  /toll/etf/distributions/{ticker}:
    get:
      tags:
      - ETF Distributions
      summary: Fetch an ETF's full distribution history
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                ticker: MSTW
                frequency: weekly
                latest:
                  ex_date: '2026-10-05'
                  record_date: '2026-10-05'
                  pay_date: '2026-10-06'
                  amount_per_share: 0.077545
                  currency: USD
                history:
                - ex_date: '2026-10-05'
                  pay_date: '2026-10-06'
                  amount_per_share: 0.077545
                - ex_date: '2026-09-28'
                  pay_date: '2026-09-29'
                  amount_per_share: 0.093484
                - ex_date: '2026-09-21'
                  pay_date: '2026-09-22'
                  amount_per_share: 0.04312
                - ex_date: '2026-09-14'
                  pay_date: '2026-09-15'
                  amount_per_share: 0.081
                - ex_date: '2026-09-07'
                  pay_date: '2026-09-08'
                  amount_per_share: 0.066
                history_count: 5
                trailing_4_avg: 0.073787
                trailing_12_avg: 0.07223
                annualized_yield_pct: null
                yield_price_used: null
                source: Roundhill official site
                source_url: https://example.com
                coverage:
                  first_ex_date: '2026-09-07'
                  latest_ex_date: '2026-10-05'
                cached: false
                payment_method: payai
                envelope:
                  v: 1
                  service: etf-distributions
                  as_of: '2026-10-12'
                  source: Roundhill official site
                  grade: primary
                  capture_cadence: weekly
                  changes:
                    supported: true
                    endpoint: /changes?since=<ISO8601>
                    price_usd: 0.01
                    basis: ex_date
        '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: ticker
        in: path
        required: true
        schema:
          type: string
        description: ETF ticker
      - name: price
        in: query
        required: false
        schema:
          type: string
        description: Optional current price for yield math
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: getTollEtfDistributionsByTicker
      x-operation-id-source: derived
  /toll/etf/distributions/simulate:
    post:
      tags:
      - ETF Distributions
      summary: Simulate an income portfolio and its distribution flywheel
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                payment_method: payai
                verdict:
                  weekly_income_usd: 7.378725
                flywheel:
                  compounding: false
                envelope:
                  v: 1
                  service: etf-distributions
                  as_of: '2026-10-12'
                  source: 'YieldRebel dataset (issuer pages: Roundhill, YieldMax, Defiance; press releases)'
                  grade: primary
                  capture_cadence: weekly
                  changes:
                    supported: true
                    endpoint: /changes?since=<ISO8601>
                    price_usd: 0.01
                    basis: ex_date
        '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>''.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                allocations:
                  type: array
                  description: 'array (required) - holdings: {ticker, shares} | {ticker, units, price_per_share} | {ticker, amount_usd, price_per_share} (price_per_share required for units/amount forms)'
                  items:
                    type: string
                horizon_years:
                  type: integer
                  description: integer 1-10, default 5
                reinvest:
                  type: boolean
                  description: boolean - default true (flywheel compounding; linear projection when off or any holding lacks a price)
              required:
              - allocations
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: postTollEtfDistributionsSimulate
      x-operation-id-source: derived
  /toll/etf/screener:
    get:
      tags:
      - ETF Distributions
      summary: Top ETFs ranked by annualized distribution $/share (free)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      parameters:
      - name: min_yield
        in: query
        required: false
        schema:
          type: string
        description: Minimum annualized yield
      - name: frequency
        in: query
        required: false
        schema:
          type: string
        description: Payout frequency filter
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Result limit
      security: []
      operationId: getTollEtfScreener
      x-operation-id-source: derived
  /toll/etf/health:
    get:
      tags:
      - ETF Distributions
      summary: Service info + endpoint catalog
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollEtfHealth
      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.'