> ## 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 tickers for a currency and type

> Returns a map of instrument name to latest ticker snapshot for an `instrument_type`. Options require both `currency` and an 8-digit `expiry_date` (YYYYMMDD); perps and spot accept an optional `currency` (omit to fetch all currencies) and reject `expiry_date`. Public endpoint.



## OpenAPI

````yaml /openapi.json post /public/get_tickers
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_tickers:
    post:
      tags:
        - Market Data
      summary: Get tickers for a currency and type
      description: >-
        Returns a map of instrument name to latest ticker snapshot for an
        `instrument_type`. Options require both `currency` and an 8-digit
        `expiry_date` (YYYYMMDD); perps and spot accept an optional `currency`
        (omit to fetch all currencies) and reject `expiry_date`. Public
        endpoint.
      operationId: public_get_tickers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTickersRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTickersResponse'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    GetTickersRequest:
      description: >-
        Parameters for `public/get_tickers`. `expiry_date` accepts either a JSON
        number or a string-encoded 8-digit date (e.g. `20260511`).
      type: object
      required:
        - instrument_type
      properties:
        currency:
          default: null
          type:
            - string
            - 'null'
        expiry_date:
          default: null
        instrument_type:
          $ref: '#/components/schemas/AssetType'
    GetTickersResponse:
      description: >-
        A map of instrument name to ticker: `{"tickers": {<instrument_name>:
        <ticker_data>}}`. Each ticker value matches the payload of a
        `ticker_slim.{instrument_name}.{interval}` subscription update.
      type: object
      required:
        - tickers
      properties:
        tickers:
          type: object
          additionalProperties: true
    AssetType:
      description: 'Asset type of the instrument: `"option"`, `"perp"`, or `"erc20"`.'
      type: string
      enum:
        - option
        - perp
        - erc20

````

## Related topics

- [Get the ticker for one instrument](/api-reference/market-data/get-the-ticker-for-one-instrument.md)
- [Instrument Names](/trading/instrument-names.md)
- [Subscriptions](/subscriptions.md)