Polsia APItradevertex-ai.polsia.app ↗
Retrieve AI-generated trading signals for US equities, ADRs, and crypto via the TradeVertex AI API. Access direction, confidence scores, win rate, and narratives.
What is the Polsia API?
The TradeVertex AI API exposes one endpoint — list_tickers — that returns signal data across US equities, international ADRs, and crypto assets. Each response includes up to a full ticker universe with 8 structured fields per symbol: direction, confidence, scores, last close price, historical win rate, an AI-generated narrative, asset class, and a feed health flag. The endpoint requires no input parameters and returns everything in a single call.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/86df839c-a7f3-4e35-9337-6181b5a9e913/list_tickers' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tradevertex-ai-polsia-app-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: TradeVertex AI — fetch ticker signals and inspect the feed."""
from parse_apis.tradevertex_ai_polsia_app_api import TradeVertex, ParseError
client = TradeVertex()
# Check overall feed health via the signal set wrapper.
try:
signal_set = client.signal_sets.get()
except ParseError as e:
print(f"Upstream issue: {e.code}")
raise
print(f"Feed generated at {signal_set.generated_at}, source={signal_set.source}, degraded={signal_set.degraded}")
print(f"Total tickers available: {signal_set.total}")
# Iterate individual tickers with a cap.
for ticker in client.tickers.list(limit=5):
print(
f"{ticker.symbol} ({ticker.asset_class}) {ticker.direction} "
f"confidence={ticker.confidence} RR={ticker.rr_ratio} "
f"last_close={ticker.last_close}"
)
print(f" {ticker.narrative_headline}")
print("exercised: signal_sets.get / tickers.list")
Returns all available tickers on the platform with their latest signal data including direction, confidence, scores, last close price, historical win rate, and AI-generated narrative. The platform currently covers US equities, international ADRs, and crypto. A single request returns the complete set (currently 10 tickers); there is no pagination.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of tickers returned",
"source": "string indicating the data source (e.g. recompute)",
"tickers": "array of ticker objects, each containing symbol, asset_class, direction, confidence, scores, last_close, historical_win_rate, generated_at, provider_ticker, market_data_source, market_data_freshness, narrative fields, and tier",
"degraded": "boolean indicating whether the feed is in degraded/fallback mode",
"generated_at": "ISO 8601 timestamp when the signal set was generated"
},
"sample": {
"data": {
"total": 10,
"source": "recompute",
"tickers": [
{
"tier": "basic",
"symbol": "MELI",
"rr_ratio": 1.2,
"direction": "SHORT",
"confidence": 1,
"last_close": 199.78,
"asset_class": "adr",
"range_score": 1.5,
"generated_at": "2026-09-01T02:23:52.203Z",
"session_score": 0.6,
"provider_ticker": "MELI",
"narrative_accent": "Bearish",
"narrative_action": "monitor",
"volatility_score": 0.61,
"market_data_source": "seed-fallback",
"narrative_headline": "Smart money leaning strongly bearish — wide range but quiet volatility.",
"historical_win_rate": 0.45,
"narrative_sentiment": "positive",
"market_data_freshness": "historical"
}
],
"degraded": true,
"generated_at": "2026-09-01T02:23:52.203Z"
},
"status": "success"
}
}About the Polsia API
What the API Returns
The list_tickers endpoint returns a flat array of ticker objects along with top-level metadata. Each ticker object carries the symbol, asset class (US equity, international ADR, or crypto), a directional signal (e.g. bullish or bearish), a confidence value, a composite score breakdown, the last close price, and a historical win rate for that signal type. An AI-generated narrative field provides a plain-text summary of why the signal was generated.
Feed Metadata
Beyond the ticker array, the response includes a total integer confirming the count of symbols returned, a source string identifying which compute run produced the data (e.g. recompute), a generated_at ISO 8601 timestamp marking when the signal set was produced, and a degraded boolean. When degraded is true, the feed is operating in fallback mode and signal freshness or completeness may be reduced — callers should check this flag before treating results as current.
Coverage and Scope
The platform currently covers three asset classes: US equities, international ADRs, and cryptocurrencies. All are returned in the same response structure with no filtering required on the caller's side. Because the endpoint takes no inputs, asset class filtering and symbol selection must be handled client-side after receiving the full payload.
Freshness and Signal Generation
The generated_at timestamp in the response indicates when the current signal batch was computed. Comparing this field across polls is the recommended way to detect whether new signals have been issued since the last call.
The Polsia API is a managed, monitored endpoint for tradevertex-ai.polsia.app — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tradevertex-ai.polsia.app changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tradevertex-ai.polsia.app API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen the full ticker universe for high-confidence directional signals before market open.
- Track historical win rate per symbol to weight positions in a quant backtest.
- Display AI-generated narratives in a retail trade dashboard alongside price data.
- Monitor the
degradedflag to trigger alerts when the signal feed is in fallback mode. - Filter the returned array by asset class to build separate watchlists for equities, ADRs, and crypto.
- Log
generated_attimestamps to measure signal refresh cadence over time. - Cross-reference last close prices from the payload with a brokerage feed to detect divergence.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TradeVertex AI have an official developer API?+
What does the `list_tickers` endpoint return for each symbol?+
Can I request signals for a single symbol or filter by asset class server-side?+
Does the API expose options data, earnings dates, or fundamental metrics?+
How do I know whether the signal data is fresh?+
generated_at ISO 8601 timestamp in the response. If the degraded field is true, the feed is in fallback mode and the signal set may not reflect the latest compute run.