GET
/api/v1/signals/oil
Status of the WTI crude oil signal
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| include_marks | query | boolean | Include live venue marks (two upstream fetches). Default: true |
Response fields
| Field | Type | Meaning |
|---|---|---|
| asset | "crude-wti" | |
| reading | object | The latest frozen daily crude signal. Null when no reading has ever been recorded. |
| episode | object | Consecutive same-side reading days, scored once from the opening day |
| marks | object | |
| degraded | boolean | True when a requested venue mark could not be fetched |
| reading_missing | boolean | True when no reading has ever been recorded (reading is null). A stale reading still returns false — use reading.is_current / days_since_reading to detect a missed today-reading. |
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/oil"Run sends this request with preset parameters on Quotient’s demo key. Your credits are not spent.
200 · application/json
{
"asset": "crude-wti",
"reading": {
"id": "…",
"reading_date": "…",
"is_current": false,
"days_since_reading": 0,
"state": "bullish",
"side": "long",
"z": 0,
"gap": 0,
"intensity": "…",
"basis_forecasts": 0,
"basis_markets": 0,
"headline": "…",
"summary": "…",
"formula_version": "…",
"relationships": {
"assets": [
{}
],
"markets": [
{}
],
"signals": [
{}
],
"truncated": {
"assets": false,
"markets": false,
"signals": false
}
}
},
"episode": {
"id": "…",
"opened_at": "…",
"days": 0,
"status": "open",
"ref_price": 0,
"outcome_price": 0,
"outcome_at": "…",
"return_pct": 0,
"live_return_pct": 0
},
"marks": {
"polymarket_perps": {
"symbol": "…",
"mark": 0,
"index": 0,
"funding_rate": 0,
"at": "…"
},
"hyperliquid": {
"coin": "…",
"mid": 0,
"at": "…"
}
},
"degraded": false,
"reading_missing": false
}