Global news attention and tone for any company, ticker, or topic, from the GDELT Project's
Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds. From x402stock
20000 (raw units)
price
2
calls / 30d
2
unique payers
2026-09-14
updated
Provider
x402stock.xyz · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x3070Fbb3803819fB5BdfE9286fdc6325A877fA85",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "20000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"q": "Nvidia",
"timespan": "1w"
},
"type": "http"
},
"output": {
"example": {
"as_of": "2026-06-06T02:40:00.000Z",
"attribution": "Source: The GDELT Project (https://www.gdeltproject.org/)",
"query": "Nvidia",
"recent_articles": [
{
"domain": "techtimes.com",
"language": "English",
"seen": "2026-06-06T02:15:00Z",
"source_country": "United States",
"title": "NVIDIA Is Not the Only AI Chip Winner: Broadcom Forecasts $56 Billion",
"url": "https://www.techtimes.com/articles/317846/20260605/nvidia-not-only-ai-chip-winner-broadcom.htm"
}
],
"sentiment": {
"average_tone": 0.31,
"label": "neutral",
"latest_tone": 0.42,
"scale": "GDELT average tone, roughly -10 (very negative) to +10 (very positive); 0 is neutral.",
"trend": "improving"
},
"source": "x402stock",
"timespan": "1w",
"tone_timeline": [
{
"date": "2026-06-06T00:00:00Z",
"tone": -0.198
},
{
"date": "2026-06-06T01:00:00Z",
"tone": 0.755
},
{
"date": "2026-06-06T02:00:00Z",
"tone": 0.42
}
],
"venue": "gdelt",
"volume": {
"points": 167,
"total_articles": 2841
},
"volume_timeline": [
{
"articles": 21,
"date": "2026-06-06T01:00:00Z",
"total_monitored": 3104
},
{
"articles": 17,
"date": "2026-06-06T02:00:00Z",
"total_monitored": 3179
}
]
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"q": {
"maxLength": 120,
"minLength": 2,
"type": "string"
},
"timespan": {
"default": "1w",
"enum": [
"1d",
"3d",
"1w",
"2w",
"1m",
"3m"
],
"type": "string"
}
},
"required": [
"timespan"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"as_of": {
"type": "string"
},
"attribution": {
"type": "string"
},
"query": {
"type": "string"
},
"recent_articles": {
"items": {
"additionalProperties": false,
"properties": {
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"seen": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"title",
"url",
"domain",
"source_country",
"language",
"seen"
],
"type": "object"
},
"type": "array"
},
"sentiment": {
"additionalProperties": false,
"properties": {
"average_tone": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"label": {
"type": "string"
},
"latest_tone": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"scale": {
"type": "string"
},
"trend": {
"type": "string"
}
},
"required": [
"latest_tone",
"average_tone",
"label",
"trend",
"scale"
],
"type": "object"
},
"source": {
"const": "x402stock",
"type": "string"
},
"timespan": {
"type": "string"
},
"tone_timeline": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tone": {
"type": "number"
}
},
"required": [
"date",
"tone"
],
"type": "object"
},
"type": "array"
},
"venue": {
"const": "gdelt",
"type": "string"
},
"volume": {
"additionalProperties": false,
"properties": {
"points": {
"type": "number"
},
"total_articles": {
"type": "number"
}
},
"required": [
"total_articles",
"points"
],
"type": "object"
},
"volume_timeline": {
"items": {
"additionalProperties": false,
"properties": {
"articles": {
"type": "number"
},
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total_monitored": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"date",
"articles",
"total_monitored"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"source",
"venue",
"as_of",
"query",
"timespan",
"sentiment",
"volume",
"tone_timeline",
"volume_timeline",
"recent_articles",
"attribution"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://x402stock.xyz/api/v1/news-sentiment" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://x402stock.xyz/api/v1/news-sentiment");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://x402stock.xyz/api/v1/news-sentiment")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/5266.json, and this resource appears in /discovery/resources and /discovery/search.