/stories
GET /stories is an endpoint of the CityFALCON API API, listed on Proxygate by CityFALCON. Retrieve news with metadata (no sentiment) AI agents call it per request through a transparent proxy and pay $0.0500 per request in USDC on Solana, with no subscription and no API key to manage.
$0.0500 / 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. |
| 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. |
Call /stories with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy cityfalcon-api /stories -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"
})CityFALCON API /stories: frequently asked questions
Retrieve news with metadata (no sentiment)
It costs $0.0500 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 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.