Get Market Feed
GET/v1/stockmarket/news/feed
Market-wide news feed — freshest stories across the whole collected universe. Unlike the ticker-scoped ``/news``, this isn't limited to a caller's list: it returns the company stories we hold, each tagged with the ``sectors`` (trending-theme ids) its ticker belongs to. Coverage spans every sector because the daily refresh keeps all trending-sector stocks collected. By default the All feed is **sector-balanced** (round-robin across sectors) so one busy sector can't crowd out the rest; pass ``sort=newest`` for strict reverse-chronological. Pass ``sector=<id>`` to get just one theme's stories in a single call (no need to enumerate members). Same delayed/EOD posture and story shape as ``/news``.
Price
$0.01/ callEdge cache
900s
Uptime 24h
99.65%
p95
697ms
MCP tool
stockmarket_news-feed
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| sector | query | string | Narrow to one trending sector (theme id, e.g. `ai`, `energy`). |
| sort | query | string = balanced | `balanced` (default) rotates stories across sectors so the All feed isn't dominated by whichever sector published most recently; `newest` is strict reverse-chronological. Ignored when `sector` is set. |
| limit | query | integer = 20 | Max stories |
Code
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/stockmarket/news/feed"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/stockmarket/news/feed" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/stockmarket/news/feed")).json();
console.log(data);# pip install x402 eth-account requests
from eth_account import Account
from x402.clients.requests import x402_requests
session = x402_requests(Account.from_key(PRIVATE_KEY))
print(session.get("https://api.realtimeapi.ai/v1/stockmarket/news/feed").json())curl "https://api.realtimeapi.ai/v1/stockmarket/news/feed" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
How do I get get market feed from StockMarketAPI?
Send GET https://api.realtimeapi.ai/v1/stockmarket/news/feed. Pay $0.01 per request with x402, or send an X-API-Key header.
What does GET /news/feed cost?
$0.01 per successful request in USDC on Base. Failed requests are never charged.
Can I call this endpoint from an MCP client?
Yes. Connect any MCP client to the RealtimeAPI server and use call_feed with this endpoint's URL, or get_quote to check the price first.