> ## 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 a single tradeable instrument > Returns the full public definition of one instrument named by `instrument_name`: type, activation window and active status, tick size, min/max/step amounts, maker/taker/base fee rates, pro-rata matching parameters, base/quote currencies, and type-specific details (option, perp, or spot). Expired options remain queryable by `instrument_name`. Public endpoint. ## OpenAPI ````yaml /openapi.json post /public/get_instrument 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_instrument: post: tags: - Market Data summary: Get a single tradeable instrument description: >- Returns the full public definition of one instrument named by `instrument_name`: type, activation window and active status, tick size, min/max/step amounts, maker/taker/base fee rates, pro-rata matching parameters, base/quote currencies, and type-specific details (option, perp, or spot). Expired options remain queryable by `instrument_name`. Public endpoint. operationId: public_get_instrument requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetInstrumentRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Instrument' default: description: JSON-RPC error (see Error Codes) components: schemas: GetInstrumentRequest: type: object required: - instrument_name properties: instrument_name: type: string Instrument: type: object required: - amount_step - base_asset_address - base_asset_sub_id - base_currency - base_fee - fifo_min_allocation - instrument_name - instrument_type - is_active - maker_fee_rate - maximum_amount - minimum_amount - pro_rata_amount_step - pro_rata_fraction - quote_currency - scheduled_activation - scheduled_deactivation - taker_fee_rate - tick_size properties: amount_step: type: string base_asset_address: description: >- The traded asset's contract address — word 0 (`asset`) of the order action `data`. Use this (not `erc20_details`) when signing an order. type: string base_asset_sub_id: description: >- The traded asset's sub-id — word 1 (`subId`) of the order action `data`. Decimal string; `"0"` for perps and spot. type: string base_currency: type: string base_fee: type: string erc20_details: anyOf: - $ref: '#/components/schemas/ERC20Details' - type: 'null' fifo_min_allocation: type: string instrument_name: type: string instrument_type: $ref: '#/components/schemas/AssetType' is_active: type: boolean maker_fee_rate: type: string mark_price_fee_rate_cap: type: - string - 'null' maximum_amount: type: string minimum_amount: type: string option_details: anyOf: - $ref: '#/components/schemas/OptionDetails' - type: 'null' perp_details: anyOf: - $ref: '#/components/schemas/PerpDetails' - type: 'null' pro_rata_amount_step: type: string pro_rata_fraction: type: string quote_currency: type: string scheduled_activation: type: integer format: int64 scheduled_deactivation: type: integer format: int64 taker_fee_rate: type: string tick_size: type: string ERC20Details: type: object required: - borrow_index - decimals - supply_index - underlying_erc20_address properties: borrow_index: type: string decimals: type: integer format: uint8 minimum: 0 supply_index: type: string underlying_erc20_address: type: string AssetType: description: 'Asset type of the instrument: `"option"`, `"perp"`, or `"erc20"`.' type: string enum: - option - perp - erc20 OptionDetails: type: object required: - expiry - index - option_type - strike properties: expiry: type: integer format: uint64 minimum: 0 index: type: string option_type: type: string settlement_price: type: - string - 'null' strike: type: string PerpDetails: type: object required: - aggregate_funding - funding_rate - index - max_rate_per_hour - min_rate_per_hour - static_interest_rate properties: aggregate_funding: type: string funding_rate: type: string index: type: string max_rate_per_hour: type: string min_rate_per_hour: type: string static_interest_rate: type: string ```` ## Related topics - [Instrument Names](/trading/instrument-names.md) - [RFQ Trading](/trading/rfq.md) - [Get details for a single currency](/api-reference/market-data/get-details-for-a-single-currency.md)