{"openapi":"3.1.0","info":{"title":"News signals and trends (RealtimeAPI)","version":"c2e89ff8","description":"News signals and trends served through the RealtimeAPI gateway. Pay per request in USDC with x402 (no account), or send an `X-API-Key` / `Authorization: Bearer rta_live_...` key. Each operation's `x-price` is the per-request price.","x-feed-slug":"newssignals"},"servers":[{"url":"https://api.realtimeapi.ai/v1/newssignals"}],"security":[{},{"ApiKeyHeader":[]},{"BearerKey":[]}],"paths":{"/entities":{"get":{"operationId":"entities","summary":"Tracked entities","description":"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.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"kind","in":"query","required":false,"schema":{"type":["string","null"]},"description":"org, ticker, crypto, central_bank, government, topic"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}],"x-price":{"price":"$0.005","price_micro":5000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_entities","x-cache-ttl-s":21600,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"ticker":{},"asset":{},"aliases":{"type":"array","items":{"type":"string"}},"baseline_daily_mentions_milli":{"type":"integer"},"baseline_tone_bps":{},"baseline_days":{"type":"integer"}},"required":["id","kind","name","ticker","asset","aliases","baseline_daily_mentions_milli","baseline_tone_bps","baseline_days"]}},"kinds":{"type":"array","items":{"type":"string"}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["count","entities","kinds","as_of","next_update","status","data_age_s","source"]},"example":{"count":100,"entities":[{"id":"cb_bank_for_international_settlements","kind":"central_bank","name":"Bank for International Settlements","ticker":null,"asset":null,"aliases":["bank for international settlements","bis"],"baseline_daily_mentions_milli":0,"baseline_tone_bps":null,"baseline_days":0},{"id":"cb_bank_of_canada","kind":"central_bank","name":"Bank of Canada","ticker":null,"asset":null,"aliases":["bank of canada","boc"],"baseline_daily_mentions_milli":0,"baseline_tone_bps":null,"baseline_days":0}],"kinds":["central_bank","crypto"],"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-12T01:45:00Z","status":"fresh","data_age_s":4280,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:30:00Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/entities/trending":{"get":{"operationId":"entities-trending","summary":"Entities with unusual news volume","description":"Entities ranked by novelty (volume over their 30-day baseline) in the window, with mentions and tone. Filter by kind. Refreshes every 15 minutes.","parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100}}],"x-price":{"price":"$0.015","price_micro":15000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_entities-trending","x-cache-ttl-s":300,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"string"},"kind":{},"count":{"type":"integer"},"entities":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"ticker":{},"asset":{},"mentions":{"type":"integer"},"tone_bps":{"type":"integer"},"volume_ratio_bps":{},"novelty_bps":{}},"required":["entity_id","kind","name","ticker","asset","mentions","tone_bps","volume_ratio_bps","novelty_bps"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["window","kind","count","entities","as_of","next_update","status","data_age_s","source"]},"example":{"window":"24h","kind":null,"count":20,"entities":[{"entity_id":"topic_elections","kind":"topic","name":"Elections","ticker":null,"asset":null,"mentions":2861,"tone_bps":-138,"volume_ratio_bps":null,"novelty_bps":null},{"entity_id":"topic_public_health","kind":"topic","name":"Public health","ticker":null,"asset":null,"mentions":1372,"tone_bps":-107,"volume_ratio_bps":null,"novelty_bps":null}],"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-11T02:00:00Z","status":"stale","data_age_s":4280,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:45:00Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/events":{"get":{"operationId":"events","summary":"GDELT events","description":"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.","parameters":[{"name":"actor","in":"query","required":false,"schema":{"type":["string","null"]},"description":"CAMEO actor code or name, e.g. USA, CHN, GOV"},{"name":"country","in":"query","required":false,"schema":{"type":["string","null"]},"description":"ActionGeo country code"},{"name":"since","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"minimum":1,"maximum":500}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_events","x-cache-ttl-s":300,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"event_time":{"type":"string","format":"date-time"},"event_day":{"type":"string","format":"date"},"actor1":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"}},"required":["code","name"]},"actor2":{"type":"object","properties":{"code":{"type":["string","null"]},"name":{"type":["string","null"]}},"required":["code","name"]},"event_code":{"type":"string"},"goldstein_milli":{"type":"integer"},"mentions":{"type":"integer"},"tone_bps":{"type":"integer"},"country":{"type":["string","null"]},"url":{"type":"string"}},"required":["id","event_time","event_day","actor1","actor2","event_code","goldstein_milli","mentions","tone_bps","country","url"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["count","events","as_of","next_update","status","data_age_s","source"]},"example":{"count":50,"events":[{"id":1332505106,"event_time":"2026-11-11T01:30:00Z","event_day":"2026-11-11","actor1":{"code":"CVL","name":"COMMUNITY"},"actor2":{"code":null,"name":null},"event_code":"100","goldstein_milli":-5000,"mentions":50,"tone_bps":219,"country":null,"url":"https://www.legallyindia.com/convos/topic/485625-law-firm-to-intern-with-for-a-t…"},{"id":1332505292,"event_time":"2026-11-11T01:30:00Z","event_day":"2026-11-11","actor1":{"code":"GOV","name":"MAYOR"},"actor2":{"code":null,"name":null},"event_code":"129","goldstein_milli":-5000,"mentions":30,"tone_bps":-411,"country":null,"url":"https://www.wowt.com/2026/11/11/bellevue-city-council-overrides-mayors-veto-agen…"}],"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-11T02:00:00Z","status":"stale","data_age_s":4280,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:45:00Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/sentiment/{entity}":{"get":{"operationId":"sentiment-entity","summary":"News sentiment and volume for an entity","description":"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.","parameters":[{"name":"entity","in":"path","required":true,"schema":{"type":"string"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h"},"description":"1h, 24h or 7d"}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_sentiment-entity","x-cache-ttl-s":300,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"entity_id":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"ticker":{"type":"string"},"asset":{},"window":{"type":"string"},"mentions":{"type":"integer"},"baseline_mentions":{},"volume_ratio_bps":{},"novelty_bps":{},"tone_bps":{"type":"integer"},"baseline_tone_bps":{},"tone_change_bps":{},"top_themes":{"type":"array","items":{"type":"string"}},"windows_covered":{"type":"integer"},"baseline_days":{"type":"integer"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["entity_id","kind","name","ticker","asset","window","mentions","baseline_mentions","volume_ratio_bps","novelty_bps","tone_bps","baseline_tone_bps","tone_change_bps","top_themes","windows_covered","baseline_days","as_of","next_update","status","data_age_s","source"]},"example":{"entity_id":"org_nvidia","kind":"ticker","name":"Nvidia","ticker":"NVDA","asset":null,"window":"24h","mentions":103,"baseline_mentions":null,"volume_ratio_bps":null,"novelty_bps":null,"tone_bps":-112,"baseline_tone_bps":null,"tone_change_bps":null,"top_themes":["EPU_ECONOMY_HISTORIC","WB_696_PUBLIC_SECTOR_MANAGEMENT"],"windows_covered":8,"baseline_days":0,"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-11T02:00:00Z","status":"stale","data_age_s":4280,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:45:00Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/sentiment/{entity}/history":{"get":{"operationId":"sentiment-entity-history","summary":"Sentiment history (Pro)","description":"Mentions and tone per 15-minute window (last 90 days) or per day, newest first. Point in time by construction: a window holds only records GDELT published in it. Refreshes every 15 minutes.","parameters":[{"name":"entity","in":"path","required":true,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string","default":"1d"},"description":"15m or 1d"},{"name":"from","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"minimum":1,"maximum":5000}}],"x-price":{"price":"$0.020","price_micro":20000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_sentiment-entity-history","x-cache-ttl-s":1800,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"entity_id":{"type":"string"},"name":{"type":"string"},"interval":{"type":"string"},"count":{"type":"integer"},"points":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","format":"date"},"mentions":{"type":"integer"},"tone_bps":{"type":"integer"}},"required":["period","mentions","tone_bps"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["entity_id","name","interval","count","points","as_of","next_update","status","data_age_s","source"]},"example":{"entity_id":"org_nvidia","name":"Nvidia","interval":"1d","count":2,"points":[{"period":"2026-11-11","mentions":46,"tone_bps":-97},{"period":"2026-11-10","mentions":57,"tone_bps":-124}],"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-11T02:00:00Z","status":"stale","data_age_s":4280,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:45:00Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/tickers/{symbol}/news-score":{"get":{"operationId":"tickers-symbol-news-score","summary":"News score for a ticker or crypto symbol","description":"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.","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h"}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_tickers-symbol-news-score","x-cache-ttl-s":300,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"entity_id":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"ticker":{"type":"string"},"asset":{},"window":{"type":"string"},"mentions":{"type":"integer"},"baseline_mentions":{},"volume_ratio_bps":{},"novelty_bps":{},"tone_bps":{"type":"integer"},"baseline_tone_bps":{},"tone_change_bps":{},"top_themes":{"type":"array","items":{"type":"string"}},"windows_covered":{"type":"integer"},"baseline_days":{"type":"integer"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}},"symbol":{"type":"string"}},"required":["entity_id","kind","name","ticker","asset","window","mentions","baseline_mentions","volume_ratio_bps","novelty_bps","tone_bps","baseline_tone_bps","tone_change_bps","top_themes","windows_covered","baseline_days","as_of","next_update","status","data_age_s","source","symbol"]},"example":{"entity_id":"org_nvidia","kind":"ticker","name":"Nvidia","ticker":"NVDA","asset":null,"window":"24h","mentions":103,"baseline_mentions":null,"volume_ratio_bps":null,"novelty_bps":null,"tone_bps":-112,"baseline_tone_bps":null,"tone_change_bps":null,"top_themes":["EPU_ECONOMY_HISTORIC","WB_696_PUBLIC_SECTOR_MANAGEMENT"],"windows_covered":8,"baseline_days":0,"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-11T02:00:00Z","status":"stale","data_age_s":4281,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:45:00Z"}],"symbol":"NVDA"}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/top-stories":{"get":{"operationId":"top-stories","summary":"Most-covered stories","description":"Up to 50 stories ranked by how many GDELT records cited the URL in the window: title, link, publisher domain, tone and the tracked entities named. Titles and links only, never article text. Refreshes every 15 minutes.","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"6h"},"description":"1h, 6h or 24h"},{"name":"entity","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"minimum":1,"maximum":50}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_top-stories","x-cache-ttl-s":300,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"string"},"entity":{},"count":{"type":"integer"},"stories":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"publisher":{"type":"string"},"mentions":{"type":"integer"},"tone_bps":{"type":"integer"},"first_seen_at":{"type":"string","format":"date-time"},"last_seen_at":{"type":"string","format":"date-time"},"entities":{"type":"array","items":{"type":"string"}}},"required":["title","url","publisher","mentions","tone_bps","first_seen_at","last_seen_at","entities"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["window","entity","count","stories","as_of","next_update","status","data_age_s","source"]},"example":{"window":"6h","entity":null,"count":50,"stories":[{"title":"Globe At Home makes holiday connections …","url":"https://www.philstar.com/lifestyle/busin…","publisher":"philstar.com","mentions":1,"tone_bps":662,"first_seen_at":"2026-11-11T01:30:00Z","last_seen_at":"2026-11-11T01:30:00Z","entities":["topic_elections"]}],"as_of":"2026-11-11T01:45:00Z","next_update":"2026-11-11T02:00:00Z","status":"stale","data_age_s":4281,"source":[{"publisher":"The GDELT Project","licence":"open, citation required","url":"https://www.gdeltproject.org/","retrieved_at":"2026-11-11T01:45:00Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/trending/people":{"get":{"operationId":"trending-people","summary":"Trending public figures","description":"People with the biggest attention spike against their 30-day baseline: Wikipedia daily pageviews blended with news coverage, classified through Wikidata occupations into celebrity, politics, sport, business or other. Only people with a Wikipedia article and a Wikidata id are ever listed. Refreshes every 60 minutes.","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":["string","null"]},"description":"celebrity, politics, sport, business, other"},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100}}],"x-price":{"price":"$0.015","price_micro":15000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_trending-people","x-cache-ttl-s":1800,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"string"},"category":{},"views_day":{"type":"string","format":"date"},"count":{"type":"integer"},"people":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"label":{"type":"string"},"wikidata_id":{"type":"string"},"wikipedia":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"occupations":{"type":"array","items":{"type":"string"}},"views":{"type":"integer"},"baseline_views":{"type":"integer"},"news_mentions":{"type":"integer"},"tone_bps":{},"spike_bps":{"type":"integer"}},"required":["rank","label","wikidata_id","wikipedia","description","category","occupations","views","baseline_views","news_mentions","tone_bps","spike_bps"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["window","category","views_day","count","people","as_of","next_update","status","data_age_s","source"]},"example":{"window":"24h","category":null,"views_day":"2026-11-09","count":20,"people":[{"rank":1,"label":"Alice Shih-hou Huang","wikidata_id":"Q4726076","wikipedia":"https://en.wikipedia.org/wiki/Alice_S._H…","description":"American biologist","category":"other","occupations":["biologist"],"views":75261,"baseline_views":821,"news_mentions":0,"tone_bps":null,"spike_bps":916699}],"as_of":"2026-11-11T02:55:57Z","next_update":"2026-11-11T03:55:57Z","status":"fresh","data_age_s":23,"source":[{"publisher":"Wikimedia Foundation (Pageviews API)","licence":"open data (CC0 for pageview statistics)","url":"https://wikimedia.org/api/rest_v1/","retrieved_at":"2026-11-11T02:55:57Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/trending/topics":{"get":{"operationId":"trending-topics","summary":"Trending topics by region","description":"Top daily searches (approximate traffic and three headlines each, titles and links only) and trending Mastodon tags and shared links, ranked by attention. Regions US, AU, GB. Refreshes every 60 minutes.","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"US"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100}}],"x-price":{"price":"$0.015","price_micro":15000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"newssignals_trending-topics","x-cache-ttl-s":1800,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"window":{"type":"string"},"count":{"type":"integer"},"topics":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"topic":{"type":"string"},"kind":{"type":"string"},"score":{"type":"integer"},"traffic":{"type":"string"},"url":{},"headlines":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"}},"required":["title","url","source"]}},"sources":{"type":"array"}},"required":["rank","topic","kind","score","traffic","url","headlines","sources"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","window","count","topics","as_of","next_update","status","data_age_s","source"]},"example":{"region":"US","window":"24h","count":20,"topics":[{"rank":1,"topic":"derik queen","kind":"search","score":2000,"traffic":"2000+","url":null,"headlines":[{"title":"Yaxel Lendeborg Breaks Silence on Derik …","url":"https://heavy.com/sports/nba/golden-stat…","source":"Heavy.com"}],"sources":[]}],"as_of":"2026-11-11T02:55:57Z","next_update":"2026-11-11T03:55:57Z","status":"fresh","data_age_s":23,"source":[{"publisher":"Google Trends (daily trends RSS)","licence":"public feed, terms unstated (confirm)","url":"https://trends.google.com/trending/rss?g…","retrieved_at":"2026-11-11T02:55:57Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerKey":{"type":"http","scheme":"bearer","description":"`rta_live_...` platform key"}},"headers":{"PaymentRequired":{"description":"Base64-encoded JSON x402 payment requirements (same as the body).","schema":{"type":"string"}},"PaymentResponse":{"description":"Base64-encoded JSON x402 settlement receipt (paid requests only).","schema":{"type":"string"}},"Price":{"description":"Per-request price of this endpoint, e.g. `$0.010` (charged only on a paid 2xx; covered by the key in API-key mode).","schema":{"type":"string"}},"Cache":{"description":"`HIT` or `MISS`.","schema":{"type":"string","enum":["HIT","MISS"]}},"CacheLayer":{"description":"On a hit: `edge` (this data centre's cache), `global` (the quality probe's copy) or `region` (the copy kept fresh in your region; `X-RTAPI-Data-Age` says how old).","schema":{"type":"string","enum":["edge","global","region"]}},"CacheTtl":{"description":"The endpoint's cache TTL in seconds (cacheable endpoints only).","schema":{"type":"integer"}},"DataAge":{"description":"Seconds since the gateway took its copy from the provider (0 when the answer is live). The data's own timestamp, if any, is in the body.","schema":{"type":"integer"}},"CachedAt":{"description":"Unix milliseconds the gateway's copy was taken from the provider (hits only).","schema":{"type":"integer"}},"Remaining":{"description":"API-key mode: calls left in the key's current period (also `X-RateLimit-Remaining`).","schema":{"type":"integer"}},"RateLimitLimit":{"description":"API-key mode: the key's calls per period.","schema":{"type":"integer"}},"RateLimitReset":{"description":"API-key mode: unix seconds the period resets.","schema":{"type":"integer"}},"QuotaSource":{"description":"API-key mode: `do` when the quota figures are the counter's exact answer, `memo` when a cached answer was served ahead of the count (figures then approximate by a few calls; a 429 is always exact).","schema":{"type":"string","enum":["do","memo"]}},"ServerTiming":{"description":"One entry per phase the request ran (`kv`, `auth`, `quota`, `cache`, `upstream`, `settle`) and `total`, the gateway's time to first byte; `desc` names the source (`cache;dur=3;desc=\"edge\"`).","schema":{"type":"string"}},"GatewayMs":{"description":"The gateway's own time to first byte: `total` minus `upstream` and `settle`.","schema":{"type":"integer"}}},"responses":{"PaymentRequired":{"description":"Payment required. Retry with an x402 `PAYMENT-SIGNATURE` (or `X-PAYMENT`) header for one of `accepts`, or with an API key.","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"Error":{"description":"Error envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"PaymentRequirements":{"type":"object","required":["scheme","network","payTo","asset"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","examples":["eip155:8453"]},"payTo":{"type":"string"},"price":{"type":"string","examples":["$0.010"]},"asset":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"PaymentRequired":{"type":"object","required":["x402Version","accepts","error"],"properties":{"x402Version":{"type":"integer","const":2},"accepts":{"type":"array","items":{"$ref":"#/components/schemas/PaymentRequirements"}},"error":{"type":"string"},"alternatives":{"type":"object","properties":{"api_key_purchase":{"type":"string","format":"uri"},"docs":{"type":"string","format":"uri"}}}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}},"x-x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"externalDocs":{"url":"https://realtimeapi.ai/feeds/newssignals"}}