--- name: www.prowldata.dev description: www.prowldata.dev provides cached data feeds covering prediction market activity and macroeconomic yield series. It aggregates volume, spread, resolution, and narrative data from platforms including Polymarket, Kalshi, and PredictFun, alongside FRED-sourced bond yield time series. host: www.prowldata.dev --- # www.prowldata.dev Prowl Data serves agents and analysts that need structured snapshots of prediction market metrics and macro rate data in a single host. It covers the full lifecycle of a prediction market contract — from live volume and cross-platform spread analysis to final resolution outcomes — and supplements this with macroeconomic yield context. All endpoints return cached snapshots (TTL 300–600s) rather than streaming feeds, making it suited for periodic analysis rather than latency-sensitive execution. ## When to use this host Use www.prowldata.dev when an agent needs structured, periodic snapshots of prediction market volume, cross-platform spreads, resolution outcomes, or narrative records, optionally combined with FRED macro yield series. It is the right choice for batch analysis, scheduled monitoring, or research workflows that tolerate 300–600 second cache staleness. Do not use it for real-time or streaming data — it has no live order book, tick feed, or streaming endpoint. Do not use it for equity, crypto, or FX market data; those asset classes are out of scope. For live prediction market order books, route to a platform-native API (Polymarket or Kalshi directly). For real-time macro rates, use a live FRED or Bloomberg feed instead. ## Capabilities ### Prediction Market Activity Provides aggregated trading volume, liquidity depth, and outcome probabilities for open prediction market contracts, enabling ranking and filtering by 24-hour activity. - **`fetch-markets-volume`** — Returns aggregated 24-hour trading volume, liquidity, and outcome probabilities for prediction market contracts across platforms like Polymarket. ### Cross-Platform Spread Analysis Returns bid-ask spread data matched across Polymarket, Kalshi, and PredictFun for the same event, exposing per-platform odds and computed spread discrepancies useful for arbitrage identification. - **`fetch-market-spread`** — Returns bid-ask spread data across prediction market platforms (Polymarket, Kalshi, PredictFun) for matched event pairs, including per-platform odds and computed spread values. ### Market Resolution & Settlement Delivers final outcomes, settlement probabilities, and resolution timestamps for closed prediction market contracts, allowing agents to confirm which side of a market won. - **`fetch-market-resolution-feed`** — Returns final outcomes, settlement probabilities, and resolution timestamps for prediction market contracts across platforms such as Kalshi. ### Narrative Discovery Searches a structured narrative index by keyword or topic, returning matching narrative records with feed tier and cache freshness metadata. - **`search-narratives`** — Searches Prowl Data's narrative index and returns matching narrative records with feed metadata and cache information. ### Macroeconomic Yield Data Returns FRED-sourced time series for bond yields and interest-rate spreads (e.g., 10Y-2Y Treasury), supporting macro modeling and rate-trend monitoring. - **`fetch-macro-yields`** — Returns a time series of macroeconomic bond and interest-rate yield data sourced from FRED, including current value, previous value, period date, and collection timestamp. ## Workflows ### Prediction Market Opportunity Scan *Use when an agent needs to identify high-activity prediction market events that also exhibit cross-platform price discrepancies worth investigating.* 1. **`fetch-markets-volume`** — Retrieve the ranked list of prediction market contracts by 24-hour volume to identify the most actively traded events. 2. **`fetch-market-spread`** — Pull cross-platform spread data to check whether high-volume events also show bid-ask discrepancies across Polymarket, Kalshi, and PredictFun. ### Market Lifecycle Review *Use when an agent needs to evaluate a prediction market event from active trading context through to final settlement outcome.* 1. **`fetch-markets-volume`** — Gather volume, liquidity, and implied probabilities for the event while it is open. 2. **`fetch-market-resolution-feed`** — Confirm the final resolved outcome and settlement probability once the market has closed. ### Macro-Contextualized Narrative Search *Use when an agent needs to surface narratives related to a macro topic and cross-reference them with current yield data for analytical context.* 1. **`search-narratives`** — Search the narrative index by a macro-related keyword (e.g., 'recession', 'rate hike') to retrieve relevant structured narrative records. 2. **`fetch-macro-yields`** — Pull current and historical FRED yield series to provide quantitative rate context alongside the retrieved narratives. ## Skill reference ### `fetch-markets-volume` **Markets Volume Insights** — Returns aggregated 24-hour trading volume, liquidity, and outcome probabilities for prediction market contracts across platforms like Polymarket. *Use when:* Use when an agent needs to analyze trading activity, liquidity depth, or outcome probabilities across prediction market contracts, ranked or filtered by 24-hour volume. *Not for:* Do not use for real-time streaming price feeds or order book data; this is a cached snapshot (TTL 300s) of aggregated volume metrics. **Returns:** Returns a feed metadata object with computed_at, cache_ttl, and a data array of prediction market records each containing platform, market_id, event question, outcome, probability, 24h volume, and liquidity. **Example:** `GET https://www.prowldata.dev/api/v1/markets/volume` --- ### `fetch-macro-yields` **Macro Yields API** — Returns a time series of macroeconomic bond and interest-rate yield data sourced from FRED, including current value, previous value, period date, and collection timestamp. *Use when:* Use when an agent needs recent historical yield spread or interest-rate data (e.g., the 10-year minus 2-year Treasury spread) for macro analysis, modeling, or monitoring rate trends. *Not for:* Do not use for real-time streaming yield prices or for equity/FX data; this endpoint returns cached FRED series snapshots with a 600-second TTL. **Returns:** Returns a feed metadata object and a data array of FRED yield observations (e.g., T10Y2Y spread), each with value, period_date, previous_value, and collected_at timestamp; cache TTL is 600 seconds. **Example:** `GET https://www.prowldata.dev/api/v1/macro/yields` --- ### `fetch-market-resolution-feed` **Market Resolution Feed** — Returns final outcomes, settlement probabilities, and resolution timestamps for prediction market contracts across platforms such as Kalshi. *Use when:* Use when an agent needs to confirm the resolved outcome, settlement status, or final probability of one or more prediction market contracts, such as verifying which side won a closed market. *Not for:* Do not use for live or open market prices; use a live market feed instead. Not suitable for discovering unresolved markets still accepting trades. **Returns:** Returns a feed object with computed_at timestamp, cache_ttl of 900s, and a data array of resolved market records each containing platform, market_id, event_question, outcome, probability, volume_24h, category, close_date, and collected_at. **Example:** `GET https://www.prowldata.dev/api/v1/markets/resolution` --- ### `search-narratives` **Narrative Explorer** — Searches Prowl Data's narrative index and returns matching narrative records with feed metadata and cache information. *Use when:* Use when an agent needs to query a narrative index by keyword or topic and retrieve structured narrative records along with feed tier and cache freshness metadata. *Not for:* Do not use for real-time streaming narrative updates; this is a single-shot search returning a cached snapshot with a 300-second TTL. **Inputs:** - `query` (string, required) — Search term or keyword used to filter narrative records in the index. - `limit` (integer) — Maximum number of narrative records to return in the response. **Returns:** Returns a JSON object with feed identifier, tier, computed_at timestamp, cache_ttl of 300 seconds, and a data array of matching narrative records (may be empty). **Example:** `GET https://www.prowldata.dev/api/v1/narrative/search?query=solana&limit=10` --- ### `fetch-market-spread` **ProwlData Market Spread** — Returns bid-ask spread data across prediction market platforms (Polymarket, Kalshi, PredictFun) for matched event pairs, including per-platform odds and computed spread values. *Use when:* Use when an agent needs to identify spread discrepancies between prediction market platforms for a given event, or to find arbitrage opportunities across Polymarket, Kalshi, and PredictFun. *Not for:* Do not use for traditional financial exchange (stock/crypto) bid-ask spreads; this data covers prediction market platforms only. Not suitable for real-time streaming — responses are cached with a 300-second TTL. **Returns:** Returns a feed object with a data array of cross-platform spread records, each containing event_hash, platform pair, per-platform odds (0–1), computed spread, event category, and timestamps. **Example:** `GET https://www.prowldata.dev/api/v1/markets/spread` ---