News + sentiment /stories-with-sentiment
GET /stories-with-sentiment is an endpoint of the CityFALCON API API, listed on Proxygate by CityFALCON. Retrieve news (including sentiment) AI agents call it per request through a transparent proxy and pay $0.0750 per request in USDC on Solana, with no subscription and no API key to manage.
$0.0750 / request
GET
USDC on Solana
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| languages | string | No | Comma-separated language codes (e.g. en, de, fr). Leave blank to get content in all languages. |
| categories | string | No | Comma-separated category slugs: mp (major news publications), op (other news publications), r (research publications). |
| identifiers | string | No | Comma-separated list, interpreted per `identifier_type`, e.g. "AAPL_US, BTC_GLOBAL". |
| time_filter | string | No | Time window: m5 (5 min), m15 (15 min), h1 (1 hour), h8 (8 hours), d1 (1 day), w1 (1 week), mth1 (1 month). Queries cover the most recent 30 days only (see the API description for historical CSV access). |
| country_codes | string | No | Comma-separated country codes. |
| with_sentiment | boolean | No | Return the sentiment at the story level |
| identifier_type | string | No | How values in `identifiers` are interpreted. tickers e.g. AAPL; full_tickers e.g. AAPL_US, or BTC_GLOBAL for cryptocurrencies; assets e.g. Apple. Commodities also use the assets type (not slugs) — see https://www.cityfalcon.ai/help/articles/360006813837-Commodity-Identifiers |
| min_cityfalcon_score | number | No | Minimum CityFALCON relevance score, from 0 to 100. |
| registration_required | boolean | No | Include / exclude publishers that require user registration. |
| with_sentiments_by_entities | boolean | No | Return the sentiment score for each entity in the story (e.g., stock or location). |
Call /stories-with-sentiment with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy cityfalcon-api /stories-with-sentiment -X GET// Call it from an AI agent over the Proxygate MCP server
call_api({
listing_id: "d20596c3-7d41-47e9-9132-2ffacfea3792",
method: "GET",
path: "/stories-with-sentiment"
})CityFALCON API /stories-with-sentiment: frequently asked questions
Retrieve news (including sentiment)
It costs $0.0750 per request, settled in USDC on Solana. There is no subscription and no monthly minimum: an agent pays per call from a single prepaid balance.
The agent calls GET /stories-with-sentiment through the Proxygate gateway with the Proxygate CLI, SDK, or MCP server. Proxygate routes the request to the upstream provider, injects the provider key server-side, and returns the response with a signed receipt.
No. The upstream provider key never leaves the Proxygate gateway. Your agent authenticates once to Proxygate; the key is injected server-side per request and is never shared with or exposed to the agent.