CityFALCON Financial API
Retrieve news and content text, metadata, and analytics
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xA039E3dEb5ca71E41905f90491FC5d016CE23B79",
"scheme": "exact",
"network": "base",
"mimeType": "application/json",
"resource": "https://gateway.apiosk.com/cityfalcon-financial-api/stories",
"description": "API call to cityfalcon-financial-api",
"outputSchema": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"type": "object",
"title": "Retrieve news and content text, metadata, and analytics",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"events": {
"type": "string",
"description": "Comma-separated event slugs. These are defined events such as \"stock buyback\" or \"analyst sell rating\". Browse available slugs: https://www.cityfalcon.ai/help/articles/36799477030301"
},
"languages": {
"type": "string",
"example": "en",
"description": "Comma-separated language codes (e.g. en, de, fr). Leave blank to get content in all languages."
},
"categories": {
"type": "string",
"example": "mp,op",
"description": "Comma-separated category slugs: mp (major news publications), op (other news publications), r (research publications)."
},
"identifiers": {
"type": "string",
"example": "AAPL_US,BTC_GLOBAL",
"description": "Comma-separated list, interpreted per `identifier_type`, e.g. \"AAPL_US, BTC_GLOBAL\"."
},
"time_filter": {
"enum": [
"m5",
"m15",
"h1",
"h8",
"d1",
"w1",
"mth1"
],
"type": "string",
"default": "d1",
"description": "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."
},
"dcsc_sectors": {
"type": "string",
"description": "Comma-separated DCSC sector slugs. Do not use with the asset, ticker, or full_ticker identifiers."
},
"country_codes": {
"type": "string",
"example": "US,GB",
"description": "Comma-separated country codes. Not attached to a company's listing country but to the news."
},
"topic_classes": {
"type": "string",
"description": "Comma-separated topic-class slugs (aggregate feeds such as \"all stocks\"). Browse topic-class and asset-class slugs at https://www.cityfalcon.ai/help/articles/360006745118."
},
"with_sentiment": {
"type": "boolean",
"description": "Return the sentiment score for each story."
},
"identifier_type": {
"enum": [
"tickers",
"full_tickers",
"assets"
],
"type": "string",
"default": "full_tickers",
"description": "Full tickers are built as [ticker]_[trading_country], e.g. AAPL_US, 005930_KR. For disambiguation of companies (e.g., AA_US and AA_GB for American Airlines and British American Tobacco). Cryptocurrencies use GLOBAL, e.g. BTC_GLOBAL. Commodities use the assets type — see https://www.cityfalcon.ai/help/articles/360006813837-Commodity-Identifiers. Macro topics (like inflation) also use the assets type and can be browsed at https://www.cityfalcon.ai/help/articles/36800176706333."
},
"dcsc_sector_level": {
"type": "string",
"description": "Select a DCSC sector level to refine the search."
},
"min_cityfalcon_score": {
"type": "number",
"format": "float",
"default": 0,
"example": 50,
"maximum": 100,
"minimum": 0,
"description": "Minimum CityFALCON relevance score, from 0 to 100."
},
"registration_required": {
"type": "boolean",
"description": "Include / exclude publishers that require user registration."
},
"with_sentiments_by_entities": {
"type": "boolean",
"description": "Return the sentiment score for each NLU entity (e.g. company) in each story."
}
},
"description": "Query parameters for GET https://api.cityfalcon.com/v0.2/stories. Auth: access_token."
},
"discoverable": true
}
},
"maxAmountRequired": "34500",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://gateway.apiosk.com/cityfalcon-financial-api/stories",
"tags": [
"finance",
"cityfalcon",
"financial",
"api"
],
"mimeType": "application/json",
"description": "Retrieve news and content text, metadata, and analytics",
"serviceName": "CityFALCON Financial API"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"type": "object",
"title": "Retrieve news and content text, metadata, and analytics",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"events": {
"type": "string",
"description": "Comma-separated event slugs. These are defined events such as \"stock buyback\" or \"analyst sell rating\". Browse available slugs: https://www.cityfalcon.ai/help/articles/36799477030301"
},
"languages": {
"type": "string",
"example": "en",
"description": "Comma-separated language codes (e.g. en, de, fr). Leave blank to get content in all languages."
},
"categories": {
"type": "string",
"example": "mp,op",
"description": "Comma-separated category slugs: mp (major news publications), op (other news publications), r (research publications)."
},
"identifiers": {
"type": "string",
"example": "AAPL_US,BTC_GLOBAL",
"description": "Comma-separated list, interpreted per `identifier_type`, e.g. \"AAPL_US, BTC_GLOBAL\"."
},
"time_filter": {
"enum": [
"m5",
"m15",
"h1",
"h8",
"d1",
"w1",
"mth1"
],
"type": "string",
"default": "d1",
"description": "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."
},
"dcsc_sectors": {
"type": "string",
"description": "Comma-separated DCSC sector slugs. Do not use with the asset, ticker, or full_ticker identifiers."
},
"country_codes": {
"type": "string",
"example": "US,GB",
"description": "Comma-separated country codes. Not attached to a company's listing country but to the news."
},
"topic_classes": {
"type": "string",
"description": "Comma-separated topic-class slugs (aggregate feeds such as \"all stocks\"). Browse topic-class and asset-class slugs at https://www.cityfalcon.ai/help/articles/360006745118."
},
"with_sentiment": {
"type": "boolean",
"description": "Return the sentiment score for each story."
},
"identifier_type": {
"enum": [
"tickers",
"full_tickers",
"assets"
],
"type": "string",
"default": "full_tickers",
"description": "Full tickers are built as [ticker]_[trading_country], e.g. AAPL_US, 005930_KR. For disambiguation of companies (e.g., AA_US and AA_GB for American Airlines and British American Tobacco). Cryptocurrencies use GLOBAL, e.g. BTC_GLOBAL. Commodities use the assets type — see https://www.cityfalcon.ai/help/articles/360006813837-Commodity-Identifiers. Macro topics (like inflation) also use the assets type and can be browsed at https://www.cityfalcon.ai/help/articles/36800176706333."
},
"dcsc_sector_level": {
"type": "string",
"description": "Select a DCSC sector level to refine the search."
},
"min_cityfalcon_score": {
"type": "number",
"format": "float",
"default": 0,
"example": 50,
"maximum": 100,
"minimum": 0,
"description": "Minimum CityFALCON relevance score, from 0 to 100."
},
"registration_required": {
"type": "boolean",
"description": "Include / exclude publishers that require user registration."
},
"with_sentiments_by_entities": {
"type": "boolean",
"description": "Return the sentiment score for each NLU entity (e.g. company) in each story."
}
},
"description": "Query parameters for GET https://api.cityfalcon.com/v0.2/stories. Auth: access_token."
}
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object"
},
"output": {
"type": "object"
}
}
}
}
},
"description": "Retrieve news and content text, metadata, and analytics",
"x402Version": 1
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
Pay 0.03 USDC on Base to 0xA039…23B79. The signed payment is good for 5 minutes.
- Paid to
- 0xA039…23B79
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 30000 smallest units
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xA039E3dEb5ca71E41905f90491FC5d016CE23B79",
"amount": "30000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"type": "object",
"title": "Retrieve news and content text, metadata, and analytics",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"events": {
"type": "string",
"description": "Comma-separated event slugs. These are defined events such as \"stock buyback\" or \"analyst sell rating\". Browse available slugs: https://www.cityfalcon.ai/help/articles/36799477030301"
},
"languages": {
"type": "string",
"example": "en",
"description": "Comma-separated language codes (e.g. en, de, fr). Leave blank to get content in all languages."
},
"categories": {
"type": "string",
"example": "mp,op",
"description": "Comma-separated category slugs: mp (major news publications), op (other news publications), r (research publications)."
},
"identifiers": {
"type": "string",
"example": "AAPL_US,BTC_GLOBAL",
"description": "Comma-separated list, interpreted per `identifier_type`, e.g. \"AAPL_US, BTC_GLOBAL\"."
},
"time_filter": {
"enum": [
"m5",
"m15",
"h1",
"h8",
"d1",
"w1",
"mth1"
],
"type": "string",
"default": "d1",
"description": "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."
},
"dcsc_sectors": {
"type": "string",
"description": "Comma-separated DCSC sector slugs. Do not use with the asset, ticker, or full_ticker identifiers."
},
"country_codes": {
"type": "string",
"example": "US,GB",
"description": "Comma-separated country codes. Not attached to a company's listing country but to the news."
},
"topic_classes": {
"type": "string",
"description": "Comma-separated topic-class slugs (aggregate feeds such as \"all stocks\"). Browse topic-class and asset-class slugs at https://www.cityfalcon.ai/help/articles/360006745118."
},
"with_sentiment": {
"type": "boolean",
"description": "Return the sentiment score for each story."
},
"identifier_type": {
"enum": [
"tickers",
"full_tickers",
"assets"
],
"type": "string",
"default": "full_tickers",
"description": "Full tickers are built as [ticker]_[trading_country], e.g. AAPL_US, 005930_KR. For disambiguation of companies (e.g., AA_US and AA_GB for American Airlines and British American Tobacco). Cryptocurrencies use GLOBAL, e.g. BTC_GLOBAL. Commodities use the assets type — see https://www.cityfalcon.ai/help/articles/360006813837-Commodity-Identifiers. Macro topics (like inflation) also use the assets type and can be browsed at https://www.cityfalcon.ai/help/articles/36800176706333."
},
"dcsc_sector_level": {
"type": "string",
"description": "Select a DCSC sector level to refine the search."
},
"min_cityfalcon_score": {
"type": "number",
"format": "float",
"default": 0,
"example": 50,
"maximum": 100,
"minimum": 0,
"description": "Minimum CityFALCON relevance score, from 0 to 100."
},
"registration_required": {
"type": "boolean",
"description": "Include / exclude publishers that require user registration."
},
"with_sentiments_by_entities": {
"type": "boolean",
"description": "Return the sentiment score for each NLU entity (e.g. company) in each story."
}
},
"description": "Query parameters for GET https://api.cityfalcon.com/v0.2/stories. Auth: access_token."
}
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object"
},
"output": {
"type": "object"
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-07-22 08:01Z
- Last indexed by Roundhouse
- 2026-08-08 05:20Z
- Last enriched (probe, favicon, geo)
- 2026-09-25 06:15Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 403
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
Nothing indexed for this service or its provider yet. Not a claim that it is unused — only that we hold no record. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service CityFALCON Financial API and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=CityFALCON%20Financial%20API' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://gateway.apiosk.com/cityfalcon-financial-api/stories, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402, or use an organization key from https://roundhouseai.io/dashboard/team. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.