> ## Documentation Index > Fetch the complete documentation index at: https://v3.docs.derive.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Get details for a single currency > Returns the full detail record for one currency named by the required `currency` parameter: supported instrument types, risk managers, current and 24h spot price, margin collateral discounts, lending APYs and totals, per-manager open-interest caps and current OI, and protocol asset addresses. Returns a not-found error for unknown currencies. Public endpoint. ## OpenAPI ````yaml /openapi.json post /public/get_currency 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: 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_currency: post: tags: - Market Data summary: Get details for a single currency description: >- Returns the full detail record for one currency named by the required `currency` parameter: supported instrument types, risk managers, current and 24h spot price, margin collateral discounts, lending APYs and totals, per-manager open-interest caps and current OI, and protocol asset addresses. Returns a not-found error for unknown currencies. Public endpoint. operationId: public_get_currency requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetCurrencyRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Currency' default: description: JSON-RPC error (see Error Codes) components: schemas: GetCurrencyRequest: type: object required: - currency properties: currency: type: string Currency: description: >- A currency's spot price and its assets grouped by type. Managers risking the currency are listed per universe under `managers`; asset-level risk — OI, lending, and discounts — lives under each asset's `universes`. type: object required: - currency - managers - market_type - spot - spot_price properties: currency: type: string managers: description: >- Managers risk-pricing this currency, one entry per universe where at least one manager covers it. type: array items: $ref: '#/components/schemas/UniverseManagers' market_type: $ref: '#/components/schemas/MarketType' description: Which instrument/collateral classes the currency is enabled for. option: description: The option asset for this currency, if one is registered. anyOf: - $ref: '#/components/schemas/AssetEntry' - type: 'null' perp: description: The perp asset for this currency, if one is registered. anyOf: - $ref: '#/components/schemas/AssetEntry' - type: 'null' spot: description: >- Every spot asset registered to this currency (e.g. lending "USDC" and non-lending "USDC-NL"). type: array items: $ref: '#/components/schemas/SpotAssetEntry' spot_price: type: string spot_price_24h: type: - string - 'null' UniverseManagers: description: The managers risk-pricing a currency within one universe. type: object required: - risk_universe_id properties: pm: description: PMRM2 manager id risking this currency in the universe. type: - integer - 'null' format: uint32 minimum: 0 risk_universe_id: type: integer format: uint32 minimum: 0 sm: description: SRM manager id risking this currency in the universe. type: - integer - 'null' format: uint32 minimum: 0 MarketType: type: string enum: - ALL - SRM_BASE_ONLY - SRM_OPTION_ONLY - SRM_PERP_ONLY - CASH AssetEntry: description: A non-spot asset (option or perp) and its per-universe risk. type: object required: - address - name - universes properties: address: description: EIP-55 checksummed protocol asset address. type: string name: description: Registered asset name (e.g. "ETH-OPTION", "ETH-PERP"). type: string universes: type: array items: $ref: '#/components/schemas/AssetUniverse' SpotAssetEntry: description: >- A spot asset and its per-universe risk: collateral discounts, lending, OI. type: object required: - address - erc20 - min_deposit_usd - name - universes properties: address: description: EIP-55 checksummed protocol asset address. type: string erc20: $ref: '#/components/schemas/Erc20Details' min_deposit_usd: type: string name: description: Registered asset name (e.g. "USDC", "USDC-NL"). type: string universes: type: array items: $ref: '#/components/schemas/SpotUniverse' AssetUniverse: description: Per-`(asset, universe)` open interest for an option/perp asset. type: object required: - oi - risk_universe_id properties: oi: $ref: '#/components/schemas/OpenInterestStats' risk_universe_id: type: integer format: uint32 minimum: 0 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' SpotUniverse: description: Risk details for a single `(spot_asset, universe)` pair. type: object required: - oi - pm2_im_discount - pm2_mm_discount - risk_universe_id - srm_im_discount - srm_mm_discount properties: lending: description: Lending stats; null if the asset has no pool in this universe. anyOf: - $ref: '#/components/schemas/LendingDetails' - type: 'null' oi: $ref: '#/components/schemas/OpenInterestStats' description: >- Spot supply OI cap + current supply (for a lending asset, the current supply is the pool's total supplied collateral). pm2_im_discount: description: PMRM2 collateral haircut ("0" if not collateralized). type: string pm2_mm_discount: type: string risk_universe_id: type: integer format: uint32 minimum: 0 srm_im_discount: description: SRM collateral discount (cash asset "1"; non-collateral "0"). type: string srm_mm_discount: type: string OpenInterestStats: type: object required: - current_open_interest - interest_cap properties: current_open_interest: type: string interest_cap: type: string LendingDetails: description: >- Lending pool stats for a `(spot_asset, universe)` pair. The pool's total supply is reported in the `current_open_interest` field. type: object required: - borrow_apy - supply_apy - total_borrow - total_borrow_cap properties: borrow_apy: type: string supply_apy: type: string total_borrow: type: string total_borrow_cap: description: Borrow ceiling for this lending asset in this universe. type: string ```` ## Related topics - [Get a single tradeable instrument](/api-reference/market-data/get-a-single-tradeable-instrument.md) - [List all supported currencies with details](/api-reference/market-data/list-all-supported-currencies-with-details.md) - [List assets for a currency and type](/api-reference/market-data/list-assets-for-a-currency-and-type.md)