Skip to main content
Source OpenAPI: 0xArchive API 1.5.0; 140 paths; 119 component schemas. List the public market symbol universe across supported 0xArchive venue families. This no-auth feed powers website discovery and can be used before choosing a venue-specific route. It is a public utility route, not a legacy alias.

​
Route Metadata

FieldValue
MethodGET
Path/v1/symbols
operationIdlistSymbols
TagSystem
FamilySystem
Deprecated or legacyno

​
Response Contracts

​
Status 200

Public symbol universe

​
application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "listSymbols response 200",
  "description": "Public symbol universe response.",
  "type": "object",
  "required": [
    "symbols"
  ],
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "description": "Public market symbol entry.",
        "type": "object",
        "required": [
          "data_types",
          "exchange",
          "symbol"
        ],
        "properties": {
          "coverage_by_type": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "format": "date-time"
            }
          },
          "coverage_from": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "coverage_to": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "data_types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "l2_orderbook",
              "trades",
              "liquidations"
            ]
          },
          "display_title": {
            "type": "string",
            "nullable": true
          },
          "exchange": {
            "description": "Venue-family key.",
            "type": "string",
            "example": "hyperliquid"
          },
          "is_active": {
            "type": "boolean",
            "nullable": true
          },
          "is_settled": {
            "type": "boolean",
            "nullable": true
          },
          "outcome_pair": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            },
            "minItems": 2,
            "maxItems": 2
          },
          "size_per_day": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            }
          },
          "slug": {
            "description": "HIP-4 slug when available.",
            "type": "string",
            "nullable": true
          },
          "symbol": {
            "type": "string",
            "example": "BTC"
          }
        },
        "additionalProperties": false
      }
    }
  }
}

​
Status 400

Invalid request

​
application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "listSymbols response 400",
  "description": "Error response",
  "type": "object",
  "properties": {
    "code": {
      "description": "HTTP status code",
      "type": "integer"
    },
    "error": {
      "description": "Error message",
      "type": "string"
    }
  }
}
OpenAPI example
{
  "code": 400,
  "error": "Invalid request parameters"
}

​
Status 429

Rate limit exceeded

​
application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "listSymbols response 429",
  "description": "Error response",
  "type": "object",
  "properties": {
    "code": {
      "description": "HTTP status code",
      "type": "integer"
    },
    "error": {
      "description": "Error message",
      "type": "string"
    }
  }
}
OpenAPI example
{
  "code": 429,
  "error": "Rate limit exceeded"
}
Last modified on June 19, 2026