> ## 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. # List instruments with pagination > Returns a paginated list of full instrument definitions filtered by `instrument_type`, optional `currency`, and `expired` flag, with `page`/`page_size` (max 1000) controls and pagination metadata. Expired options are included when the `expired` flag is set. Public endpoint. ## OpenAPI ````yaml /openapi.json post /public/get_all_instruments 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_all_instruments: post: tags: - Market Data summary: List instruments with pagination description: >- Returns a paginated list of full instrument definitions filtered by `instrument_type`, optional `currency`, and `expired` flag, with `page`/`page_size` (max 1000) controls and pagination metadata. Expired options are included when the `expired` flag is set. Public endpoint. operationId: public_get_all_instruments requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetAllInstrumentsRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetAllInstrumentsResponse' default: description: JSON-RPC error (see Error Codes) components: schemas: GetAllInstrumentsRequest: type: object required: - expired - instrument_type properties: currency: default: null type: - string - 'null' expired: type: boolean instrument_type: $ref: '#/components/schemas/AssetType' page: default: null type: - integer - 'null' format: uint64 minimum: 0 page_size: default: null type: - integer - 'null' format: uint64 minimum: 0 GetAllInstrumentsResponse: type: object required: - instruments - pagination properties: instruments: type: array items: $ref: '#/components/schemas/Instrument' pagination: $ref: '#/components/schemas/Pagination' AssetType: description: 'Asset type of the instrument: `"option"`, `"perp"`, or `"erc20"`.' type: string enum: - option - perp - erc20 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 Pagination: description: Response envelope for paginated RPCs. type: object required: - count - num_pages properties: count: type: integer format: uint64 minimum: 0 num_pages: type: integer format: uint64 minimum: 0 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 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 - [List names of all live instruments](/api-reference/market-data/list-names-of-all-live-instruments.md) - [List a subaccount's quotes with history](/api-reference/rfq/list-a-subaccounts-quotes-with-history.md) - [List a subaccount's RFQs with history](/api-reference/rfq/list-a-subaccounts-rfqs-with-history.md)