News Sentiment API
GET/v1/newssignals/sentiment/{entity}
Mentions in the window, the 30-day baseline expectation, volume ratio and novelty in basis points, mention-weighted tone, tone change against the baseline and the top GDELT themes. Refreshes every 15 minutes.
Price
$0.01/ callEdge cache
300s
Uptime 24h
100.00%
p95
378ms
MCP tool
newssignals_sentiment-entity
The News Sentiment API provides news sentiment and volume data for entities. It includes mentions, volume ratio, novelty, tone, and top GDELT themes. The API refreshes every 15 minutes. The endpoint is GET /sentiment/{entity} and requires entity and window parameters. The price is $0.010 per request.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| entity* | path | string | |
| window | query | string = 24h | 1h, 24h or 7d |
Code
curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/newssignals/sentiment/org_nvidia"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/newssignals/sentiment/org_nvidia" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"TypeScript · @x402/fetch
// 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/newssignals/sentiment/org_nvidia")).json();
console.log(data);Python · x402
# pip install "x402[requests,evm]==2.27.0" eth-account
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(Account.from_key(PRIVATE_KEY)))
session = x402_requests(client)
print(session.get("https://api.realtimeapi.ai/v1/newssignals/sentiment/org_nvidia").json())With an API key
curl "https://api.realtimeapi.ai/v1/newssignals/sentiment/org_nvidia" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
What is the API endpoint?
GET /sentiment/{entity}
What parameters are required?
entity and window
How often does the API refresh?
Every 15 minutes