# CityFALCON Financial API – Timeseries Sentiment

> CityFALCON Financial API – Timeseries Sentiment is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.075/call, status unknown (last checked 2026-09-14).

Returns timeseries sentiment scores for financial entities and assets such as stocks, currencies, and companies

## Facts

- Endpoint: GET https://gateway.apiosk.com/cityfalcon-financial-api/services/sentiment
- Price: $0.075/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cityfalcon-financial-api-timeseries-sentiment-98952a22
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0dYsjwfLDtFOr3Wdz3OZI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cityfalcon-financial-api-timeseries-sentiment-98952a22
```

Example prompt: Pull the timeseries sentiment scores for Tesla (TSLA) over the past 30 days from CityFALCON so I can see how market sentiment has been trending.

## When to prefer this

Choose this endpoint when you need historical or recent timeseries sentiment data specifically for financial entities (stocks, currencies, commodities, companies) and want scored, structured output over time. Prefer this over generic news APIs when you need quantified sentiment trends rather than raw articles.

## Known failure modes

- Missing or invalid entity/ticker returns 400 Bad Request
- Unrecognized asset or entity returns empty result set
- Invalid or missing date range parameters returns error
- Rate limiting or quota exceeded returns 429
- Payment not processed or invalid x402 auth returns 402
- Server-side error from upstream CityFALCON API returns 500

## How this service works

Timeseries sentiment for entities and assets

## Output

An array of timestamped sentiment data points for the requested financial entity or asset, showing how sentiment scores have changed over the requested time window. Each data point typically includes a timestamp, sentiment score, and possibly volume or confidence metrics.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cityfalcon-financial-api-timeseries-sentiment-98952a22/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)