Research a company
Retrieve earnings and regulatory coverage with links your agent can include in its research notes.
One request. Evidence your workflow can use.
Check the coverage
See source diversity, publisher countries, languages and media tone for a topic.
Build a recurring briefing
Call from your own scheduled workflow. Each successful request is billed separately; scheduling and change detection belong to your agent.
Connect in three steps
- Inspect the free illustrative response and agent guide.
- Use an x402 v2 client with a Base USDC wallet. Set a maximum payment of 0.01 USDC for a brief.
- Request a topic, inspect HTTP 402 payment requirements, then let the client sign and retry the same request.
This command only inspects payment requirements. It does not pay:
curl -i 'https://news-x402.com/news/brief?query=NVIDIA%20earnings&audience=markets×pan=24h&limit=5'OpenClaw: use the integration guide with your existing wallet-capable client. Plain HTTP fetching cannot complete payment. End-to-end payment through OpenClaw has not yet been verified for this release.
Know what the data means
Developments are attributed headlines, not independently verified events or full-article summaries. GDELT is a free source; the fee covers this API’s aggregation and delivery.
Brief coverage is sampled from at most 100 articles. Publisher country is not event location. Media tone is not investment advice. first_seen_at records GDELT discovery time; published_at is unknown and returns null. Data may be delayed and requests may return no matching articles.
Invalid inputs are rejected before payment. Upstream failures are not settled. A successful response with no matching articles is still a paid request.
Why this wrapper
GDELT is a free, well-known public source — but querying it raw is painful for AI agents. Here's what we add:
| Raw GDELT | This API |
|---|---|
| GDELT discovery timestamp | Explicit first_seen_at; publication time is unknown (published_at: null) |
7+ raw modes to learn (artlist, timelinetone, pointdata…) | 6 task-oriented endpoints, including a decision-ready market/OSINT brief |
| Multi-step research and repeated source parsing | Parallel aggregation, deduplication, caching, source diversity, risk flags, and citations |
| Transient throttling and opaque failures | Timeouts, retry, short-lived cache, and explicit non-settled upstream errors |
| GEO 2.0 API discontinued — calls fail | Replaced with article-source-country aggregation — works reliably |
| API keys, IP whitelist for scale | x402 — sign once with your wallet, done |
Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /news/brief | Decision-ready brief for market and OSINT agents | $0.01 |
GET /news/recent | Top 25 recent articles | $0.01 |
GET /news/sentiment | Sentiment timeline | $0.02 |
GET /news/geographic | Geographic hotspots by source country | $0.02 |
GET /news/translingual | Multi-language coverage | $0.03 |
GET /news/entity-graph | Entity knowledge graph | $0.05 |
How to use
Each endpoint requires an x402 payment in USDC on Base mainnet. Send a request without payment to receive HTTP 402 with the payment requirements in the PAYMENT-REQUIRED response header. Sign the authorization and retry with the PAYMENT-SIGNATURE header to receive the JSON response.
Settlement is handled by the Coinbase CDP facilitator.
Discovery
- /.well-known/x402 — machine-readable resource list
- /openapi.json — OpenAPI 3.1 specification with x-payment-info
- /.well-known/llms.txt — AI-readable documentation
- /SKILL.md — ready-to-use instructions for AI agents