API reference / Multi-source bundles

Multi-source bundles

One call that replaces a whole sequence, priced below the parts.

3 endpoints. Pay per call in USDC via x402 with no account, or get unlimited calls for $99/mo. Every response is shaped { ticker, data, source, as_of }.

GET/api/v1/overview/{ticker}$0.05

Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers

Use 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.

Example request
GET /api/v1/overview/AAPL
Response type (TypeScript)
interface OverviewResponse {
  ticker: string;
  source: string;
  as_of: string;
  sections: {
    profile: string;
    price: string;
    fundamentals: string;
    dividends: string;
    corporate_actions: string;
    technicals: string;
    news: string;
    peers: string;
  };
  profile: {
    name: string;
    exchange: string;
    type: string;
    sector: string;
    sic_code: string;
    market_cap: number;
    shares_outstanding: number;
    employees: number;
    list_date: string;
    homepage: string;
    description: string;
    logo_url: string;
  };
  price: {
    last: number;
    change: number;
    change_percent: number;
    day: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
    };
    previous_close: number;
    is_delayed: boolean;
    delayed_by: string;
    timestamp: null;
  };
  fundamentals: {
    period: string;
    fiscal_period: string;
    fiscal_year: null;
    end_date: string;
    revenue: number;
    net_income: number;
    gross_profit: number;
    eps: number;
    pe_ratio: number;
    gross_margin_percent: number;
    net_margin_percent: number;
  };
  dividends: {
    annualized_amount: number;
    yield_percent: null;
    frequency: number;
    last: {
      cash_amount: number;
      ex_dividend_date: string;
      pay_date: string;
    };
    count: number;
  };
  corporate_actions: {
    splits: Array<{
      execution_date: string;
      type: string;
      split_from: number;
      split_to: number;
      ratio: number;
      ratio_text: string;
    }>;
    events: Array<{
      type: string;
      date: string;
      ticker: string;
    }>;
  };
  technicals: {
    rsi_14: {
      value: number;
      zone: string;
    };
    sma_50: {
      value: number;
      price_vs_percent: number;
      position: string;
    };
    ema_20: {
      value: number;
      price_vs_percent: number;
      position: string;
    };
    macd: {
      value: number;
      signal: number;
      histogram: number;
      position: string;
    };
  };
  news: Array<{
    title: string;
    url: string;
    publisher: string;
    published_at: string;
    tickers: string[];
  }>;
  peers: string[];
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:30.950Z",
  "sections": {
    "profile": "ok",
    "price": "ok",
    "fundamentals": "ok",
    "dividends": "ok",
    "corporate_actions": "ok",
    "technicals": "ok",
    "news": "ok",
    "peers": "ok"
  },
  "profile": {
    "name": "Apple Inc.",
    "exchange": "XNAS",
    "type": "CS",
    "sector": "ELECTRONIC COMPUTERS",
    "sic_code": "3571",
    "market_cap": 4583336313360,
    "shares_outstanding": 14687356000,
    "employees": 166000,
    "list_date": "1980-12-12",
    "homepage": "https://www.apple.com",
    "description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses. Apple's iPhone makes up a majority of the firm sales, and Apple's other products like Mac, iPad, and Watch are designed around the iPhone as the focal point of an expansive software ecosystem. Apple has progressively worked to add new applications, like streaming video, subscription bundles, and augmented reality. The firm designs its own software and semiconductors while working with subcontractors like Foxconn and TSMC to build its products and chips. Slightly less than half of Apple's sales come directly through its flagship stores, with a majority of sales coming indirectly through partnerships and distribution.",
    "logo_url": "https://api.massive.com/v1/reference/company-branding/YXBwbGUuY29t/images/2025-04-04_logo.svg"
  },
  "price": {
    "last": 0,
    "change": 0,
    "change_percent": 0,
    "day": {
      "open": 0,
      "high": 0,
      "low": 0,
      "close": 0,
      "volume": 0,
      "vwap": 0
    },
    "previous_close": 312.06,
    "is_delayed": true,
    "delayed_by": "15 minutes",
    "timestamp": null
  },
  "fundamentals": {
    "period": "ttm",
    "fiscal_period": "TTM",
    "fiscal_year": null,
    "end_date": "2026-03-28",
    "revenue": 451442000000,
    "net_income": 122575000000,
    "gross_profit": 216071000000,
    "eps": 8.26,
    "pe_ratio": 0,
    "gross_margin_percent": 47.86,
    "net_margin_percent": 27.15
  },
  "dividends": {
    "annualized_amount": 1.08,
    "yield_percent": null,
    "frequency": 4,
    "last": {
      "cash_amount": 0.27,
      "ex_dividend_date": "2026-05-11",
      "pay_date": "2026-05-14"
    },
    "count": 8
  },
  "corporate_actions": {
    "splits": [
      {
        "execution_date": "2020-08-31",
        "type": "forward",
        "split_from": 1,
        "split_to": 4,
        "ratio": 4,
        "ratio_text": "4:1"
      },
      {
        "execution_date": "2014-06-09",
        "type": "forward",
        "split_from": 1,
        "split_to": 7,
        "ratio": 7,
        "ratio_text": "7:1"
      },
      {
        "execution_date": "2005-02-28",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      },
      {
        "execution_date": "2000-06-21",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      },
      {
        "execution_date": "1987-06-16",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      }
    ],
    "events": [
      {
        "type": "ticker_change",
        "date": "2003-09-10",
        "ticker": "AAPL"
      }
    ]
  },
  "technicals": {
    "rsi_14": {
      "value": 78.56,
      "zone": "overbought"
    },
    "sma_50": {
      "value": 275.2846,
      "price_vs_percent": -100,
      "position": "below"
    },
    "ema_20": {
      "value": 297.8868,
      "price_vs_percent": -100,
      "position": "below"
    },
    "macd": {
      "value": 10.3911,
      "signal": 9.7764,
      "histogram": 0.6147,
      "position": "above_signal"
    }
  },
  "news": [
    {
      "title": "Why This Fund Sold $35 Million of Bristow Group Amid a 40% Stock Surge",
      "url": "https://www.fool.com/coverage/filings/2026/05/31/why-this-fund-sold-usd35-million-of-bristow-group-amid-a-40-stock-surge/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:00:12Z",
      "tickers": [
        "VTOL",
        "AAPL",
        "MSFT",
        "NVDA"
      ]
    },
    {
      "title": "Greg Abel Just Dumped Amazon Stock. Here Are 5 Reasons to Buy It.",
      "url": "https://www.fool.com/investing/2026/05/31/greg-abel-just-dumped-amazon-stock-here-are-5-reas/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T13:05:00Z",
      "tickers": [
        "AMZN",
        "BRK.A",
        "BRK.B",
        "META",
        "AAPL",
        "NVDA"
      ]
    },
    {
      "title": "Apple's AI Future, Stock Surge, Nvidia CEO's New Role And More: This Week In Appleverse",
      "url": "https://www.benzinga.com/markets/tech/26/05/52893985/apples-ai-future-stock-surge-nvidia-ceos-new-role-and-more-this-week-in-appleverse?utm_source=benzinga_taxonomy&utm_medium=rss_feed_free&utm_content=taxonomy_rss&utm_campaign=channel",
      "publisher": "Benzinga",
      "published_at": "2026-05-31T11:01:02Z",
      "tickers": [
        "AAPL",
        "NVDA"
      ]
    },
    {
      "title": "45.7% of Berkshire Hathaway's Portfolio Is Parked in 3 Stocks That Could Pay the Conglomerate $1.6 Billion in Dividends This Year",
      "url": "https://www.fool.com/investing/2026/05/31/457-berkshire-3-stocks-pay-16-billion-dividends/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T10:30:00Z",
      "tickers": [
        "AAPL",
        "AXP",
        "KO",
        "BRK.A",
        "BRK.B"
      ]
    },
    {
      "title": "Wall Street Says the Stock Market's Return Will Crush the Long-Term Average in the Next Year",
      "url": "https://www.fool.com/investing/2026/05/31/stock-market-return-will-crush-long-term-average/?source=iedfolr
… (truncated — call the endpoint for the full response)
GET/api/v1/compare$0.05

Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield

Compare 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.

Example request
GET /api/v1/compare
Response type (TypeScript)
interface CompareResponse {
  source: string;
  as_of: string;
  count: number;
  tickers: string[];
  rows: Array<{
    ticker: string;
    name: string;
    price: number;
    change_percent: number;
    market_cap: number;
    pe_ratio: number;
    eps: number;
    revenue: number;
    gross_margin_percent: number;
    net_margin_percent: number;
    dividend_yield_percent: null;
    available: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:23.966Z",
  "count": 2,
  "tickers": [
    "AAPL",
    "MSFT"
  ],
  "rows": [
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "price": 0,
      "change_percent": 0,
      "market_cap": 4583336313360,
      "pe_ratio": 0,
      "eps": 8.26,
      "revenue": 451442000000,
      "gross_margin_percent": 47.86,
      "net_margin_percent": 27.15,
      "dividend_yield_percent": null,
      "available": "ok"
    },
    {
      "ticker": "MSFT",
      "name": "Microsoft Corp",
      "price": 0,
      "change_percent": 0,
      "market_cap": 3344578441128.96,
      "pe_ratio": 0,
      "eps": 16.79,
      "revenue": 318273000000,
      "gross_margin_percent": 68.31,
      "net_margin_percent": 39.34,
      "dividend_yield_percent": null,
      "available": "ok"
    }
  ]
}
GET/api/v1/market-pulse$0.03

Market movers in one call: top gainers, top losers, market status, news

Use 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.

Example request
GET /api/v1/market-pulse
Response type (TypeScript)
interface MarketPulseResponse {
  source: string;
  as_of: string;
  market_status: {
    market: string;
    early_hours: boolean;
    after_hours: boolean;
  };
  gainers: unknown[];
  losers: unknown[];
  news: Array<{
    title: string;
    url: string;
    publisher: string;
    published_at: string;
    tickers: string[];
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T15:19:41-04:00",
  "market_status": {
    "market": "closed",
    "early_hours": false,
    "after_hours": false
  },
  "gainers": [],
  "losers": [],
  "news": [
    {
      "title": "What to Know About This Fund's $194 Million Exit From a China Logistics Stock",
      "url": "https://www.fool.com/coverage/filings/2026/05/31/what-to-know-about-this-fund-s-usd194-million-exit-from-a-china-logistics-stock/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:33:16Z",
      "tickers": [
        "YMM",
        "NU",
        "CPNG"
      ]
    },
    {
      "title": "The S&P 500's Dividend Yield Hasn't Been This Low Since the 1800s. That Makes This Top Dividend ETF Even More Enticing.",
      "url": "https://www.fool.com/investing/2026/05/31/the-sp-500s-dividend-yield-hasnt-been-this-low-sin/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:30:00Z",
      "tickers": [
        "SCHD",
        "VOO"
      ]
    },
    {
      "title": "Futu Investor News: If You Have Suffered Losses in Futu Holdings Limited (NASDAQ: FUTU), You Are Encouraged to Contact The Rosen Law Firm About Your Rights",
      "url": "https://www.globenewswire.com/news-release/2026/05/31/3303941/673/en/Futu-Investor-News-If-You-Have-Suffered-Losses-in-Futu-Holdings-Limited-NASDAQ-FUTU-You-Are-Encouraged-to-Contact-The-Rosen-Law-Firm-About-Your-Rights.html",
      "publisher": "GlobeNewswire Inc.",
      "published_at": "2026-05-31T18:27:00Z",
      "tickers": [
        "FUTU",
        "TIGR"
      ]
    },
    {
      "title": "This Is My Best Artificial Intelligence (AI) Stock to Buy in June (Hint: It's Not Micron Technology)",
      "url": "https://www.fool.com/investing/2026/05/31/this-is-my-best-artificial-intelligence-ai-stock-t/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:23:00Z",
      "tickers": [
        "CIEN",
        "MU"
      ]
    },
    {
      "title": "Is This Ultimate High-Yield Stock Actually Going to $0?",
      "url": "https://www.fool.com/investing/2026/05/31/is-this-ultimate-highyield-stock-actually-going-to/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:15:00Z",
      "tickers": [
        "CAG"
      ]
    }
  ]
}