Market and economic data for AI agents — US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities (crude, natural gas, gasoline), US and global macro (Fed funds, CPI/PCE, jobs, GDP, Treasury debt & yields, World Bank indicators), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 or MPP. This server is a pay-per-use, transparent proxy in front of x402stock's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.
GET
/api/v1/aggregates/{ticker}
$0.02The stock price history endpoint. Returns historical OHLCV bars at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Use for price history, charting, backtesting, and trend analysis over any date range. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/archive
$0.02Use to discover the point-in-time archive: immutable daily snapshots of ephemeral market state (Hyperliquid perps/spot, JLP pool, pre-IPO marks, market regime, squeeze scores), captured once per UTC day and never overwritten or backfilled. Lists every feed and entity with date coverage; read days via /archive/{feed} and series via /archive/{feed}/range. From x402stock
GET
/api/v1/archive/{feed}
$0.02Use to read one immutable archived day of a feed (sol.jlp, hl.perps, prestocks.markets, scores.squeeze, …): the exact payload the live endpoint returned that day, plus provenance (observed/captured/ingested timestamps + a content hash proving contemporaneous capture). Defaults to latest; ?date=YYYY-MM-DD for a past day, ?entity= on multi-entity feeds. From x402stock
GET
/api/v1/archive/{feed}/range
$0.03Use for time-series questions over the archive: how JLP AUM, Hyperliquid funding, a pre-IPO token premium, or a ticker's squeeze score evolved day by day. Per-day summaries (oldest first, ?from ?to ?limit, max 366) with capture provenance; payloads omitted — buy a full day via /archive/{feed}?date=. History accumulates daily and cannot be reconstructed retroactively. From x402stock
GET
/api/v1/avg-interest-rates
$0.01The average interest rate the US Treasury currently pays on its outstanding debt, broken out by security (Treasury Bills, Notes, Bonds, TIPS, FRNs, savings, and the marketable/total aggregates) for the latest reported month, in percent. No ticker needed. A read on the government's cost of borrowing that complements the /treasury-yields curve. Sourced from the US Treasury (FiscalData).
GET
/api/v1/backtest/{ticker}
$0.50Backtests a simple rule on a US stock and returns a finished report PNG. Runs an SMA crossover (?strategy=sma_cross&fast=50&slow=200) or RSI mean-reversion (?strategy=rsi_reversion&period=14&lower=30&upper=70) over daily history (?years=, max 5), no lookahead, rendered as an equity curve vs buy & hold. Returns full stats plus a hosted `artifact.png_url`. From x402stock
GET
/api/v1/basis
$0.05Scans every US stock that also trades as a 24/7 synthetic perp and returns the gap: official (delayed) price, prev close, perp mark and oracle, funding APR, open interest, and computed `basis_percent` + `basis_vs_prev_close_percent` — the implied overnight move while the US market is shut. Widest dislocation first, plus a plain-English `reading`. `?limit=`, `?min_basis=`. From x402stock
GET
/api/v1/basis/{ticker}
$0.03One stock priced on every rail at once: its official US listing (delayed, closed overnight) against the 24/7 Hyperliquid HIP-3 synthetic perp. Returns both prices, funding APR, open interest, and the gap as `basis_percent` + `basis_vs_prev_close_percent` — while the US market is shut, the live view of where the name reopens. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/beneficial-ownership/{ticker}
$0.02Schedule 13D/13G filings — triggered when a holder crosses 5% of a class — disclosing beneficial-ownership and activist stakes in a US-listed company, from SEC EDGAR. Per filing: the reporting person, filer-reported percent of class (can be <5% if held via derivatives), shares, voting/dispositive power, and (for 13D) the activist intent. `?type=13D|13G|all`, `?limit=` max 25. From x402stock
GET
/api/v1/calendar
$0.02Upcoming US economic data releases — WHEN the market-moving prints land, not just their latest values. Returns curated high-importance releases (CPI, PPI, PCE, jobs, JOLTS, GDP, retail sales, housing starts, industrial production) within `?days=` (default 30, max 90), each with date and category, plus the next FOMC meeting. `?past=true` includes the last week. Release dates from FRED.
GET
/api/v1/calendar/fomc
$0.01The full FOMC meeting schedule (2025–2027) with the last and next meeting and days-until. Each entry carries the two-day meeting's start and decision date, year, and past/upcoming status. No ticker needed — the rate-decision calendar every macro-aware agent plans around. Source: U.S. Federal Reserve. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/clinical-trials
$0.02Clinical trials run by a company, from ClinicalTrials.gov, newest first. Pass `?sponsor=Vertex Pharmaceuticals` (required) plus `?limit=` (max 100). Each trial carries NCT id, title, status, phase(s), study type, conditions, enrollment, lead sponsor, and start/completion/update dates with a link. A primary biotech catalyst. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/company-facts/{ticker}
$0.02Every XBRL financial fact a company has reported to the SEC, each collapsed to its latest value: tag, taxonomy, label, unit, the figure, and the period/form/filing it came from. Filter with `?taxonomy=us-gaap|dei`, `?search=revenue`, and `?limit=`. Discover which metrics exist for a ticker before drilling into the full series via /concept. Sourced from SEC EDGAR. From x402stock
GET
/api/v1/compare
$0.05Compare 2 to 3 US-listed stocks side by side (peer or watchlist comparisons). Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (1 to 3 symbols). Returns price and day change, market cap, P/E, EPS, revenue, gross and net margins, and dividend yield per ticker. Built for multiple stocks — for a single stock, `/api/v1/quote/{ticker}` is cheaper. From x402stock
GET
/api/v1/concept/{ticker}
$0.02The reported time series of one XBRL financial concept (e.g. Revenues, Assets, NetIncomeLoss) for a company, taken directly from its SEC filings. Pass the tag via `?tag=` and optionally `?taxonomy=` (default us-gaap) and `?limit=`. Each point carries the value, period, fiscal year/quarter, source form, and accession. Use for precise, filing-grade fundamentals and quant time series. From x402stock
GET
/api/v1/conditions
$0.01Reference catalog of trade/quote condition codes (the numeric `conditions` seen on trades) with names, types, data types, and SIP mappings. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/congress-trades
$0.03Recent stock trades disclosed by US members of Congress under the STOCK Act, parsed live from official House and Senate Periodic Transaction Reports: per trade the member, chamber, ticker, asset, buy/sell type, date, and disclosed dollar range. ?chamber=house|senate|both, ?ticker=AAPL, ?limit= recent filings per chamber (max 20). From US House & Senate. From x402stock
GET
/api/v1/cot
$0.02The weekly CFTC Commitments of Traders positioning across major futures markets in one call: for each market the open interest, non-commercial (large speculator) net position and weekly change, and commercial (hedger) net position. Covers equity indices, gold/silver, crude/natural gas, major FX, the 10-year note, and bitcoin. No ticker needed. Sourced from the US CFTC. From x402stock
GET
/api/v1/cot/{market}
$0.01CFTC Commitments of Traders for one futures market by slug: sp500, nasdaq, gold, silver, crude-oil, natural-gas, euro, british-pound, japanese-yen, swiss-franc, us-dollar-index, 10y-note, bitcoin. Returns open interest and non-commercial, commercial, and non-reportable long/short/net with weekly changes plus net history. `?weeks=` 12 (max 52). From the US CFTC. From x402stock
GET
/api/v1/crypto/{pair}/aggregates
$0.02Historical OHLCV bars for a major-coin crypto spot pair at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD or ETH-USD. Aggregated centralized-market spot — for Hyperliquid-listed token spot use /api/v1/spot, for perps use /api/v1/perps. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/crypto/{pair}/open-close
$0.01The official UTC open and close price for a crypto spot pair on a given date. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD, and the date via `?date=YYYY-MM-DD` (required). Crypto trades 24/7, so this is the UTC-day open/close. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/crypto/{pair}/prev-close
$0.01Crypto trades 24/7, so there is no session close: this returns the previous UTC calendar day's full OHLCV candle (00:00–24:00 UTC) for a spot pair — open, high, low, close, volume, and VWAP. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD. One call returns yesterday's daily bar. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.
GET
/api/v1/dividend-calendar
$0.02Market-wide dividend calendar (no ticker needed). Per row: ticker, ex-dividend / record / pay / declaration dates, cash amount per share, currency, type, payments-per-year `frequency` + `frequency_label` (quarterly, monthly, weekly, one-time), and computed `annualized_amount`. Upcoming payments first. Filter `?from=`/`?to=` on ex-date, `?ticker=`, `?frequency=`, `?order=`, `?limit=`.
GET
/api/v1/dividends/{ticker}
$0.01Historical cash dividends for a ticker: amount, currency, type, frequency, and the declaration / ex-dividend / record / pay dates. Most recent first. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/dossier/{ticker}
$0.05A company's recent SEC disclosure picture in one call: the filings index, insider transactions from Form 4 with a net buy/sell signal, material 8-K events by item code, and initial holdings from Form 3. The CIK is resolved once and shared across sections (faster than four separate calls), at a lower combined price. From SEC EDGAR; sections degrade independently. From x402stock
GET
/api/v1/energy
$0.02Every energy benchmark in one call: WTI and Brent crude oil spot, Henry Hub natural gas spot, and US regular retail gasoline — each with its latest price, prior reading, and change. The catalog's commodities feed (no equity/forex/crypto endpoint carries these). For one benchmark with history use /api/v1/energy/{product}. Source: U.S. Energy Information Administration (EIA). From x402stock
GET
/api/v1/energy/{product}
$0.01Price history for one energy benchmark — `wti` (WTI crude, $/bbl), `brent` (Brent crude, $/bbl), `natural-gas` (Henry Hub, $/MMBtu), or `gasoline` (US regular retail, $/gal) — with the latest value, prior reading, change, and recent history. Tune with `?limit=` (default 30, max 365). The catalog's commodities feed. Source: U.S. Energy Information Administration (EIA). From x402stock
GET
/api/v1/events/{ticker}
$0.01Timeline of corporate events for a ticker, such as ticker symbol changes, with the company name, CIK, and composite FIGI. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/exchange-rates
$0.02Official US Treasury reporting rates of exchange — government FX reference rates for ~170 currencies, in units of foreign currency per 1 USD, for the latest quarter. Use for accounting-grade and exotic-currency conversion the market /api/v1/forex feed lacks. Filter with `?currency=Euro`. Updated quarterly. From the US Treasury (FiscalData). From x402stock
GET
/api/v1/exchanges
$0.01Reference list of US equity exchanges and market centers with names, MICs, operating MICs, and SIP participant IDs. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/fails-to-deliver/{ticker}
$0.02Settlement fails-to-deliver for a US-listed stock from the SEC's semi-monthly data: the aggregate shares that failed to deliver on each settlement date, with the reference price, most recent first. A niche short-pressure and squeeze signal. ?limit= records (default 30). Sourced from SEC EDGAR. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.
GET
/api/v1/fda
$0.03FDA catalysts for a pharma/biotech/medtech company, from openFDA. Pass `?company=Medtronic` (required) plus `?limit=` (max 50). Returns `drug` (recalls + approvals) and `device` (510(k) clearances, PMA approvals, recalls) sections, each with recent items, match totals, and official FDA links. One call across 5 FDA datasets. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fda/shortages
$0.02Current and resolved US drug shortages from openFDA, newest update first. Optional `?company=Pfizer` narrows to one manufacturer (omit for market-wide); `?limit=` (max 100). Each carries the generic name, company, status, therapeutic category, dosage form, presentation, posting/update dates, and reason. A supply-side catalyst for generic makers. From x402stock
GET
/api/v1/fear-greed
$0.02The current US stock-market Fear & Greed index (0–100, CNN-style) with its sentiment rating and all five weighted components — volatility, momentum, put/call, safe-haven demand, junk-bond demand — each with value, weight, and reading. Includes the last 30 days of scores and a backtest of S&P 500 forward returns by sentiment zone. A one-call read of market mood. From x402stock
GET
/api/v1/fear-greed/crypto
$0.01The Crypto Fear & Greed index (0–100) with its rating, alongside the US stock Fear & Greed score for comparison, current BTC and ETH prices with 24h change, and ~90 days of crypto sentiment history. Pass `?days=N` to size the history. The crypto-sentiment companion to /api/v1/fear-greed (stocks). From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fear-greed/history
$0.02The full daily history of the US stock Fear & Greed index from 2016 to today, each point a date and 0–100 score. Pass `?days=N` to return only the most recent N days (default: full series). Use for charting sentiment regimes and backtesting against price. Companion to /api/v1/fear-greed (current reading). From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fear-greed/liquidity
$0.01US net liquidity (Fed balance sheet minus Treasury General Account minus reverse repo) as a 0–100 percentile with its label and 4-week trend, broken into its FRED components (WALCL, TGA, RRP, M2) plus ~52 weeks of history. A macro-liquidity gauge for risk appetite. Complements the /api/v1/fed-funds and other FRED macro endpoints. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fear-greed/regime
$0.02The combined market regime — one read fusing the stock Fear & Greed score and velocity, VIX, insider-buying sentiment, and net liquidity into a named regime (e.g. Mixed Signals) with severity and a suggested stance, plus how the S&P 500 historically performed after similar regimes (forward 5/22-day and 1/3-month returns and win rates). From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fed-funds
$0.01The effective federal funds rate — the Fed's benchmark policy rate that anchors every other US interest rate — as a monthly average in percent, with the latest value, prior month, month-over-month and year-over-year change, and recent history. No ticker needed. The rate every rate-sensitive analysis starts from. Sourced from the St. Louis Fed (FRED). From x402stock
GET
/api/v1/filing-search
$0.02Full-text search across every SEC EDGAR filing since 2001. Find filings mentioning a keyword or exact phrase via ?q=, narrow by ?forms=10-K,8-K, ?ticker=, and ?startdt=/?enddt= dates, and cap with ?limit=. Returns each match's form, filer, date, and a link to the document. Sourced from SEC EDGAR. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/filing-summary/{ticker}
$0.03Fetches a company's latest 10-K, 10-Q, or 8-K from SEC EDGAR and returns a structured JSON summary: a plain-language overview, the key risk factors, MD&A highlights, any forward guidance, and an overall sentiment label. Choose the document with `?type=10-K` (also 10-Q, 8-K). Built for agents that need the substance of a filing without parsing hundreds of pages of HTML. From x402stock
GET
/api/v1/filings/{ticker}
$0.01List a company's recent SEC EDGAR filings sourced directly from the SEC: form type, filing and report dates, the 8-K item codes, and a direct link to each primary document. Filter to a single form with `?type=10-K` (also 10-Q, 8-K, 4, etc.) and cap with `?limit=`. Use as the index into a company's disclosures before fetching or summarizing a specific filing. From x402stock
GET
/api/v1/financials/{ticker}
$0.02Per-period financial statements (income statement, balance sheet, cash flow, comprehensive income) sourced from SEC filings, flattened to fact_key → value maps. Pass `?timeframe=annual|quarterly|ttm` and `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/float/{ticker}
$0.01Free float for a ticker — the share count genuinely available to trade, net of insider, strategic and restricted holdings — plus `free_float_percent` (0-100), the derived `restricted_percent`, and the `effective_date`. The correct denominator for squeeze and liquidity work: short interest as a percentage of float, not of shares outstanding. From x402stock
GET
/api/v1/forex/{pair}/aggregates
$0.02Historical OHLCV bars for a foreign-exchange pair at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Pass the pair in the path as BASE-QUOTE, e.g. EUR-USD or USD-JPY. Use for FX charting, backtesting, and macro/rate analysis. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/forex/{pair}/prev-close
$0.01Open, high, low, close, volume, and VWAP for a foreign-exchange pair's most recent completed trading day. Pass the pair in the path as BASE-QUOTE, e.g. EUR-USD. One call returns one bar for a quick prior-close reference. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/form-144
$0.02Market-wide recent Form 144 insider intent-to-sell notices across all US issuers — who is filing to sell, before the Form 4 confirms it. Per notice: ticker, issuer, insider, shares to be sold, aggregate market value, and approximate sale date. Tune the window with `?days=` (max 90) or `?startdt`/`?enddt`, and `?limit=` (max 50). Proposed sales, not executed. From SEC EDGAR. From x402stock
GET
/api/v1/form-144/{ticker}
$0.02Insider intent-to-sell notices (SEC Form 144) for one US-listed company — the leading indicator that front-runs the Form 4. Per notice: the insider and relationship, shares to be sold, aggregate market value, approximate sale date, broker, shares outstanding, and any sales in the past 3 months. A PROPOSED sale, not an executed trade. `?limit=` max 25. From SEC EDGAR. From x402stock
GET
/api/v1/form-3/{ticker}
$0.02Initial beneficial-ownership holdings parsed from SEC Form 3 filings, the first report an insider files on becoming a director, officer, or 10% holder. Each holding carries the security, shares owned, direct or indirect ownership, and derivative terms. Complements Form 4 transactions. ?limit= filings (default 5). Sourced from SEC EDGAR. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/frames
$0.02One reported XBRL financial fact for every company that disclosed it in a calendar period, for peer screening. Pass ?tag= (e.g. Revenues), ?period= (CY2024, CY2024Q1, or CY2024Q1I for balance-sheet facts), ?taxonomy= (default us-gaap), ?unit= (default USD), and ?limit=. Sorted by value. Sourced from SEC EDGAR. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fred/{series}
$0.01Pull a key market-signal macro series from the Federal Reserve (FRED) by slug: vix, yield-curve-10y-2y, yield-curve-10y-3m, high-yield-spread, ig-spread, breakeven-10y, real-yield-10y, jobless-claims, consumer-sentiment, mortgage-30y, financial-conditions, recession-probability. Each returns the latest value, prior, change, year-over-year, and recent history. No ticker needed. From x402stock
GET
/api/v1/full-market-snapshot
$0.04Current state of every US-listed ticker in a single call: price, day change and percent change, volume, and VWAP per symbol. The base layer for building a screener or scanning the whole market without iterating ticker by ticker. Optional `?tickers=AAPL,MSFT` to narrow and `?include_otc=true` to add OTC names. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fund-holdings/{cik}
$0.03The latest 13F-HR institutional holdings for a fund or investment manager, looked up by its SEC CIK. Returns every reported position with issuer, CUSIP, market value, share count, option type, and voting authority, plus the portfolio's total value, sorted largest first. ?limit= positions. Sourced from SEC EDGAR. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/fund-nport/{fund}
$0.03What's inside an ETF or mutual fund, from its latest SEC N-PORT filing. Pass an ETF/fund ticker (SPY, ARKK) or CIK in the path. Returns the registrant, net/total assets, report date, and every portfolio holding by value — name, CUSIP, ISIN, shares, USD value, % of net assets, asset/issuer class, country. `?limit=` (max 500). Fund composition the 13F feed doesn't cover. From x402stock
GET
/api/v1/gainers
$0.02The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/gdp
$0.01US real Gross Domestic Product, quarterly, in billions of chained 2017 dollars (seasonally adjusted annual rate), with the latest reading, prior quarter, quarter-over-quarter and year-over-year change, and recent history. No ticker needed. The broad measure of economic output for macro-aware analysis. Sourced from the St. Louis Fed (FRED). From x402stock
GET
/api/v1/gov-awards
$0.02The latest large NEW federal awards across all recipients, from USAspending.gov — browse what the government is funding right now. Tune `?days=` lookback (max 365), `?award_type=contracts|grants|all`, `?min_amount=` floor, `?order=amount|date`, `?limit=` (max 50). Each award carries recipient, amount, awarding agency, dates, description, and a link. Uses new-award dating, not modifications.
GET
/api/v1/gov-contracts
$0.02Federal contract and grant awards to a US company, from USAspending.gov. Pass `?recipient=Lockheed Martin` (required, fuzzy name match) plus optional `?award_type=contracts|grants|all`, `?order=amount|date`, `?limit=` (max 50). Each award carries the award id, amount, awarding agency, period of performance, description, and a usaspending.gov link, with a total. A government-spending catalyst.
GET
/api/v1/grouped-daily
$0.02End-of-day OHLCV bars for every US-listed ticker on a single date; one call returns the entire market. Pass `?date=YYYY-MM-DD` (required). From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/hip3/dexs
$0.01List every permissionless builder-deployed perp DEX on Hyperliquid (HIP-3). Each lists synthetic, oracle-priced 24/7 perp markets — US equities, commodities (gold, oil, copper), FX, and global index perps — that Hyperliquid's core perps and US-only stock feeds don't carry. Returns each DEX's id, name, deployer, and market count. Then read a DEX's markets at /api/v1/hip3/{dex}. From x402stock
GET
/api/v1/hip3/{dex}
$0.02All markets in one Hyperliquid HIP-3 builder DEX (pass the dex id, e.g. `xyz`): 24/7 synthetic mark & oracle price, funding rate + APR, open interest, and day volume each. Covers equity perps (NVDA, TSLA), commodities (GOLD, BRENTOIL, COPPER), FX, and index perps. Oracle-priced proxies carrying funding — not the underlying's official last trade. List DEXs at /api/v1/hip3/dexs. From x402stock
GET
/api/v1/hip3/{dex}/{market}
$0.01One market in a Hyperliquid HIP-3 builder DEX by underlying symbol (e.g. `xyz`/`NVDA`, `xyz`/`GOLD`): its 24/7 synthetic mark & oracle price, funding rate + APR, premium, open interest, and day volume. A round-the-clock live proxy for the underlying that carries funding — NOT its official last trade, exchange close, or spot price. List a DEX's markets at /api/v1/hip3/{dex}. From x402stock
GET
/api/v1/indicators/ema/{ticker}
$0.01Exponential Moving Average time series. Tune with `?window=`, `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/indicators/macd/{ticker}
$0.01MACD time series with value, signal line, and histogram. Tune with `?short_window=`, `?long_window=`, `?signal_window=`, `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/indicators/rsi/{ticker}
$0.01Relative Strength Index time series (momentum oscillator). Tune with `?window=` (default 14), `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/indicators/sma/{ticker}
$0.01Simple Moving Average time series. Tune with `?window=`, `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/inflation
$0.02US consumer price inflation from the Bureau of Labor Statistics: the latest headline CPI-U and core (ex food and energy) index levels with year-over-year percent change, plus recent monthly history. No ticker needed. Use for macro-aware analysis without leaving for a separate data source. Sourced from US BLS. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/insider-trades/{ticker}
$0.03Recent insider transactions parsed from SEC Form 4 filings: the reporting owner and their role (director, officer, 10% holder), each buy/sell with transaction code, share count, price, and shares held afterward, plus an aggregate net-buying/net-selling signal. Tune how many filings to parse with `?limit=` (default 5, max 25). Sourced live from SEC EDGAR. From x402stock
GET
/api/v1/ipos
$0.02Upcoming and historical US IPOs: issuer name, ticker, announced and listing dates, offer price range and final price, shares offered, total deal size, exchange, and status. Filter by `?ipo_status=pending|new|history|rumor`, `?ticker=`, and `?limit=`. Use to track the new-issue calendar and recently priced deals. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/labor-market
$0.02US labor-market headline indicators from the Bureau of Labor Statistics: the unemployment rate, labor force participation rate, total nonfarm payrolls, and average hourly earnings, each with its latest value and change from the prior month. No ticker needed. Sourced from US BLS. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/losers
$0.02The day's biggest percentage losers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/macro
$0.05The US macro backdrop in one call: the federal funds rate, CPI and PCE inflation, the labor market (unemployment, payrolls, wages), real GDP, and the Treasury yield curve. No ticker needed. Replaces six macro calls (fed-funds + inflation + pce + labor-market + gdp + treasury-yields) at a lower combined price. Spans FRED, BLS, Treasury; sections degrade independently. From x402stock
GET
/api/v1/market-pulse
$0.03Use to find the day's biggest movers in one call. Returns the top 10 gainers and top 10 losers by percent move with price, the current US market session status (open, closed, pre, or post), and the latest market news headlines. No ticker needed. Built for agents scanning what is moving today. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.
GET
/api/v1/material-events/{ticker}
$0.03Recent 8-K material-event filings for a company, each classified by its SEC item code into a human-readable label (e.g. 2.02 Results of Operations, 5.02 Executive Changes, 1.01 Material Agreement). Returns filing date, item labels, and a link to the filing. Cap with `?limit=`. Use to track earnings releases, leadership changes, and material agreements. Sourced from SEC EDGAR. From x402stock
GET
/api/v1/money-supply
$0.01US M2 money stock, monthly, in billions of dollars (seasonally adjusted), with the latest value, prior month, month-over-month and year-over-year change, and recent history. No ticker needed. A liquidity gauge watched for inflation and risk-asset context. Sourced from the St. Louis Fed (FRED). From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.
GET
/api/v1/national-debt
$0.01The total US public debt outstanding to the penny — the headline national-debt figure — split into debt held by the public and intragovernmental holdings, with the latest value, prior business day, day-over-day change, and recent history. No ticker needed. Updates each business day. Sourced from the US Treasury (FiscalData). Pass `?limit=` for more history (default 30, max 250). From x402stock
GET
/api/v1/news
$0.02Curated stock-market news with ticker tags, source, publisher, image, and timestamps. Pass `?ticker=AAPL` to filter. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/news-sentiment
$0.02Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds. From x402stock
GET
/api/v1/open-close/{ticker}
$0.01Official open, close, high, low, volume, plus pre-market and after-hours prices for a ticker on a given date. Pass `?date=YYYY-MM-DD` (required). From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/options-aggregates/{contract}
$0.02Historical OHLCV price bars for one option contract over any date range. Pass the option contract ticker in the path (e.g. O:AAPL260620C00150000) and tune ?multiplier=, ?timespan=minute|hour|day|week|month, ?from= and ?to= (optional; default to the trailing year), ?adjusted=, ?sort=, and ?limit=. Use for backtesting or charting a single option's price history. From x402stock
GET
/api/v1/options/{ticker}
$0.02The options chain for a US-listed underlying: every listed contract with its strike price, expiration date, call or put type, exercise style, contract ticker, and shares per contract. Filter with ?expiration_date=YYYY-MM-DD, ?contract_type=call|put, ?strike_price=, ?expired=true|false, and ?limit=. Use to discover which option contracts exist before pulling price history. From x402stock
GET
/api/v1/overview/{ticker}
$0.05Use when you need a full picture of one US-listed stock without making a dozen calls. Returns company profile, delayed price with OHLCV, fundamentals with computed P/E and margins, dividend yield, splits and corporate events, technical indicators (RSI, SMA, EMA, MACD) with neutral zone labels, recent news, and peers. A `sections` map flags anything unavailable. From x402stock
GET
/api/v1/patent/{application}
$0.02Full USPTO record for one patent application — pass the `{application}` number (e.g. 18687455, the `application_number` from /patents). Returns patent & application numbers, title, filing/grant dates, status, applicant, inventors, application type, examiner, art unit, CPC classes, publication number/date, term-adjustment days, and assignment/parent counts. From x402stock
GET
/api/v1/patent/{application}/assignments
$0.02Recorded ownership transfers (assignments) for one patent application — pass the `{application}` number. Each carries the reel/frame, conveyance text, received & recorded dates, assignors, assignees (with location), and the recorded-document link. A patent sale, collateral pledge, or M&A signal the price/filing feeds miss. Source: USPTO. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/patent/{application}/continuity
$0.01The patent family for one application — pass the `{application}` number. Returns parent and child applications with their numbers, filing dates, status, and the continuity relationship (continuation, divisional, national-stage entry, etc.). Maps how deep a company's protection on an invention runs. Source: USPTO. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/patent/{application}/transactions
$0.02The prosecution-history timeline for one patent application — pass the `{application}` number plus `?limit=` (max 200), newest first. Each event carries its date, USPTO event code, and description (office actions, allowance, grant, abandonment, etc.) — the momentum/risk read on where an application sits. Source: USPTO. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/patents
$0.02A company's US patents from the USPTO Open Data Portal, newest filings first. Pass `?company=Tesla` (required, matches APPLICANT name — subsidiaries/variants need separate queries) plus `?limit=` (max 100). Each carries patent & application numbers, title, filing & grant dates, status, applicant, inventors, and a link. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/pce
$0.02US PCE (Personal Consumption Expenditures) price inflation — the Fed's preferred inflation gauge — with the latest headline and core (ex food and energy) index levels, each with year-over-year percent change, plus recent monthly history. No ticker needed. Complements the CPI endpoint with the measure the Fed actually targets. Sourced from the St. Louis Fed (FRED). From x402stock
GET
/api/v1/perps
$0.02Live state of every perpetual-futures market in one call: per coin the mark and oracle price, hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. Native crypto-derivatives data — funding and open interest are perp-only, absent from any spot feed. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock
GET
/api/v1/perps/account/{address}
$0.02Live on-chain account state for any wallet on the Hyperliquid perp DEX, by 0x address: account value, total notional, margin used, withdrawable; every open perp position (size, long/short, leverage, entry, unrealized PnL, liquidation price, margin); and resting open orders (up to `?limit=`, default 200; `open_orders_count` is the total). Read-only public chain data, no key. From x402stock
GET
/api/v1/perps/candles/{coin}
$0.02Historical OHLCV candles for one perpetual-futures market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, and more) over a time window. Pass the coin in the path (e.g. BTC) and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or an explicit `?start=`/`?end=` epoch-ms range. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock
GET
/api/v1/perps/fills/{address}
$0.02Recent fills (executed trade history) for any wallet on the Hyperliquid perp DEX, by 0x address: per fill the time, coin, buy/sell side, direction (open/close long/short), price, size, start position, closed PnL, fee, and order id, most recent first. Tune with `?limit=` (default 50, max 200). Read-only public chain data, no key. Pass the address in the path. From x402stock
GET
/api/v1/perps/funding/{coin}
$0.01The historical hourly funding-rate series for one perpetual-futures market, each point with the funding rate, annualized APR, and premium, most recent first. Pass the coin in the path (e.g. BTC) and tune the window with `?hours=` (default 24, max 720) or an explicit `?start=`/`?end=` epoch-ms range. Use to study funding regimes and carry. Free on-chain DEX data (venue: Hyperliquid), no key.
GET
/api/v1/perps/orderbook/{coin}
$0.01The level-2 order book for one perpetual-futures market: aggregated bid and ask price levels, each with size and the number of resting orders, as of the book timestamp. Pass the coin in the path (e.g. BTC). Use to gauge liquidity, spread, and depth. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/perps/overview/{coin}
$0.03Everything about one on-chain perpetual-futures market in one call: live mark/oracle price with funding rate and open interest, recent funding history, the L2 order book, and OHLCV candles. Pass the coin in the path (e.g. BTC, ETH). Replaces four calls (perps/{coin} + funding + orderbook + candles) at a lower combined price. Free DEX data (venue: Hyperliquid). Sections degrade independently.
GET
/api/v1/perps/predicted-funding
$0.02Predicted next-period funding rate for each coin across venues — on-chain plus centralized perp venues (Hyperliquid, Binance, Bybit) — each with the funding interval and next funding time. A cross-exchange funding-arbitrage signal in one call: compare where a coin's funding is richest or cheapest. Free on-chain DEX data, no key. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/perps/{coin}
$0.01Live state of one perpetual-futures market by coin (e.g. BTC, ETH, SOL): mark and oracle price, current hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. The single-coin read for funding and open-interest signals. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock
GET
/api/v1/portfolio/xray
$0.25Risk x-ray for a whole watchlist or portfolio in one call. Pass `?tickers=AAPL,MSFT,NVDA` (up to 25; optional `?weights=`). Returns per-holding price, sector and cap, plus portfolio concentration (top-weight, Herfindahl, diversification score), sector concentration, market-cap distribution, weighted day performance and risk flags. Replaces dozens of per-holding calls. From x402stock
GET
/api/v1/prediction-markets
$0.03Use to see where prediction-market money is flowing: the most recently traded Polymarket outcome tokens with implied probability (last on-chain price), today's VWAP and USD volume, and indexed totals — decoded by our own indexer from CTF Exchange V2 events on the public Polygon ledger, not from any Polymarket API. `?limit=` up to 100. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/prediction-markets/{id}
$0.02Use to track one Polymarket outcome token by its uint256 decimal token id: implied probability, today's VWAP and USD volume, indexed totals, plus on-chain identity (condition id, question title, neg-risk flag) resolved from the market's preparation transaction on Polygon. List active token ids via /prediction-markets. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/prev-close/{ticker}
$0.01Open, high, low, close, volume, and VWAP for a ticker's most recent completed trading day. One call returns one bar, handy for prior-close reference without setting a date range. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/private-stocks
$0.02Live valuations for private, pre-IPO companies — Anthropic, OpenAI, SpaceX, Anduril, Neuralink, Kalshi, Polymarket — in one call, via PreStocks Solana tokens backed 1:1 by SPV exposure. Per company: mark price and valuation, on-chain token price and implied valuation, the token's premium/discount, supply, and contract. The catalog's only pre-IPO feed. From x402stock
GET
/api/v1/private-stocks/{symbol}
$0.01The current valuation of one private, pre-IPO company by symbol — e.g. ANTHROPIC, OPENAI, SPACEX, ANDURIL, NEURALINK, KALSHI, POLYMARKET — via its PreStocks Solana token, backed 1:1 by SPV exposure. Returns the SPV mark price and valuation, the on-chain token price and implied valuation, the token's premium/discount, supply, and contract. List them all at /api/v1/private-stocks. From x402stock
GET
/api/v1/quote/{ticker}
$0.01Get the latest available price for any US-listed stock: the most recent 1-minute bar close plus today's OHLCV, change, and previous close. Currently 15 minutes delayed; each response carries `is_delayed: true`. Real-time pricing lands when the data plan is upgraded. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/regulatory
$0.02Proposed/final rules and notices from a federal agency — the regulatory pipeline that reprices sectors. Pass `?agency=securities-and-exchange-commission` (slug) and/or `?q=` (at least one), plus `?type=all|rule|proposed|notice` and `?limit=` (max 100). Each doc has number, type, title, abstract, dates, agencies, and a link. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/related/{ticker}
$0.01Tickers related to the given symbol based on news and analyst coverage co-occurrence, a quick peer set for comparative analysis. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/report/{ticker}
$0.50Renders a finished one-page equity tearsheet PNG for a US-listed stock — not raw JSON to assemble. Fans out to profile, price, 1-year history, fundamentals, technicals and news, then draws a 1-year price chart with its 50-day average plus key stats (market cap, P/E, margins, dividend yield, 52-week range) and headlines. Returns the data plus a hosted `artifact.png_url`. From x402stock
GET
/api/v1/research/{ticker}
$0.75A full AI-synthesized equity-research memo for one US stock in one call. Fans out across profile, fundamentals, technicals, short interest, insider activity (Form 4/144), 13D/G stakes, 8-K events, news and sentiment, then an LLM distils a balanced bull/bear case, valuation context, catalysts, risks and a per-signal read-out with an overall stance. Factual synthesis, not advice. From x402stock
GET
/api/v1/score/factors/{ticker}
$0.15A transparent quant factor score for a US stock: Value (P/E, P/S, P/B), Quality (ROE, margins, leverage), Growth (YoY revenue & earnings) and Momentum (trailing return), each 0–100 from filing-grade fundamentals plus an equal-weighted composite. Returns every metric it scored, with labels. Factual, not advice. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/score/insider/{ticker}
$0.15A transparent 0–100 insider-conviction score for a US stock. Starts neutral, then adjusts for net Form 4 buy/sell share flow, role-weighted activity (C-suite and 10% owners weigh more), cluster buying by distinct insiders, Form 144 intent-to-sell overhang, and any activist 13D stake — returning the full factor breakdown. From SEC EDGAR. Factual, not advice. From x402stock
GET
/api/v1/score/squeeze/{ticker}
$0.15A transparent 0–100 short-squeeze pressure score for a US stock. Combines short interest as a % of shares, days-to-cover, the daily short-volume ratio, fails-to-deliver vs average volume, and a price/social spark into one gauge — with the full sub-factor breakdown and the raw inputs it scored. Factual quantitative reading, not advice. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/screener
$0.03Screen the entire US stock market in one call. Filter every listed ticker by price range, percent change, and minimum volume, then sort by percent move, price, or volume. Tune with ?min_price=, ?max_price=, ?min_change_percent=, ?max_change_percent=, ?min_volume=, ?sort=, ?order=, ?limit=. Built for agents scanning for setups without iterating ticker by ticker. From x402stock
GET
/api/v1/screener/smart
$0.20Describe a screen in plain English via `?q=` (e.g. 'oversold large caps up today on high volume'). An LLM parses it into a filter, screens the entire US market, optionally confirms oversold/overbought with RSI, and returns a ranked shortlist with a one-line rationale per name. No need to know the filter schema or run the enrichment loop yourself. From x402stock
GET
/api/v1/short-interest/{ticker}
$0.02The exchange-reported short-interest history for a US-listed stock: total shares sold short, average daily volume, and days-to-cover for each bi-weekly FINRA settlement date, most recent first. A core short-squeeze and bearish-positioning signal. Tune how many settlements to return with `?limit=` (default 12). From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/short-volume/{ticker}
$0.02Daily short-sale volume for a US-listed stock: total volume, short volume, exempt and non-exempt short volume, the short-volume ratio, and a per-venue breakdown (NYSE, Nasdaq, ADF), most recent day first. A higher-frequency read on shorting pressure than bi-weekly short interest. Tune with `?limit=` (default 20). From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/snapshot/{ticker}
$0.01Single-call snapshot of a ticker's current state: last quote, last trade, today's OHLC + volume + VWAP, previous-day OHLC, today's change vs previous close. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/solana/balance/{address}
$0.01The native SOL balance and basic account state for any Solana address, read from the public ledger: lamports and SOL, whether the account exists, its owning program, executable flag, and data size. Pass a base58 address in the path. Keyless on-chain data — no Jupiter API, no account. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.
GET
/api/v1/solana/holders/{mint}
$0.02The largest holders of any Solana SPL token (top accounts by balance, up to 20), each with its token account, owner wallet, balance, and share of total supply — for holder-concentration and whale analysis. Pass a base58 mint or a known symbol (JUP, JLP, …); tune with `?limit=` (max 20). Read from the public ledger, no Jupiter API. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/solana/jlp
$0.02Jupiter's JLP liquidity pool, decoded from the Perpetuals program's on-chain accounts (not the Jupiter API): AUM (USD), JLP supply and virtual price (AUM ÷ supply), pool-wide long/short trader exposure, and each asset (SOL, ETH, WBTC, USDC, USDT) with holdings, owned/locked, utilization %, and long/short USD. Keyless public-chain data, no Jupiter API. From x402stock
GET
/api/v1/solana/token/{mint}
$0.01On-chain facts for any Solana SPL token, read straight from the public ledger (not the Jupiter API): total supply and decimals, mint and freeze authority, initialization, and token program (SPL Token or Token-2022). Pass a base58 mint address or a known symbol (SOL, JUP, JLP, USDC, USDT, BONK, JTO, WIF). Keyless public-chain data, no account. From x402stock
GET
/api/v1/splits-calendar
$0.02Market-wide split calendar across all US tickers (no ticker needed). Each row has the ticker, execution date, direction (`forward`/`reverse`), split_from/split_to, numeric `ratio`, and a human `ratio_text` like `10:1` or `1:8`. Future-dated announced splits sort first. Filter `?type=forward|reverse|all`, `?from=`/`?to=` date window, `?order=`, `?limit=`. From x402stock
GET
/api/v1/splits/{ticker}
$0.01Historical stock splits for a ticker, with execution date and split ratio (split_from to split_to). Most recent first. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/spot
$0.02Live on-chain spot prices for every token on the Hyperliquid DEX (HYPE, PURR, and hundreds more), quoted in USDC: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap — sorted by 24h volume. Spot, not derivatives: for funding/open interest use /api/v1/perps; for major-coin fiat prices use /api/v1/crypto. From x402stock
GET
/api/v1/spot/candles/{token}
$0.02Historical OHLCV candles for one Hyperliquid spot market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w) over a time window. Pass a token symbol (e.g. HYPE, PURR) or @index and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or `?start=`/`?end=` epoch-ms. Spot candles — for perp candles use /api/v1/perps/candles/{coin}. From x402stock
GET
/api/v1/spot/orderbook/{token}
$0.01Level-2 order book for one Hyperliquid spot market: aggregated bid and ask price levels, each with size and resting order count, as of the book timestamp. Pass a token symbol (e.g. HYPE, PURR) or @index. Use to gauge spot liquidity, spread, and depth. Spot book — for the perp book use /api/v1/perps/orderbook/{coin}. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/spot/{token}
$0.01Live on-chain spot market for one Hyperliquid-listed token by symbol (e.g. HYPE, PURR) or @index: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap, quoted in USDC. Spot, not a perp — for funding/open interest use /api/v1/perps/{coin}; for major-coin fiat prices use /api/v1/crypto. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/squeeze/{ticker}
$0.04The short-squeeze picture for a US stock in one call: bi-weekly short interest with days-to-cover, daily short-sale volume with short-volume ratio, and settlement fails-to-deliver, plus a computed signal pulling the headline gauges together. Replaces three separate calls (short-interest + short-volume + fails-to-deliver) at a lower combined price. Sections degrade independently. From x402stock
GET
/api/v1/technicals/{ticker}
$0.03Use for a quick momentum or trend read on a US-listed stock. Returns the latest RSI (14) with overbought, oversold, or neutral zone, SMA 50 and EMA 20 with price position, and MACD with signal cross state, alongside the current delayed price. Factual indicator readings, not buy or sell guidance. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/ticker-types
$0.01Reference list of security type codes used in ticker reference data (e.g. CS = Common Stock, ETF, PFD, WARRANT) with descriptions. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/ticker/{ticker}
$0.01Company name, exchange, market cap, share class, SIC code, address, and other reference fields for a US-listed ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.
GET
/api/v1/tickers
$0.01Find tickers by free-text `?search=` (name or symbol) across asset classes via `?market=stocks|crypto|fx|indices` (default stocks), with optional `?type=`, `?exchange=`, `?active=`, `?limit=`. Returns symbol, name, market, exchange, type, and identifiers. Use to discover crypto pairs (X:BTCUSD), FX pairs (C:EURUSD), and index symbols (I:SPX). From x402stock
GET
/api/v1/treasury-yields
$0.01The daily US Treasury par yield curve (Constant Maturity Treasury rates) for every maturity from 1 month to 30 years, in percent. Defaults to the latest published day; pass `?limit=` for more recent days (max 250) and `?year=YYYY`. No ticker needed. Use for the risk-free rate, rate-sensitivity context, and yield-curve inversion in macro-aware analysis. From x402stock
GET
/api/v1/trending
$0.04Use for one call answering 'where is retail attention right now': a deterministic 0–100 attention score per ticker blending Reddit finance-community and 4chan /biz/ mention shares (24h window), with momentum, cross-platform confirmation, breadth & concentration (HHI), and Fear & Greed context. Transparent — every row carries its raw per-platform inputs. From x402stock
GET
/api/v1/trending/4chan
$0.01What tickers 4chan's finance board (/biz/) is buzzing about most over the last 24h, ranked by mention volume. Each ticker carries its mention count and 24h change in rank and mentions (4chan has no upvotes, so upvotes is always 0). No ticker needed; ?page= to paginate (100 per page). A raw read of /biz/ chatter, separate from the Reddit feed. From x402stock
GET
/api/v1/trending/reddit
$0.01What stocks and crypto Reddit is talking about most over the last 24h, by mention volume across the busiest Reddit money subreddits (r/wallstreetbets, r/stocks, r/CryptoCurrency, r/Bitcoin, etc.). Each ticker carries mentions, upvotes, and 24h change in rank and mentions; covered subreddits are listed per response. ?filter=stocks|crypto|all (default all), ?page=. From x402stock
GET
/api/v1/unified-snapshot
$0.02Snapshot a list of US-listed tickers at once: for each symbol, the company name, market session, current price, day change and percent change, day OHLCV with VWAP, and previous close. Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (up to 250). Built for pricing a watchlist or portfolio in a single request. From x402stock, a market & economic data API (x402, USDC).
GET
/api/v1/world-bank/country/{iso}
$0.02A country's macro profile in one call: latest GDP, GDP growth, GDP per capita, inflation, unemployment, population, government debt, current account, exports, and FDI, from the World Bank's World Development Indicators. Pass an ISO country code in the path (e.g. US, CN, IN, DE). International macro the US-only FRED/BLS endpoints don't cover. Source: World Bank (CC BY 4.0). From x402stock
GET
/api/v1/world-bank/{indicator}
$0.01Annual time series of one World Bank indicator for a country, with latest value, prior year, and change. Indicators: gdp, gdp-growth, gdp-per-capita, inflation, unemployment, population, govt-debt, current-account, exports, fdi. Pick the country with `?country=US` (ISO2/ISO3, default US) and the span with `?limit=` years (default 10). Cross-country macro reference. Source: World Bank (CC BY 4.0).
GET
/api/v1/xstocks
$0.04Use to monitor tokenized US equities (xStocks) against their real underlyings: every tracked xStock's on-chain price decoded from Raydium CLMM pool state on the public Solana ledger (no Backed/Chainlink/Pyth API), the underlying's live quote, and the premium/discount percent — plus pool liquidity, scaled-UI multiplier, and a us_market_open arb-context flag. From x402stock
GET
/api/v1/xstocks/{ticker}
$0.02Use to track one tokenized equity by xStock symbol (AAPLx) or underlying ticker (AAPL): the on-chain Raydium CLMM pool price from the public Solana ledger, the per-share price after its Token-2022 scaled-UI multiplier, the underlying's live quote, and the premium/discount percent. List every tracked symbol via /xstocks. From x402stock, a market & economic data API (x402, USDC).
Install on Your Agent
Add x402stock skills to any client
npx agentcash add https://agents.x402stock.xyzTransactions
Volume
Agents