> ## Documentation Index > Fetch the complete documentation index at: https://docs.derive.xyz/llms.txt > Use this file to discover all available pages before exploring further. # public/get_risk_universes > Returns every risk universe (the isolated risk-containment boundaries trades never cross), each with its display name and description, its managers — at most one Standard (`SM`) and one Portfolio (`PM2`), each listing the derivative instruments it risk-prices and the collateral assets it accepts with their margin discounts and deposit metadata — and its Security Module. The one call that answers which universe and manager to choose: pick a universe, pick a manager in it, and pass its `manager_id` when depositing to a new subaccount (the accepted collateral entries carry the `asset` address for the deposit). The no-margin fallback universe (id 0) is included; it custodies dead-lettered deposits and lists no tradeable instruments. Public endpoint, no authentication required. ## OpenAPI ````yaml /openapi.json post /public/get_risk_universes openapi: 3.1.0 info: title: Derive v3 API version: 0.2.0 description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST. servers: - url: https://api.derive.xyz/v3 description: Production (HTTP POST base) - url: https://testnet.api.derive.xyz/v3 description: Testnet (HTTP POST base) security: [] tags: - name: Subaccounts description: >- List, inspect, and label subaccounts, portfolios, positions, and collateral. - name: Session Keys description: Register, edit, and list delegated signing keys. - name: Account description: Wallet-level account information and settings. - name: Orderbook description: Place, replace, cancel, and query orders, trigger orders, and algos. - name: RFQ description: 'Request-for-quote: send RFQs, quote, and execute block trades.' - name: Vault Shareholders description: >- Deposit into and withdraw from vaults, and track shares, requests, and performance. - name: Vault Curators description: >- Create and operate curated vaults: settle deposit and withdrawal requests, and manage vault metadata. - name: History description: >- Per-account historical records: orders, trades, transfers, and settlements. - name: Market Maker Protection description: Configure, read, and reset market-maker protection. - name: Transfers & Withdrawals description: Move collateral between subaccounts, to other wallets, and on-chain. - name: Onchain Actions description: >- L1 onchain actions submitted via OnchainActionManager: register deposit addresses, list pending deposits, and inspect onchain action history. - name: System description: Rate limits and transaction lookups. - name: Market Data description: Instruments, currencies, tickers, and market-wide feeds. - name: Referrals description: Referral codes and program performance. - name: Other description: Uncategorized. paths: /public/get_risk_universes: post: tags: - Market Data summary: public/get_risk_universes description: >- Returns every risk universe (the isolated risk-containment boundaries trades never cross), each with its display name and description, its managers — at most one Standard (`SM`) and one Portfolio (`PM2`), each listing the derivative instruments it risk-prices and the collateral assets it accepts with their margin discounts and deposit metadata — and its Security Module. The one call that answers which universe and manager to choose: pick a universe, pick a manager in it, and pass its `manager_id` when depositing to a new subaccount (the accepted collateral entries carry the `asset` address for the deposit). The no-margin fallback universe (id 0) is included; it custodies dead-lettered deposits and lists no tradeable instruments. Public endpoint, no authentication required. operationId: public_get_risk_universes requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EmptyRequest' responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/RiskUniverse' default: description: JSON-RPC error (see Error Codes) components: schemas: EmptyRequest: description: This method takes no parameters; send an empty object `{}`. type: 'null' RiskUniverse: description: >- One risk universe: its display metadata, managers (each with what it lets you trade and deposit), and the Security Module absorbing the universe's losses. The universe-first mirror of `public/get_all_currencies` — pick a universe, pick a manager in it, and the `manager_id` is what you pass when depositing to a new subaccount. type: object required: - managers - risk_universe_id - security_module properties: description: description: Short description of the universe; null until set by the exchange. type: - string - 'null' managers: description: >- The universe's managers (at most one Standard and one Portfolio), each with the instruments it risk-prices and the collaterals it accepts. type: array items: $ref: '#/components/schemas/RiskUniverseManager' name: description: >- Display name (e.g. "PRIME"), always uppercase; null until set by the exchange. type: - string - 'null' risk_universe_id: type: integer format: uint32 minimum: 0 security_module: $ref: '#/components/schemas/SecurityModuleDetails' RiskUniverseManager: description: A manager and what a subaccount created under it can trade and hold. type: object required: - collaterals - instruments - manager_id - margin_type properties: collaterals: description: Assets this manager accepts as deposit collateral. type: array items: $ref: '#/components/schemas/ManagerCollateral' instruments: description: >- Live derivative asset names tradeable under this manager, sorted (e.g. "BTC-OPTION", "BTC-PERP"). An option entry names the family — fetch its individual listings via `public/get_all_instruments`. type: array items: type: string manager_id: description: Pass this as `manager_id` when depositing to a new subaccount. type: integer format: uint32 minimum: 0 margin_type: $ref: '#/components/schemas/MarginType' SecurityModuleDetails: description: >- The universe's Security Module: the subaccount whose funds absorb insolvent losses before any socialization within the universe. type: object required: - cash_asset - cash_currency - subaccount_id properties: cash_asset: description: EIP-55 checksummed address of the universe's cash asset. type: string cash_currency: description: Currency of the cash asset (e.g. "USDC"). type: string subaccount_id: type: integer format: uint64 minimum: 0 ManagerCollateral: description: >- A spot asset the manager accepts as collateral, with deposit metadata and the manager's margin discounts for it ("1" = full credit, cash). type: object required: - address - erc20 - im_discount - min_deposit_usd - mm_discount - name properties: address: description: >- EIP-55 checksummed protocol asset address — the `asset` argument when depositing. type: string erc20: $ref: '#/components/schemas/Erc20Details' im_discount: description: Initial-margin credit for the asset under this manager. type: string min_deposit_usd: type: string mm_discount: description: Maintenance-margin credit for the asset under this manager. type: string name: description: Registered asset name (e.g. "USDC"). type: string MarginType: description: >- Margin model applied by a manager: `SM` (standard, cross-collateral) or `PM2` (portfolio, scenario-based netting). type: string enum: - SM - PM2 Erc20Details: type: object required: - decimals properties: decimals: type: integer format: uint8 minimum: 0 underlying_erc20: description: On-chain ERC20 token deposited into the spot asset (informational). type: - string - 'null' ```` ## Related topics - [Managers & Risk Universes](/trading/managers-and-risk-universes.md) - [Programmatic Onboarding](/getting-started/depositing.md) - [New features](/migrating/new-features.md)