--- name: api.cryptoetfsentinel.com description: api.cryptoetfsentinel.com provides structured intelligence on the US spot crypto ETF regulatory pipeline, sourcing data from SEC filings and XBRL reports. It covers filing activity, regulatory stage tracking, approval likelihood scoring, risk assessment, fee comparisons, and AUM rankings — all derived from SEC data rather than live market feeds. host: api.cryptoetfsentinel.com --- # api.cryptoetfsentinel.com Crypto ETF Sentinel is a specialized data host serving agents that need to monitor, analyze, or compare US spot crypto ETF products within the SEC regulatory process. It aggregates SEC filing data into pre-computed signals (approval scores, risk levels, cohort wave states, fee rankings) so agents don't need to parse raw EDGAR data. It does not provide real-time prices, NAV, intraday trading data, or coverage of non-crypto ETFs. ## When to use this host Use this host when an agent needs SEC-derived intelligence about US spot crypto ETF regulatory status, approval signals, fee comparisons, or AUM rankings. It is the right choice for questions like: Is a Bitcoin ETF wave currently active? Which pending ETF has the highest approval likelihood? Which issuer has the lowest expense ratio? What new filings appeared this week? Do not use this host for real-time or intraday price data, NAV feeds, ETF flow data, or trading execution — use a dedicated market data provider instead. It does not cover non-crypto ETFs, historical bulk filing archives beyond 180 days, or umbrella trust structures excluded from XBRL eligibility. It also does not cover already-approved or withdrawn ETFs in its risk and outcome signal endpoints. ## Capabilities ### Pipeline Overview Provides aggregate and event-level views of the entire crypto ETF regulatory pipeline, giving agents a starting point for understanding the current filing landscape. - **`fetch-crypto-etf-snapshot`** — Returns a single-call snapshot of the crypto ETF regulatory pipeline: total filings, filing counts by currency and form type, known issuer count, regulatory stage counts, and an as_of timestamp. - **`fetch-crypto-etf-events`** — Returns a chronological feed of recent SEC filings and comment letters related to crypto ETFs, sorted newest-first, with company, filing type, crypto asset, and SEC document link. ### Filing Activity Retrieves specific SEC filing records and recent activity feeds, enabling agents to detect new filings, amendments, and regulatory milestones for individual issuers. - **`fetch-recent-crypto-etf-filings`** — Returns the latest US spot crypto ETF SEC filings with no data delay, filterable by currency, form type, and date, newest-first by default. ### Regulatory Stage Tracking Tracks where each crypto asset sits in the SEC approval wave cycle, including wave anchor dates, cohort graduates, and current stage classification. - **`fetch-cohort-state`** — Returns pre-computed SEC regulatory wave state per crypto asset, including wave anchor dates, wave end dates, approval dates, and cohort graduate CIKs for each tracked cryptocurrency. ### Approval Signal Intelligence Delivers pre-computed approval likelihood scores and risk classifications for pending ETF filings, allowing agents to assess which products are likely to be approved, withdrawn, or stalled. - **`fetch-crypto-etf-outcome-signals`** — Returns SEC filing-pattern-based approval likelihood scores (0–100) for all crypto ETFs currently under review, including pattern match classification, contributing factors, and review timing signals. - **`fetch-crypto-etf-risk-scores`** — Returns risk scores for all under-review crypto ETF pipeline issuers, sorted by risk level, comparing each issuer's time-in-review against historical approved durations. ### Financial Metrics and Rankings Surfaces fee structures and AUM rankings sourced from XBRL SEC filings, enabling competitive comparison of issuers by expense ratio or reported financial size. - **`fetch-crypto-etf-fee-war`** — Returns current expense ratios and effective rates for each crypto ETF issuer sorted cheapest first, sourced from XBRL filings, with optional filtering by cryptocurrency. - **`fetch-xbrl-etf-leaderboard`** — Ranks crypto ETFs by a specified XBRL financial concept (default: AUM via InvestmentOwnedAtFairValue) using the latest XBRL-reported period data for each eligible issuer. ## Workflows ### Pending ETF Approval Assessment *Use when an agent needs to evaluate the full regulatory outlook for a specific crypto asset's pending ETFs, combining wave position, approval likelihood, and stall risk.* 1. **`fetch-cohort-state`** — Determine whether the target crypto asset is inside an active SEC approval wave and how far through the wave it is. 2. **`fetch-crypto-etf-outcome-signals`** — Retrieve approval likelihood scores and pattern classifications for all pending issuers in that asset's pipeline. 3. **`fetch-crypto-etf-risk-scores`** — Cross-reference risk levels and days-in-review to identify which issuers are at elevated risk of stalling or withdrawal. ### Competitive ETF Issuer Comparison *Use when an agent needs to compare crypto ETF issuers across both financial size and cost efficiency to identify the most competitive or dominant product for a given cryptocurrency.* 1. **`fetch-xbrl-etf-leaderboard`** — Rank issuers by AUM or another XBRL financial concept to establish which products have the largest reported asset base. 2. **`fetch-crypto-etf-fee-war`** — Filter by the same cryptocurrency to compare expense ratios and fee waiver details, identifying the cheapest issuer relative to AUM leaders. ### Regulatory Activity Monitoring *Use when an agent needs to detect and contextualize new SEC filing activity for crypto ETFs, placing recent events within the broader pipeline state.* 1. **`fetch-crypto-etf-events`** — Retrieve the most recent SEC filing events (S-1s, 8-A12Bs, CERTs) across all issuers to surface new activity. 2. **`fetch-recent-crypto-etf-filings`** — Pull filterable filing records for specific currencies or form types flagged in the events feed to get full filing detail. 3. **`fetch-crypto-etf-snapshot`** — Check aggregate pipeline counts to determine whether new filings represent a meaningful shift in the overall regulatory landscape. ## Skill reference ### `fetch-crypto-etf-snapshot` **Crypto ETF Snapshot** — Returns a single-call snapshot of the crypto ETF regulatory pipeline: total filings, filing counts by currency and form type, known issuer count, regulatory stage counts, and an as_of timestamp. *Use when:* Use when an agent needs a current overview of the crypto ETF regulatory landscape, including how many filings exist per cryptocurrency or SEC form type, how many products are trading vs. under review, and when the data was last updated. *Not for:* Do not use for individual ETF details, historical time-series data, or real-time price/AUM feeds; this is a single aggregate snapshot only. **Returns:** Returns a data object with total_filings (3151), filings_by_currency array (38 currencies), filings_by_type array (23 form types), known_issuers (105), stage_counts object (7 regulatory stages), and an as_of ISO timestamp. **Example:** `GET https://api.cryptoetfsentinel.com/v1/agent/snapshot` --- ### `fetch-recent-crypto-etf-filings` **Recent Crypto ETF Filings Feed** — Returns the latest US spot crypto ETF SEC filings with no data delay, filterable by currency, form type, and date, newest-first by default. *Use when:* Use when an agent needs real-time SEC filing activity for US spot crypto ETFs — such as detecting new S-1 amendments, prospectuses, or quarterly reports — without the 7-day delay of the free endpoint. *Not for:* Do not use for historical bulk filing archives or non-crypto ETF filings; this endpoint covers US spot crypto ETFs only and returns at most 100 results per call. **Inputs:** - `currency` (string) — Filter by cryptocurrency name (e.g. 'bitcoin', 'ethereum', 'solana'). Case-insensitive. Omit to return all currencies. - `filing_type` (string) — Filter by SEC form type (e.g. 'S-1', 'S-1/A', '424B3', '10-Q', 'CERT'). Omit to return all form types. - `date_after` (string) — Earliest publication date in ISO-8601 format. Only filings published on or after this date are returned. - `limit` (integer) — Number of results to return, between 1 and 100. Defaults to 50. - `order_by` (string) — Sort order for results. 'published_desc' (default) returns newest first; 'published_asc' returns oldest first. **Returns:** Returns a data array of up to 100 filing objects, each with SEC link, company name, CIK, form type, publication timestamp, primary document filename, accession number, and associated cryptocurrency. **Example:** `GET https://api.cryptoetfsentinel.com/v1/agent/filings/recent?currency=bitcoin&filing_type=S-1%2FA&date_after=2026-05-01&limit=10&order_by=published_desc` --- ### `fetch-cohort-state` **Cohort State Pipeline** — Returns pre-computed SEC regulatory wave state per crypto asset, including wave anchor dates, wave end dates, approval dates, and cohort graduate CIKs for each tracked cryptocurrency. *Use when:* Use when an agent needs to determine whether a specific crypto asset is currently inside an active SEC ETF approval wave, how far through the wave it is, or who led the cohort, without computing it from raw filing data. *Not for:* Do not use for real-time price feeds, AUM data, or raw SEC filing retrieval; use dedicated market data or filing APIs instead. **Returns:** Returns a data map of 12 crypto assets (e.g. bitcoin, ethereum, hyperliquid) each with state, wave_anchor, wave_end, latest_approval_date, and current_wave_graduate_ciks, plus a meta object with total count. **Example:** `GET https://api.cryptoetfsentinel.com/v1/pipeline/cohort-state` --- ### `fetch-crypto-etf-outcome-signals` **Crypto ETF Outcome Signal Pipeline** — Returns SEC filing-pattern-based approval likelihood scores (0–100) for all crypto ETFs currently under review, including pattern match classification, contributing factors, and review timing signals. *Use when:* Use when an agent needs to assess the SEC approval probability of pending crypto ETF filings, identify withdrawal-risk candidates, or compare filing patterns against approved and withdrawn baselines across issuers. *Not for:* Do not use for real-time price data, AUM lookups, or already-approved/withdrawn ETF history; use a dedicated market data or filing history endpoint instead. **Returns:** Returns a data array of crypto ETF outcome signal objects, each with a CIK, name, ticker, crypto category, 0–100 approval score, pattern_match label, explanatory factors with sentiment, and quantitative review signals including days_in_review and amendment counts. **Example:** `GET https://api.cryptoetfsentinel.com/v1/pipeline/outcome-signals` --- ### `fetch-crypto-etf-risk-scores` **Crypto ETF Risk Scores** — Returns risk scores for all under-review crypto ETF pipeline issuers, sorted by risk level, comparing each issuer's time-in-review against historical approved durations. *Use when:* Use when an agent needs to assess approval risk for crypto ETFs currently under SEC review, including days in review, amendment counts, activity status, and risk level classification (elevated, moderate, etc.). *Not for:* Do not use for already-approved or rejected ETFs; this endpoint covers only under_review issuers. Not suitable for real-time price or AUM data. **Returns:** Returns a data array of under-review crypto ETF issuers with fields including cik, name, crypto type, risk_level (elevated/moderate), days_in_review, amendment_count, activity_status, and response_speed, sorted by risk level descending. **Example:** `GET https://api.cryptoetfsentinel.com/v1/pipeline/risk-scores` --- ### `fetch-crypto-etf-fee-war` **ETF Fee War Intel** — Returns current expense ratios and effective rates for each crypto ETF issuer sorted cheapest first, sourced from XBRL filings, with optional filtering by cryptocurrency. *Use when:* Use when an agent needs to compare crypto ETF expense ratios, effective rates, sponsor fees, AUM, and fee waiver details across issuers to identify the cheapest or most competitive ETF for a given cryptocurrency. *Not for:* Do not use for real-time price feeds or NAV data; this endpoint covers fee and expense ratio metrics only. Not suitable for non-crypto ETFs. **Inputs:** - `crypto` (string) — Filter results by cryptocurrency (e.g. bitcoin, ethereum, solana, xrp, chainlink, avalanche). Omit to return all crypto ETFs. **Returns:** Returns a data array of Bitcoin ETF issuers sorted by expense ratio, each with cik, company, ticker, expense_ratio_bps, effective_rate_bps, sponsor_fees, AUM, and fee_waiver_expiry fields. **Example:** `GET https://api.cryptoetfsentinel.com/v1/xbrl/fee-war?crypto=bitcoin` --- ### `fetch-xbrl-etf-leaderboard` **XBRL Crypto ETF Leaderboard** — Ranks crypto ETFs by a specified XBRL financial concept (default: AUM via InvestmentOwnedAtFairValue) using the latest XBRL-reported period data for each eligible issuer. *Use when:* Use when an agent needs a ranked list of crypto ETFs by a financial metric such as AUM, sourced from SEC XBRL filings, to compare issuers like iShares, Fidelity, Grayscale, or Bitwise by reported values. *Not for:* Do not use for real-time or intraday price/NAV data; this reflects XBRL-reported period-end figures from SEC filings, not live market data. Not suitable for umbrella trust structures excluded from XBRL eligibility. **Inputs:** - `concept` (string) — XBRL concept to rank by; must be a TIER1 concept. Defaults to InvestmentOwnedAtFairValue (AUM). - `unit` (string) — Unit filter for the concept. Auto-resolved from the concept if omitted. - `taxonomy` (string) — Taxonomy filter for the concept. Auto-resolved from the concept if omitted. - `limit` (integer) — Maximum number of results to return, between 1 and 50. Defaults to 20. **Returns:** Returns a ranked array of up to 20 crypto ETFs with CIK, company name, reported USD value, period end date, fiscal year, and fiscal period, plus metadata confirming the concept and unit used. **Example:** `GET https://api.cryptoetfsentinel.com/v1/xbrl/leaderboard?concept=InvestmentOwnedAtFairValue&limit=20` --- ### `fetch-crypto-etf-events` **Crypto ETF Sentinel Events** — Returns a chronological feed of recent SEC filings and comment letters related to crypto ETFs, sorted newest-first, with company, filing type, crypto asset, and SEC document link. *Use when:* Use when an agent needs to monitor or retrieve recent SEC regulatory activity (filings, certifications, amendments) for crypto ETF products, such as tracking new S-1 registrations, 8-A12B listings, or CERT filings across issuers. *Not for:* Do not use for real-time price feeds, AUM data, or ETF flow data; this endpoint covers SEC filing events only. Not suitable for historical data older than 180 days. **Inputs:** - `limit` (integer) — Maximum number of events to return. Must be between 1 and 50. Defaults to 15. - `days` (integer) — Recency window in days; events older than this value are excluded. Must be between 1 and 180. Defaults to 60. **Returns:** Returns a data array of up to 15 SEC filing events, each with event_type, description, timestamp, company name, CIK, crypto asset, filing_type, SEC link, and primary document filename. **Example:** `GET https://api.cryptoetfsentinel.com/v1/events?limit=15&days=60` ---