News Signals API
GET/v1/newssignals/entities
Organisations, tickers, crypto assets, central banks, governments and topics we score, with ids, aliases and 30-day baselines. Filter by text or kind. Refreshes every 24 hours.
Price
$0.005/ callEdge cache
21600s
Uptime 24h
100.00%
p95
409ms
MCP tool
newssignals_entities
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 against a 30-day baseline, novelty and trending for various entities. The API offers filtering by text or kind and refreshes every 24 hours. The endpoint is available for GET requests and returns tracked entities with ids, aliases, and 30-day baselines. The API is priced at $0.005 per request.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| q | query | string | |
| kind | query | string | org, ticker, crypto, central_bank, government, topic |
| limit | query | integer = 100 |
Code
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/newssignals/entities"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/newssignals/entities" -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/entities")).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/entities").json())curl "https://api.realtimeapi.ai/v1/newssignals/entities" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
What is the API price?
$0.005 per request
What is the API refresh rate?
Every 24 hours
What entities are tracked by the API?
Organisations, tickers, crypto assets, central banks, governments and topics