Documentation / API reference / OTC
List OTC Alpha Offers
Reference
Last reviewed 2026-09-18
Returns currently active and historical buy-side offers on the Taostats OTC desk. An offer is a buyer's bid to buy alpha on a subnet at a price expressed as a basis-point offset from the current market price. The executed price is snapped at the moment a seller matches the offer. Pair with /api/otc/listing/v2 (sell-side) and /api/otc/trade/v2 (executed matches).
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
offer_id | query | string | Filter by exact offer id. | |
buyer | query | string | Filter by buyer coldkey (SS58). | |
netuid | query | integer (int32) | Subnet id. | |
status | query | string | Offer lifecycle state: active, filled, cancelled, expired. One of active, cancelled, taken, all. | |
price_offset_bps_min | query | integer (int32) | Minimum offset from market price in basis points (signed). | |
price_offset_bps_max | query | integer (int32) | Maximum offset from market price in basis points. | |
amount_min | query | string | Minimum alpha amount in rao. | |
amount_max | query | string | Maximum alpha amount in rao. | |
created_block_start | query | integer (int32) | Earliest block height the offer was created at (inclusive). | |
created_block_end | query | integer (int32) | Latest block height the offer was created at (inclusive). | |
created_timestamp_start | query | integer (int64) | Earliest Unix timestamp (seconds) the offer was created at (inclusive). | |
created_timestamp_end | query | integer (int64) | Latest Unix timestamp (seconds) the offer was created at (inclusive). | |
page | query | integer (int32) | 1-based page number. | |
limit | query | integer (int32) | Page size (max 200). | |
order | query | string | Sort order, e.g. created_block_desc. One of created_asc, created_desc, updated_asc, updated_desc, price_offset_bps_asc, price_offset_bps_desc, amount_asc, amount_desc. |
Responses
200 — TAO offers retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].amount | string | Yes | |
data[].buyer | object | Yes | |
data[].buyer.hex | string | Yes | The hex format of the hot key |
data[].buyer.ss58 | string | Yes | The SS58 format of the hot key |
data[].created_block | integer (int32) | Yes | |
data[].created_timestamp | string (date-time) | Yes | |
data[].netuid | integer (int32) | Yes | |
data[].offer_id | string | Yes | |
data[].price_offset_bps | integer (int32) | Yes | |
data[].status | string | Yes | |
data[].updated_block | integer (int32) | Yes | |
data[].updated_timestamp | string (date-time) | Yes | |
pagination | object | Yes | |
pagination.current_page | integer (int32) | Yes | |
pagination.next_page | integer (int32), nullable | ||
pagination.per_page | integer (int32) | Yes | |
pagination.prev_page | integer (int32), nullable | ||
pagination.total_items | integer (int32) | Yes | |
pagination.total_pages | integer (int32) | Yes |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.