Concepts › Signals › Volume › Relative & unusual volume
illiquid
Thinly traded — 10-day average volume is under 100k shares.
Watch this signal live on real tickers: Open in Explore →
At a glance
Definition
avg_volume_10d < 100000| Type | state (boolean) |
| Group | Volume |
| Category | Relative & unusual volume |
| Update cadence | post-close daily |
| Intervals | 1d |
| Universe | all tickers |
| History | historized — has never fired to date |
| Firing | continuous |
Trading activity relative to baseline: relative volume, bursts, unusual-volume flags, liquidity conditions.
Query it
Every applicable form factor, grouped by endpoint family. Swap YOUR_KEY for the value from /dashboard/keys. Response payloads are real captures, sampled 2026-08-18 and trimmed — your run's values and dates will differ.
Use signals /v2/signals/{signal}
One signal across the market: who matches now, who matched then, and a push when someone starts. Docs →
Live — every ticker where it fires now
curl "https://api.tickerbot.io/v2/signals/illiquid" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-08-18T00:24:13.231Z",
"signal": "illiquid",
"condition": null,
"universe": null,
"count": 2,
"results": [
{
"ticker": "AAA",
"name": "Alternative Access First Priority CLO Bond ETF",
"value": true
},
{
"ticker": "AAAA",
"name": "Amplius Aggressive Asset Allocation ETF",
"value": true
}
]
}As-of — the same read at a past date
curl "https://api.tickerbot.io/v2/signals/illiquid?asof=2026-05-20" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-05-20",
"signal": "illiquid",
"condition": null,
"universe": null,
"count": 0,
"results": []
}Subscribe — webhook when a ticker starts matching
curl -X POST "https://api.tickerbot.io/v2/signals/illiquid/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"target_url": "https://example.com/hooks/tickerbot"}'Returns 201 with the created webhook — the same shape as GET /v2/webhooks/{id}, plus a one-time signing_secret for HMAC verification.
Use scan /v2/scan
The whole market through a WHERE clause — this signal composed freely with any other column. Docs →
Live — the whole market, filtered on this signal
curl -G "https://api.tickerbot.io/v2/scan" \
--data-urlencode "q=illiquid" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-08-18T00:24:15.657Z",
"query": {
"q": "illiquid",
"limit": 2,
"order": "day_change_pct",
"dir": "desc",
"fields": [],
"full": false,
"universe": null,
"asset_class": null
},
"count": 2,
"results": [
{
"ticker": "SAC.WS",
"name": "Safeguard Acquisition Corp. Warrants, each whole warrant exercisable for one Class A ordinary share at an exercise price of $11.50 per share",
"asset_class": "stocks",
"asset_type": "WARRANT",
"price": 22150.1905,
"day_change_pct": 36922.138,
"gap_pct": null,
"relative_volume": null,
"market_cap": null
},
{
"ticker": "RNWWW",
"name": "ReNew Energy Global plc Warrant",
"asset_class": "stocks",
"asset_type": "WARRANT",
"price": 0.0057,
"day_change_pct": 4.74,
"gap_pct": null,
"relative_volume": null,
"market_cap": null
}
]
}As-of — the same scan at a past date
curl -G "https://api.tickerbot.io/v2/scan" \
--data-urlencode "q=illiquid" \
-d "asof=2026-05-20" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-05-20",
"query": {
"q": "illiquid",
"asof": "2026-05-20",
"interval": "auto",
"limit": 2,
"order": "day_change_pct",
"dir": "desc",
"fields": [],
"full": false,
"universe": null,
"asset_class": null
},
"count": 0,
"results": []
}Subscribe — webhook on a market-wide condition
curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"q": "illiquid", "target_url": "https://example.com/hooks/tickerbot"}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.
Use series /v2/series
Its history over time, on one aligned grid. Docs →
History — the column on an aligned time grid
curl "https://api.tickerbot.io/v2/series?tickers=AAPL,MSFT&columns=close,illiquid" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-08-18T00:24:18.071Z",
"interval": "1d",
"tickers": [
"AAPL",
"MSFT"
],
"columns": [
"close",
"illiquid"
],
"count": 6,
"series": {
"AAPL": [
{
"t": "2026-08-12",
"close": 302.25,
"illiquid": false
},
{
"t": "2026-08-13",
"close": 305.26,
"illiquid": false
},
{
"t": "2026-08-14",
"close": 305.93,
"illiquid": false
}
],
"MSFT": [
{
"t": "2026-08-12",
"close": 492.43,
"illiquid": false
},
{
"t": "2026-08-13",
"close": 496.88,
"illiquid": false
},
{
"t": "2026-08-14",
"close": 495.4,
"illiquid": false
}
]
}
}Use events /v2/events
The flag as a timeline: each edge as a point event, and the spans it stayed true. Docs →
Firings — every enter edge as a point event
curl -G "https://api.tickerbot.io/v2/events" \
-d "kind=signal" -d "signal=illiquid" -d "transition=enter" -d "since=2026-01-10" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-08-18T00:24:18.217Z",
"query": {
"kind": "signal",
"tickers": null,
"universe": null,
"since": "2026-01-10T00:00:00.000Z",
"until": null,
"limit": 2,
"signal": "illiquid",
"transition": "enter"
},
"count": 0,
"results": []
}Spans — when it was true for one ticker (AAPL)
curl "https://api.tickerbot.io/v2/signals/illiquid/AAPL/events" \
-H "Authorization: Bearer YOUR_KEY"Response (sampled 2026-08-18, trimmed)
{
"as_of": "2026-08-18T00:24:18.357Z",
"ticker": "AAPL",
"signal": "illiquid",
"count": 0,
"events": []
}Same grammar on scan, series, and webhooks; state reads take ?asof= for point-in-time answers.