Skip to content

News Score API

GET/v1/newssignals/tickers/{symbol}/news-score

The sentiment block for the entity behind a ticker (NVDA, JPM) or crypto asset symbol (BTC): mentions against baseline, volume ratio, novelty, tone and tone change, top themes. Refreshes every 15 minutes.

Price

$0.01/ call

Edge cache

300s

Uptime 24h

100.00%

p95

338ms

MCP tool

newssignals_tickers-symbol-news-score

The News Score API provides sentiment analysis for entities behind tickers and crypto assets. It returns mentions against baseline, volume ratio, novelty, tone, and tone change. The API refreshes every 15 minutes. Parameters include symbol and window. The API is priced at $0.010 per request.

Parameters

NameInTypeDescription
symbol* path string
window query string = 24h

Code

curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/newssignals/tickers/NVDA/news-score"

# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/newssignals/tickers/NVDA/news-score" -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/tickers/NVDA/news-score")).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/tickers/NVDA/news-score").json())
With an API key
curl "https://api.realtimeapi.ai/v1/newssignals/tickers/NVDA/news-score" -H "X-API-Key: $RTAPI_KEY"

Frequently asked questions

What is the News Score API?

The News Score API provides sentiment analysis for entities behind tickers and crypto assets.

What parameters are required?

The API requires symbol and window parameters.

How often is the API updated?

The API refreshes every 15 minutes.

What is the price of the API?

The API is priced at $0.010 per request.

What data is returned by the API?

The API returns mentions against baseline, volume ratio, novelty, tone, and tone change.

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.