List OTC alpha offers

Endpoint

GET /api/otc/offer/v2

Description

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).

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		Subnet id.
status	query	—		Offer lifecycle state: active, filled, cancelled, expired.
price_offset_bps_min	query	integer		Minimum offset from market price in basis points (signed).
price_offset_bps_max	query	integer		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		Earliest block height the offer was created at (inclusive).
created_block_end	query	integer		Latest block height the offer was created at (inclusive).
created_timestamp_start	query	integer		Earliest Unix timestamp (seconds) the offer was created at (inclusive).
created_timestamp_end	query	integer		Latest Unix timestamp (seconds) the offer was created at (inclusive).
page	query	integer		1-based page number.
limit	query	integer		Page size (max 200).
order	query	—		Sort order, e.g. created_block_desc.

Responses

200 — TAO offers retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "offer_id",
          "buyer",
          "netuid",
          "amount",
          "price_offset_bps",
          "status",
          "created_block",
          "created_timestamp",
          "updated_block",
          "updated_timestamp"
        ],
        "properties": {
          "amount": {
            "type": "string"
          },
          "buyer": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "created_block": {
            "type": "integer",
            "format": "int32"
          },
          "created_timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "offer_id": {
            "type": "string"
          },
          "price_offset_bps": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "type": "string"
          },
          "updated_block": {
            "type": "integer",
            "format": "int32"
          },
          "updated_timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}

400 — Bad request

500 — Internal server error

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.