> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Perpetual Markets

> Perpetual markets metadata including HIP-3 permissionless perpetual DEXes

The `hyperliquid.raw.perpetual_markets` table contains perpetual markets metadata including HIP-3 permissionless perpetual DEXes. Spot tokens are in `hyperliquid.raw.tokens`.

## Table Columns

| Column Name              | Description                                                                                                                                                                                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| index                    | Unique market index identifier.                                                                                                                                                                                                                           |
| market\_name             | Name of the perpetual market.                                                                                                                                                                                                                             |
| base\_symbol             | The base token symbol (e.g., BTC, ETH).                                                                                                                                                                                                                   |
| quote\_symbol            | The quote/collateral token symbol (e.g., USDC).                                                                                                                                                                                                           |
| dex\_name                | The HIP-3 DEX name if this is a permissionless perpetual. Empty for native perps.                                                                                                                                                                         |
| dex\_full\_name          | The full name of the HIP-3 DEX.                                                                                                                                                                                                                           |
| dex\_deployer            | The address of the HIP-3 DEX deployer.                                                                                                                                                                                                                    |
| dex\_fee\_recipient      | The address that receives trading fees for HIP-3 DEX trades.                                                                                                                                                                                              |
| is\_hip3                 | Whether this is a HIP-3 permissionless perpetual market (true) or native (false).                                                                                                                                                                         |
| max\_leverage            | Maximum leverage allowed for the market.                                                                                                                                                                                                                  |
| sz\_decimals             | Number of decimals for size/quantity.                                                                                                                                                                                                                     |
| margin\_mode             | Margin mode for the market.                                                                                                                                                                                                                               |
| only\_isolated           | Whether the market only supports isolated margin.                                                                                                                                                                                                         |
| is\_delisted             | Whether the market has been delisted.                                                                                                                                                                                                                     |
| margin\_table\_id        | Margin table identifier.                                                                                                                                                                                                                                  |
| collateral\_token\_index | Index of the collateral token in the tokens table.                                                                                                                                                                                                        |
| api\_category            | HIP-3 deployer-supplied category for the market (lowercased). NULL when the deployer has not supplied a category — includes native main-dex perps and HIP-3 venues that have not yet annotated their markets.                                             |
| category                 | Asset class for the perpetual market. Possible values: `crypto`, `fx`, `bonds`, `commodities`, `preipo`, `indices`, `stocks`, `others`. Always populated for HIP-3 and native main-dex markets; new values may appear as deployers introduce new markets. |
| description              | Long-form description of the underlying asset for HIP-3 perpetual markets, supplied by the deployer. NULL for native main-dex perpetuals.                                                                                                                 |
| keywords                 | Search keywords for HIP-3 perpetual markets, supplied by the deployer. Stored as an array. NULL for native main-dex perpetuals.                                                                                                                           |
| display\_name            | Human-readable display name for HIP-3 perpetual markets, supplied by the deployer. NULL for native main-dex perpetuals.                                                                                                                                   |
| \_created\_at            | Timestamp when the record was first created.                                                                                                                                                                                                              |
| \_updated\_at            | Timestamp when the record was last updated.                                                                                                                                                                                                               |