News Signals API
GET/v1/newssignals/events
CAMEO-coded events from the 15-minute export, newest first: actor codes and names, event code, Goldstein scale (milli), mentions, tone (bps), country and source URL. Filter by actor code, country or since. Refreshes every 15 minutes.
Price
$0.01/ callEdge cache
300s
Uptime 24h
100.00%
p95
394ms
MCP tool
newssignals_events
The News signals and trends API provides signals derived from GDELT's 15-minute global news coding. It includes tone in basis points, mention volume, novelty, and trending for various entities. The API also offers trending people and topics ranked by attention spike. The endpoint provides CAMEO-coded events from the 15-minute export, newest first, with filter options by actor code, country, or since. The API refreshes every 15 minutes.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| actor | query | string | CAMEO actor code or name, e.g. USA, CHN, GOV |
| country | query | string | ActionGeo country code |
| since | query | string | |
| limit | query | integer = 50 |
Code
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/newssignals/events"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/newssignals/events" -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/newssignals/events")).json();
console.log(data);# 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/events").json())curl "https://api.realtimeapi.ai/v1/newssignals/events" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
What is the price of the API?
The price of the API is $0.010 per request.
What is the method of the endpoint?
The method of the endpoint is GET.
What parameters are available for filtering?
The available parameters for filtering are actor, country, since, and limit.