API reference / News & market

News & market

Headlines and free market-status / holiday calendars.

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/news$0.02

Latest news articles, optionally filtered by ticker

Curated stock-market news with ticker tags, source, publisher, image, and timestamps. Pass `?ticker=AAPL` to filter.

Example request
GET /api/v1/news
Response type (TypeScript)
interface NewsResponse {
  source: string;
  as_of: string;
  count: number;
  articles: Array<{
    id: string;
    title: string;
    description: string;
    url: string;
    image_url: string;
    author: string;
    publisher: string;
    publisher_homepage: string;
    published_at: string;
    tickers: string[];
    keywords: string[];
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:16.414Z",
  "count": 10,
  "articles": [
    {
      "id": "f0285c3945e98745a6b93c7694b0fd9c353a283ca06db0490a28f1d0a6a6f7e9",
      "title": "Why This Fund Sold $35 Million of Bristow Group Amid a 40% Stock Surge",
      "description": "South Dakota Investment Council sold 801,900 shares of Bristow Group (valued at $35.24 million) in Q1 2026, reducing its stake to 1.8% of reportable assets. Despite the sale, Bristow Group shares have surged 40% over the past year, outperforming the S&P 500's 28% gain. The company reported strong Q1 results with revenue of $388.7 million and maintained its 2026 adjusted EBITDA guidance of $295-$325 million, citing growth opportunities in defense spending, energy security, and electric aircraft.",
      "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",
      "image_url": "https://g.foolcdn.com/image/?url=https%3A%2F%2Fcdn.content.foolcdn.com%2Fimages%2F1umn9qeh%2Fproduction%2F1a599f395be31e2f508c3aa7decb988f9ce983b7-1401x1251.png%3Fw%3D800%26q%3D75%26fit%3Dmax%26auto%3Dformat&w=1200&op=resize",
      "author": "Jonathan Ponciano",
      "publisher": "The Motley Fool",
      "publisher_homepage": "https://www.fool.com/",
      "published_at": "2026-05-31T18:00:12Z",
      "tickers": [
        "VTOL",
        "AAPL",
        "MSFT",
        "NVDA"
      ],
      "keywords": [
        "fund sale",
        "position reduction",
        "stock surge",
        "aviation services",
        "offshore energy",
        "defense spending",
        "EBITDA guidance"
      ]
    },
    {
      "id": "2e3d51de95c615581f69c8f2e0caa6ee9bda71fb6e8d35e2606bd33c8fc7ef17",
      "title": "Greg Abel Just Dumped Amazon Stock. Here Are 5 Reasons to Buy It.",
      "description": "Despite Berkshire Hathaway's recent sale of Amazon stock, the article argues Amazon remains an attractive buy for retail investors. The company is capitalizing on AI opportunities through AWS, custom chips, and development tools, while maintaining strong e-commerce growth and preparing to launch satellite broadband services. Amazon trades at a P/E of 32, which the author considers attractive given its growth prospects.",
      "url": "https://www.fool.com/investing/2026/05/31/greg-abel-just-dumped-amazon-stock-here-are-5-reas/?source=iedfolrf0000001",
      "image_url": "https://g.foolcdn.com/image/?url=https%3A%2F%2Fg.foolcdn.com%2Feditorial%2Fimages%2F871972%2Famazon-driver.jpg&w=1200&op=resize",
      "author": "Jennifer Saibil",
      "publisher": "The Motley Fool",
      "publisher_homepage": "https://www.fool.com/",
      "published_at": "2026-05-31T13:05:00Z",
      "tickers": [
        "AMZN",
        "BRK.A",
        "BRK.B",
        "META",
        "AAPL",
        "NVDA"
      ],
      "keywords": [
        "Amazon",
        "artificial intelligence",
        "AWS",
        "cloud computing",
        "e-commerce",
        "satellite broadband",
        "semiconductor chips",
        "stock valuation"
      ]
    },
    {
      "id": "94cc128e6c62097cc5af6be43cd2b81b7ab44d469aac0283803233cc3d8d196f",
      "title": "Apple's AI Future, Stock Surge, Nvidia CEO's New Role And More: This Week In Appleverse",
      "description": "Apple's stock surged 15% in May, driven by speculation about its position in AI and the 'agentic smartphone opportunity,' with Bank of America raising its price target to $380. Meanwhile, Nvidia CEO Jensen Huang joined the advisory board of Tsinghua University's School of Economics and Management in China.",
      "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",
      "image_url": "https://cdn.benzinga.com/cdn-cgi/image/width=1200,height=800,fit=crop/files/images/story/2026/05/31/Apple-logo-is-seen-at-the-Apple-Wangfuji.jpeg",
      "author": "Mohd Haider",
      "publisher": "Benzinga",
      "publisher_homepage": "https://www.benzinga.com/",
      "published_at": "2026-05-31T11:01:02Z",
      "tickers": [
        "AAPL",
        "NVDA"
      ],
      "keywords": [
        "Apple AI",
        "agentic smartphone",
        "stock surge",
        "Nvidia CEO",
        "Tsinghua University",
        "Bank of America price target",
        "valuation driver"
      ]
    },
    {
      "id": "dca90f5ce47b368023c90a0fe0efa4ec0de6443b5d05051ea0e3c39acc927f7b",
      "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",
      "description": "Berkshire Hathaway's three largest stock holdings, Apple, American Express, and Coca-Cola, collectively represent 45.7% of its $330 billion portfolio and are expected to generate $1.6 billion in combined dividend payments in 2026. These long-standing positions demonstrate the power of dividend reinvestment and compounding returns under Warren Buffett's investment philosophy, which new CEO Greg Abel is expected to continue.",
      "url": "https://www.fool.com/investing/2026/05/31/457-berkshire-3-stocks-pay-16-billion-dividends/?source=iedfolrf0000001",
      "image_url": "https://g.foolcdn.com/image/?url=https%3A%2F%2Fg.foolcdn.com%2Feditorial%2Fimages%2F872145%2Fa-candid-shot-of-warren-buffett-looking-away-from-the-camera.jpg&w=1200&op=resize",
      "author": "Anthony Di Pizio",
      "publisher": "The Motley Fool",
      "publisher_homepage": "https://www.fool.com/",
      "published_at": "2026-05-31T10:30:00Z",
      "tickers": [
        "AAPL",
        "AXP",
        "KO",
        "BRK.A",
        "BRK.B"
      ],
      "keywords": [
        "Berkshire Hathaway",
        "dividend payments",
        "portfolio concentration",
        "long-term investing",
        "compounding returns",
        "War
… (truncated — call the endpoint for the full response)
GET/api/v1/market-statusfree

Current US market status (open / closed / pre / post)

Free endpoint. Returns whether US equities markets are currently in regular, pre-market, after-hours, or closed sessions.

Example request
GET /api/v1/market-status
Response type (TypeScript)
interface MarketStatusResponse {
  source: string;
  as_of: string;
  market: string;
  early_hours: boolean;
  after_hours: boolean;
  exchanges: {
    nasdaq: string;
    nyse: string;
    otc: string;
  };
  currencies: {
    crypto: string;
    fx: string;
  };
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T19:53:16-04:00",
  "market": "extended-hours",
  "early_hours": false,
  "after_hours": true,
  "exchanges": {
    "nasdaq": "extended-hours",
    "nyse": "extended-hours",
    "otc": "closed"
  },
  "currencies": {
    "crypto": "open",
    "fx": "open"
  }
}
GET/api/v1/market-holidaysfree

Upcoming US market holidays & early closes

Free endpoint. Upcoming market holidays and early-close days per exchange, with date, status, and (for early closes) open/close times.

Example request
GET /api/v1/market-holidays
Response type (TypeScript)
interface MarketHolidaysResponse {
  source: string;
  as_of: string;
  count: number;
  holidays: Array<{
    date: string;
    exchange: string;
    name: string;
    status: string;
    open: string;
    close: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T23:53:16.954Z",
  "count": 24,
  "holidays": [
    {
      "date": "2026-06-19",
      "exchange": "NYSE",
      "name": "Juneteenth",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-06-19",
      "exchange": "NASDAQ",
      "name": "Juneteenth",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-07-03",
      "exchange": "NASDAQ",
      "name": "Independence Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-07-03",
      "exchange": "NYSE",
      "name": "Independence Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-09-07",
      "exchange": "NASDAQ",
      "name": "Labor Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-09-07",
      "exchange": "NYSE",
      "name": "Labor Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-11-26",
      "exchange": "NASDAQ",
      "name": "Thanksgiving",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-11-26",
      "exchange": "NYSE",
      "name": "Thanksgiving",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-11-27",
      "exchange": "NYSE",
      "name": "Thanksgiving",
      "status": "early-close",
      "open": "2026-11-27T14:30:00.000Z",
      "close": "2026-11-27T18:00:00.000Z"
    },
    {
      "date": "2026-11-27",
      "exchange": "NASDAQ",
      "name": "Thanksgiving",
      "status": "early-close",
      "open": "2026-11-27T14:30:00.000Z",
      "close": "2026-11-27T18:00:00.000Z"
    },
    {
      "date": "2026-12-24",
      "exchange": "NASDAQ",
      "name": "Christmas",
      "status": "early-close",
      "open": "2026-12-24T14:30:00.000Z",
      "close": "2026-12-24T18:00:00.000Z"
    },
    {
      "date": "2026-12-24",
      "exchange": "NYSE",
      "name": "Christmas",
      "status": "early-close",
      "open": "2026-12-24T14:30:00.000Z",
      "close": "2026-12-24T18:00:00.000Z"
    },
    {
      "date": "2026-12-25",
      "exchange": "NASDAQ",
      "name": "Christmas",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-12-25",
      "exchange": "NYSE",
      "name": "Christmas",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-01",
      "exchange": "NASDAQ",
      "name": "New Years Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-01",
      "exchange": "NYSE",
      "name": "New Years Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-18",
      "exchange": "NASDAQ",
      "name": "Martin Luther King, Jr. Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-18",
      "exchange": "NYSE",
      "name": "Martin Luther King, Jr. Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-02-15",
      "exchange": "NYSE",
      "name": "Washington's Birthday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-02-15",
      "exchange": "NASDAQ",
      "name": "Washington's Birthday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-03-26",
      "exchange": "NYSE",
      "name": "Good Friday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-03-26",
      "exchange": "NASDAQ",
      "name": "Good Friday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-05-31",
      "exchange": "NASDAQ",
      "name": "Memorial Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-05-31",
      "exchange": "NYSE",
      "name": "Memorial Day",
      "status": "closed",
      "open": null,
      "close": null
    }
  ]
}