GET
/api/v1/signals/featured
The featured trade signal
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| window | query | integer | Latest-forecast update lookback in hours for the auto pick. Default: 24 |
Response fields
| Field | Type | Meaning |
|---|---|---|
| signal | TradeSignalItem | A Quotient trade signal with separate publication, forecast-freshness, and active-lifecycle context. Entry values are frozen at publish; status, conviction, convergence, and capacity are derived live. All *_cents values are Q-side cents: the cost/value of the share on the signal's side. |
| featured_by | "pin" | "auto" | |
| message | string | Present when signal is null |
Billing and limits
Calls are billed to prepaid credits, or per call over x402. The price above is the reference price; the 402 challenge returned at request time is what a call actually costs.
One request may be in flight at a time, and request starts must be at least one second apart. A rejected 429 is not billed. See rate limits.
curl
curl -H "x-quotient-api-key: qt_…" \
"https://quotient-api-gateway.onrender.com/api/v1/signals/featured"Run sends this request with preset parameters on Quotient’s demo key. Your credits are not spent.
200 · application/json
{
"signal": {
"id": "…",
"created_at": "…",
"published_at": "…",
"forecast_updated_at": "…",
"is_new_today": false,
"is_fresh": false,
"is_active": false,
"side": "YES",
"entry_q": 0,
"entry_pm": 0,
"entry_spread_pp": 0,
"window_days": 0,
"resolves_in_window": false,
"status": "actionable",
"retired_reason": "resolved",
"conviction_tier": 0,
"conviction": "high",
"has_band": false,
"latest_q": 0,
"q_side": "YES",
"q_value_cents": 0,
"entry_cost_cents": 0,
"current_cost_cents": 0,
"distance_to_convergence_cents": 0,
"converge_upside_pct": 0,
"live_priced": false,
"priced_at": "…",
"capacity_usd_at_2c": 0,
"capacity_available": false,
"capacity_basis": "depth-2c",
"capacity_as_of": "…",
"drawdown_risk_elevated": false,
"crash_risk_elevated": false,
"market": {
"venue": "polymarket",
"nativeMarketId": "…",
"nativeEventId": "…",
"seriesTicker": "…",
"marketKey": "…",
"slug": "…",
"marketUrl": "…",
"sourceUrl": "…",
"question": "…",
"condition_id": "…",
"end_date": "…",
"market_odds": 0,
"volume_24h": 0,
"quotientUrl": "…",
"polymarketUrl": "…",
"relationships": {
"assets": [
{}
],
"markets": [
{}
],
"signals": [
{}
],
"truncated": {
"assets": false,
"markets": false,
"signals": false
}
}
},
"relationships": {
"assets": [
{}
],
"markets": [
{}
],
"signals": [
{}
],
"truncated": {
"assets": false,
"markets": false,
"signals": false
}
}
},
"featured_by": "pin",
"message": "…"
}