Give your AI agent live market data for $0.01 per call
The News Gurus Intel API sells trading intelligence to AI agents. Your agent GETs an endpoint, receives HTTP 402 with payment terms, signs a USDC authorization, and retries. There is no account and no API key on that path. A subscriber API key is the other way in, for clients that cannot sign a payment.
The July 13, 2026 version of this guide listed five endpoints and said every
call costs $0.002–$0.05. That is stale. get_catalog on
October 6, 2026 lists 38 priced tools. The homepage still summarizes the surface
as “37+ endpoints … priced from $0.002 to $5.00 per call.”
newsgurus.ai/llms.txt describes the OpenAPI spec
as 47 paths. Prices below are the October 6, 2026 catalog. Educational data,
not financial advice.
A per-symbol signal call is $0.01. A regime check is $0.002. A tearsheet is $0.50. The full MLB props sheet is $5.00. Budget the call, not a flat band.
1. See what is for sale (free)
curl https://api.newsgurus.ai/x402/catalog
The same menu is the free MCP tool get_catalog at
https://api.newsgurus.ai/mcp/.
Free public probes also exist for regime, narratives, and the catalog
(/public/regime, /public/narratives,
/public/catalog). They are a thin read. The priced route is the
full payload. Do not cache one probe and treat it as the market regime
forever.
38 priced MCP tools
MCP name is what a client calls. Catalog id is what get_catalog
returned. Price is USDC per call. MCP names are from
https://api.newsgurus.ai/mcp.json. Prices and catalog ids were
re-read from get_catalog on October 6, 2026. If those two files
ever disagree, trust get_catalog for price and the manifest for the
name your client must call.
| MCP tool | Catalog id | HTTP | USD |
|---|---|---|---|
get_market_regime | x402_regime | GET /x402/regime | 0.002 |
get_agents_status | x402_agents_status | GET /x402/agents/status | 0.002 |
get_recent_intel | x402_brain_recent | GET /x402/brain/recent | 0.005 |
get_primary_scoops | x402_primary-scoops | GET /x402/primary-scoops | 0.02 |
get_spaces_intel | x402_spaces-intel | GET /x402/spaces-intel | 0.02 |
get_sports_edge_scan | x402_sports_edge-scan | GET /x402/sports/edge-scan | 0.008 |
get_anomalies | x402_brain_anomalies | GET /x402/brain/anomalies | 0.01 |
get_signals | x402_signals_symbol | GET /x402/signals/{symbol} | 0.01 |
verify_memecoin | x402_memecoin_verify_{mint} | GET /x402/memecoin/verify/{mint} | 0.01 |
get_memecoin_movers | x402_memecoin_movers | GET /x402/memecoin/movers | 0.02 |
get_symbol_sentiment | x402_sentiment_symbol | GET /x402/sentiment/{symbol} | 0.02 |
get_macro_snapshot | x402_macro_snapshot | GET /x402/macro/snapshot | 0.02 |
get_narratives | x402_narratives | GET /x402/narratives | 0.02 |
get_options_flow | x402_options_flow | GET /x402/options/flow | 0.05 |
get_dark_pool_prints | x402_darkpool_recent | GET /x402/darkpool/recent | 0.05 |
get_congress_trades | x402_congress_trades | GET /x402/congress/trades | 0.05 |
get_futures_snapshot | x402_futures_symbol | GET /x402/futures/{symbol} | 0.05 |
get_btc_snapshot | x402_btc_snapshot | GET /x402/btc/snapshot | 0.05 |
get_institutional_moves | x402_institutions_recent | GET /x402/institutions/recent | 0.05 |
get_kelly_outcomes | x402_brain_kelly | GET /x402/brain/kelly | 0.05 |
get_apex_signals | x402_apex_signals | GET /x402/apex/signals | 0.05 |
get_volatility_scan | x402_volatility_scan | GET /x402/volatility/scan | 0.05 |
get_launch_ta_confluence | x402_launch-ta_{token} | GET /x402/launch-ta/{token} | 0.05 |
get_satoshi_moves | x402_satoshi_moves | GET /x402/satoshi/moves | 0.05 |
get_composite_signal | x402_signals_composite_symbol | GET /x402/signals/composite/{symbol} | 0.05 |
get_polymarket_new_wallets | x402_prediction_new-wallets | GET /x402/prediction/new-wallets | 0.05 |
get_polymarket_market_stats | x402_prediction_market-stats_{condition_id} | GET /x402/prediction/market-stats/{condition_id} | 0.05 |
get_gamma_exposure | x402_options_gex_symbol | GET /x402/options/gex/{symbol} | 0.10 |
get_institutional_stock | x402_institutions_symbol | GET /x402/institutions/{symbol} | 0.10 |
get_polymarket_market_landscape | x402_prediction_markets | GET /x402/prediction/markets | 0.10 |
get_polymarket_whales | x402_prediction_whales | GET /x402/prediction/whales | 0.10 |
get_polymarket_whale_leaders | x402_prediction_whale-leaders | GET /x402/prediction/whale-leaders | 0.10 |
get_trade_decisions | x402_brain_decisions | GET /x402/brain/decisions | 0.10 |
get_sports_props | x402_sports_props | GET /x402/sports/props | 0.10 |
get_equity_rankings | x402_stocks_rankings | GET /x402/stocks/rankings | 0.25 |
get_symbol_tearsheet | x402_tearsheet_symbol | GET /x402/tearsheet/{symbol} | 0.50 |
get_mlb_top_picks | x402_mlb_picks | GET /x402/mlb/picks | 3.00 |
get_mlb_props_sheet | x402_mlb_props-sheet | GET /x402/mlb/props-sheet | 5.00 |
What each group is for
Regime and liveness. get_market_regime returns
TRENDING, MEAN_REVERTING, or VOL_EXPANSION with a confidence score.
get_agents_status is the liveness probe: per-agent counts over the
last 24 hours. Call it before you buy a more expensive read.
SharedBrain. A 40-source cross-agent store.
get_recent_intel is the latest ideas (optional symbol, up to 25).
X Space filings are included in those ideas and in spaces, so a
bot that already polls this feed does not need get_spaces_intel.
The factual brief is the idea description. our_opinion stays a
labeled sibling and is not copied into that description.
get_narratives is NARRATIVE_SYNTHESIS and CATALYST_CONVERGENCE from
website_intelligence_agent, plus speaker theses from X Spaces
(SPACES_THESIS). News Gurus opinion is not in that feed.
get_spaces_intel is the full Space: summary, verified quotes, and
a labeled opinion. get_anomalies is the bot’s own risk
filter. get_trade_decisions is the LLM routing chain.
get_kelly_outcomes is the outcome ledger.
Equity flow and signals. get_signals is one
symbol (default lookback 24 hours). get_composite_signal merges the
50 latest signals from 42 generators. Catalog line: “The only x402 API selling
derived US-equity signals rather than raw quotes.” get_options_flow
is “the per-call alternative to $50-150/mo flow subscriptions.”
get_dark_pool_prints does not include raw notional or price.
get_gamma_exposure returns a dealer-regime label such as
positive_gamma_pinning or negative_gamma_amplifying, not raw gamma dollars.
get_symbol_tearsheet is “the single call an agent needs before a
trade decision.”
Congress and institutions. get_congress_trades
is STOCK Act data and “the per-call alternative to $25-75/mo congressional-data
subscriptions.” get_institutional_moves is 13F changes: new,
increased, decreased, sold. get_institutional_stock merges congress
and 13F for one ticker. Analyst ratings and fundamentals are excluded.
Crypto and memecoins. get_futures_snapshot plus
get_apex_signals (APEX v10.2, five-source confluence: CLV, VSA,
flow, CVDD, pivots). get_btc_snapshot and
get_satoshi_moves cover dormant-wallet movement.
get_volatility_scan scores ATR percent and volume squeeze.
verify_memecoin returns PASS, SMALL_SNIPER, MONITOR, or REJECT.
get_memecoin_movers takes chain=solana|base|bsc|ethereum.
get_launch_ta_confluence returns a VWAP / Bollinger / RSI / MACD
verdict. Raw candles are not redistributed.
Prediction markets. Landscape (up to 2000 markets), whales, whale leaders, new wallets, and per-market stats. Whale leaders: “elsewhere this data class sits behind $599/mo API plans.”
Sports. 21+. Not betting advice.
get_sports_edge_scan uses STRONG_PLAY, PLAY, MONITOR, or SKIP.
get_sports_props omits raw PropsMadness fields. MLB picks are $3.
The full MLB props sheet is $5. Statcast, park, weather, and sim inputs are used
internally and are not redistributed.
Other. get_symbol_sentiment (LunarCrush,
StockTwits, Telegram, X). get_macro_snapshot (regime plus Fed, BIS,
prediction-market, and geopolitical notes). get_equity_rankings at
$0.25.
HTTP-only routes: confirm before live
get_catalog on October 6, 2026. They are not MCP tool names.
Confirm a route is still deployed before you rely on it.| HTTP | USD | What it is |
|---|---|---|
GET /api/v1/signals | 0.01 | Market-wide signal feed |
GET /api/v1/sentiment | 0.01 | Aggregated sentiment snapshot |
GET /api/v1/brain/{symbol} | 0.02 | SharedBrain context for one symbol |
GET /x402/fantasy/rankings | 1.00 | Rankings export |
GET /x402/fantasy/waivers | 1.00 | Waiver picks |
GET /x402/fantasy/streaming | 1.00 | Streaming-slot planner |
GET /x402/fantasy/lineup | 1.50 | Start/sit optimizer |
GET /x402/fantasy/draft-pick | 2.00 | One VBD pick |
GET /x402/fantasy/trade | 2.00 | ACCEPT / COUNTER / DECLINE |
GET /x402/fantasy/playoff | 2.00 | Playoff-week schedule |
GET /x402/fantasy/draft-advisor | 3.00 | Live draft-room poll |
Fantasy responses are advisory. The person still clicks the pick.
2. Fund a wallet (USDC only — no ETH for the payer)
x402 payments use EIP-3009 transferWithAuthorization. The July
13 version of this guide states this is gasless for the payer: the facilitator
settles on-chain. Send USDC on Base to the buyer wallet and export that wallet’s
key into the agent host, not into a prompt.
A few dollars covers many $0.002 regime checks. It does not cover many $5 sheet calls. Size the wallet to the tools you actually call.
If the agent cannot hold a key, request a subscriber key from News Gurus.
Send it as Authorization: Bearer, or X-API-Key, or as
?api_key= if the client cannot set headers. Calls then sit inside
the plan rate limit and fall through to HTTP 402 if the key is missing, invalid,
or over the limit.
3. Pay from Python
This is the sample already published on this guide. It was not re-run for this update. Replace the placeholder with your own buyer key.
pip install x402 requests eth-account
from eth_account import Account
from x402.client import x402ClientSync
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import ExactEvmScheme
from x402.http.clients.requests import x402_requests
account = Account.from_key("0xYOUR_BUYER_PRIVATE_KEY")
client = x402ClientSync()
client.register("eip155:8453", ExactEvmScheme(signer=EthAccountSigner(account)))
session = x402_requests(client) # a requests.Session that handles 402s
data = session.get("https://api.newsgurus.ai/x402/regime").json()
print(data)
4. Wrap it for CrewAI, LangChain, or any tool-calling framework
Give the agent cheap tools by default. Make it spend $0.05 or $0.50 only when a decision is close.
def market_regime() -> dict:
"""Current market regime: TRENDING, MEAN_REVERTING, or VOL_EXPANSION. Costs $0.002 in USDC via x402."""
return session.get("https://api.newsgurus.ai/x402/regime").json()
def symbol_signals(symbol: str) -> dict:
"""Recent signals for one ticker. $0.01/call."""
return session.get(f"https://api.newsgurus.ai/x402/signals/{symbol}").json()
def symbol_tearsheet(symbol: str) -> dict:
"""One-call tearsheet before a decision. $0.50/call."""
return session.get(f"https://api.newsgurus.ai/x402/tearsheet/{symbol}").json()
How it settles
The July 13 version of this guide says payments verify and settle through the Coinbase CDP facilitator, and that every purchase is publicly auditable on Base. Protocol write-up: how x402 works end-to-end.
Human plans, if the reader is not an agent: Everyday $19/mo ($190/yr), PRO $130/mo ($1,300/yr), Lifetime $5,000 once. The homepage win rate and trades logged are both “—”. Full verified P&L publishes when it is green.
Machine docs: newsgurus.ai/llms.txt and api.newsgurus.ai/llms.txt.
Educational data, not financial advice. Sports tools are 21+ and are not betting advice.