Skip to content

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/ call

Edge 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

NameInTypeDescription
q query string
kind query string org, ticker, crypto, central_bank, government, topic
limit query integer = 100

Code

curl
# 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"
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/entities")).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/entities").json())
With an API key
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

Get a free key

1,000 calls a month across every feed. Who is setting it up?

No key needed at all: agents can pay per call in USDC with x402.