--- name: marketdata.use.x402atlas.com description: marketdata.use.x402atlas.com provides end-of-day and historically delayed market data for US-listed equities, with additional coverage of crypto, forex, and options for previous-close pricing. It exposes six discrete skills covering price snapshots, corporate actions, insider activity, short interest, and peer discovery. host: marketdata.use.x402atlas.com --- # marketdata.use.x402atlas.com This host serves agents that need fundamental and structural market data for US stocks — corporate actions (dividends, splits), regulatory filings (SEC Form 4 insider trades), FINRA short interest reports, previous-close OHLCV bars, and peer/comparable ticker discovery. It is not a real-time or streaming data source; all data is end-of-day delayed or reported on a periodic cadence (e.g., bi-weekly for short interest). It is best suited for research, screening, and analytical workflows rather than live trading execution. ## When to use this host Use this host when an agent needs end-of-day or historically delayed data for US equities: previous-close OHLCV bars, dividend and split histories, SEC Form 4 insider trades, FINRA short interest, or peer ticker discovery. It also supports previous-close pricing for crypto pairs (X:BTCUSD format), forex pairs (C:EURUSD format), and options contracts via fetch-prev-close-price. Do not use this host for real-time or intraday price quotes — use a live market data feed or streaming WebSocket provider instead. Do not use it for non-US equity corporate actions, ETF distributions, or crypto dividend/split equivalents. For crypto asset peer discovery or fundamentals, use a CoinGecko bridge or equivalent. This host has no order execution, portfolio management, or options analytics capabilities. ## Capabilities ### Price Reference Provides a single end-of-day OHLCV snapshot (open, high, low, close, volume, VWAP) for the most recently completed trading session across stocks, crypto, forex, and options tickers. - **`fetch-prev-close-price`** — Returns the previous trading day's OHLCV bar (open, high, low, close, volume, VWAP, transactions) for stocks, crypto, forex, or options tickers. ### Corporate Actions Retrieves historical dividend payments and stock split records for US equities, enabling price adjustment, yield analysis, and share-count auditing over time. - **`fetch-stock-dividend-history`** — Returns cash dividend history for a US stock ticker, including declaration, ex-dividend, record, and pay dates, per-share amount, currency, and payout frequency. - **`fetch-stock-split-history`** — Returns the full split history for a US stock ticker, including execution date, split ratio (split_from → split_to), and adjustment type (forward/reverse split). ### Market Sentiment Signals Surfaces insider buying/selling activity from SEC Form 4 filings and FINRA bi-weekly short interest metrics, providing two independent signals for assessing directional sentiment and squeeze potential on a US stock. - **`fetch-insider-trades`** — Returns SEC Form 4 insider transactions for a US stock ticker, including transaction date/code, acquired vs disposed, shares, price per share, total value, and shares held after. - **`fetch-short-interest`** — Returns FINRA bi-weekly short interest history for a US stock, including shares sold short, average daily volume, and days-to-cover ratio. ### Peer and Comparables Discovery Identifies related or peer ticker symbols for a given security based on news co-mentions and returns correlation, supporting basket construction and diversification analysis. - **`fetch-related-tickers`** — Returns a list of peer/related ticker symbols for a given ticker, derived from news co-mentions and returns correlation, useful for comparables and peer baskets. ## Workflows ### Corporate Action-Adjusted Price Baseline *Use when an agent needs to establish a split- and dividend-aware price baseline for a US stock before performing valuation or return calculations.* 1. **`fetch-prev-close-price`** — Retrieve the most recent end-of-day OHLCV bar as the current price reference point. 2. **`fetch-stock-split-history`** — Pull the full split history to identify any ratio changes that would affect historical price comparisons. 3. **`fetch-stock-dividend-history`** — Retrieve dividend history to account for cash distributions when computing total-return-adjusted figures. ### Sentiment Triangulation for a US Stock *Use when an agent needs to assess directional sentiment on a US equity by combining insider transaction signals with short interest pressure metrics.* 1. **`fetch-insider-trades`** — Retrieve recent SEC Form 4 filings to identify net insider buying or selling direction and magnitude. 2. **`fetch-short-interest`** — Pull bi-weekly short interest history to evaluate days-to-cover trends and potential short squeeze conditions alongside insider signals. ### Peer Basket Sentiment Sweep *Use when an agent needs to compare sentiment signals across a stock and its closest peers to identify relative divergence or sector-wide trends.* 1. **`fetch-related-tickers`** — Identify peer and comparable ticker symbols for the target stock based on news co-mentions and returns correlation. 2. **`fetch-short-interest`** — Retrieve short interest data for the target and each identified peer to compare days-to-cover and short pressure across the basket. 3. **`fetch-insider-trades`** — Pull insider transaction records for the target and peers to surface any divergent insider activity within the peer group. ## Skill reference ### `fetch-stock-dividend-history` **Stock Dividend History** — Returns cash dividend history for a US stock ticker, including declaration, ex-dividend, record, and pay dates, per-share amount, currency, and payout frequency. *Use when:* Use when an agent needs historical cash dividend records for a US-listed stock, such as to analyze dividend yield, payout frequency, or distribution type for a given ticker symbol. *Not for:* Do not use for non-US stocks, ETF distributions, or crypto assets. Not suitable for real-time or intraday dividend data — data is end-of-day delayed. Do not use for options or futures dividend adjustments. **Inputs:** - `ticker` (string, required) — US stock ticker symbol to retrieve dividend history for. - `limit` (integer) — Maximum number of dividend records to return. Must be between 1 and 50000. **Returns:** Returns queried_at timestamp, echoed ticker, count of records, and an array of dividend objects each with cash_amount, currency, declaration/ex-dividend/record/pay dates, frequency (payouts per year), and distribution_type. **Example:** `GET https://marketdata.use.x402atlas.com/dividends?ticker=AAPL&limit=10` --- ### `fetch-insider-trades` **Insider Trades Feed** — Returns SEC Form 4 insider transactions for a US stock ticker, including transaction date/code, acquired vs disposed, shares, price per share, total value, and shares held after. *Use when:* Use when an agent needs to monitor or analyze insider buying and selling activity for a specific US-listed stock, such as identifying 'smart money' signals from directors, officers, or 10%+ owners. *Not for:* Do not use for non-US stocks, ETFs, crypto, or real-time price feeds. Not suitable for streaming or continuous monitoring — this is a single-shot paginated query with possible data delay. **Inputs:** - `ticker` (string, required) — US stock ticker symbol to query insider trades for. - `limit` (integer) — Maximum number of insider trade records to return. Must be between 1 and 50000. **Returns:** Returns queried_at timestamp, ticker echo, count of records, and a trades array of SEC Form 4 entries with owner name, role flags, transaction code, acquired/disposed indicator, shares, price per share, total value, and shares owned after. **Example:** `GET https://marketdata.use.x402atlas.com/insider-trades?ticker=AAPL&limit=10` --- ### `fetch-prev-close-price` **Prev Close Price** — Returns the previous trading day's OHLCV bar (open, high, low, close, volume, VWAP, transactions) for stocks, crypto, forex, or options tickers. *Use when:* Use when an agent needs yesterday's closing price, volume, or VWAP for a stock (e.g. AAPL), crypto pair (e.g. X:BTCUSD), forex pair (e.g. C:EURUSD), or options contract as a baseline reference or end-of-day snapshot. *Not for:* Do not use for real-time or intraday price data; use a live quote or streaming feed instead. Not suitable for historical ranges spanning multiple days — this returns only the single most recent completed trading day. **Inputs:** - `ticker` (string, required) — Asset-prefixed ticker symbol. Use bare symbol for stocks (AAPL), X: prefix for crypto (X:BTCUSD), C: prefix for forex (C:EURUSD), O: prefix for options. - `adjusted` (boolean) — Whether to return split-adjusted prices. Defaults to true. **Returns:** Returns queried_at timestamp, ticker echo, adjusted flag, and a candle object with time, open, high, low, close, volume, vwap, and transactions for the previous trading day. **Example:** `GET https://marketdata.use.x402atlas.com/prev-close?ticker=AAPL&adjusted=true` --- ### `fetch-related-tickers` **Related Asset Finder** — Returns a list of peer/related ticker symbols for a given ticker, derived from news co-mentions and returns correlation, useful for comparables and peer baskets. *Use when:* Use when an agent needs to identify comparable or peer securities for a given ticker — e.g. to build a peer basket, run diversification analysis, or find correlated assets based on news and returns data. *Not for:* Do not use for real-time price feeds or live market quotes; use a price endpoint instead. Not suitable for crypto asset lookups — use a CoinGecko bridge for that. **Inputs:** - `ticker` (string, required) — Ticker symbol of the asset for which to retrieve related/peer tickers. **Returns:** Returns ticker echo, count, queried_at timestamp, and a related array of 10 peer tickers (e.g. MSFT, AMZN, GOOGL) plus an _atlas metadata block with linked bridge services. **Example:** `GET https://marketdata.use.x402atlas.com/related?ticker=AAPL` --- ### `fetch-short-interest` **Short Interest Data** — Returns FINRA bi-weekly short interest history for a US stock, including shares sold short, average daily volume, and days-to-cover ratio. *Use when:* Use when an agent needs historical short interest metrics for a US-listed stock to assess short squeeze potential, sentiment, or days-to-cover trends on a bi-weekly cadence. *Not for:* Do not use for non-US stocks, ETFs, or crypto assets. Not suitable for real-time or intraday short interest data — data is end-of-day and reported on a two-week cadence. **Inputs:** - `ticker` (string, required) — US stock ticker symbol to retrieve short interest history for. - `limit` (integer) — Maximum number of records to return. Must be between 1 and 50000. **Returns:** Returns a JSON object with queried_at timestamp, ticker echo, count of records, and an array of bi-weekly records each containing settlement_date, short_interest (shares sold short), avg_daily_volume, and days_to_cover ratio. **Example:** `GET https://marketdata.use.x402atlas.com/short-interest?ticker=AAPL&limit=10` --- ### `fetch-stock-split-history` **Stock Split History** — Returns the full split history for a US stock ticker, including execution date, split ratio (split_from → split_to), and adjustment type (forward/reverse split). *Use when:* Use when an agent needs historical stock split data for a US-listed equity, such as adjusting historical prices, auditing share count changes, or identifying forward/reverse splits by date. *Not for:* Do not use for non-US stocks, ETFs, or crypto assets. Not suitable for real-time or intraday data — results are end-of-day delayed. **Inputs:** - `ticker` (string, required) — US stock ticker symbol to retrieve split history for. - `limit` (integer) — Maximum number of split records to return. Must be between 1 and 50000. **Returns:** Returns ticker echo, queried_at timestamp, count, and a splits array with up to 5 AAPL entries including execution_date, split_from, split_to, and adjustment_type ordered most recent first. **Example:** `GET https://marketdata.use.x402atlas.com/splits?ticker=AAPL&limit=10` ---