Get Registered DeepBook Pools
Retrieve a list of all DeepBook trading pools that are enabled for margin trading, along with their risk parameters and liquidation configurations. This endpoint shows which trading pairs support leveraged positions.
Endpoint
GET /deepbook-margin/registered-deepbook-pools
Use Cases
- Pool Discovery — Find which DeepBook pools support margin trading
- Risk Parameter Display — Show liquidation thresholds and risk ratios to users
- Trading Interface Configuration — Configure leverage options based on pool settings
- Liquidation Bot Setup — Get reward parameters for liquidation strategies
Parameters
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
marginPoolId | string | No | Filter by margin pool ID (searches in both base and quote margin pool IDs) |
api-key | string | Yes | Your Surflux API key for authentication |
Response
Returns an array of registered DeepBook pool objects. Each pool contains:
| Field | Type | Description |
|---|---|---|
pool_id | string | DeepBook trading pool ID |
base_margin_pool_id | string | Margin pool ID for the base asset |
quote_margin_pool_id | string | Margin pool ID for the quote asset |
min_withdraw_risk_ratio | number | Minimum risk ratio to withdraw collateral |
min_borrow_risk_ratio | number | Minimum risk ratio to take new loans |
liquidation_risk_ratio | number | Risk ratio below which positions can be liquidated |
target_liquidation_risk_ratio | number | Target risk ratio after partial liquidation |
user_liquidation_reward | number | Reward percentage for liquidators |
pool_liquidation_reward | number | Reward percentage for the margin pool |
enabled | boolean | Whether margin trading is currently enabled |
extra_fields | object | null | Additional pool metadata |
checkpoint_id | number | Checkpoint when pool was last updated |
digest | string | Transaction digest of last update |
onchain_timestamp | number | On-chain timestamp in milliseconds |
created_at | string | ISO timestamp of registration |
updated_at | string | ISO timestamp of last update |