> ## 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 the ticker for one instrument

> Returns the latest ticker snapshot for a single instrument named by `instrument_name`. The payload matches the data of a `ticker_slim.{instrument}.{interval}` subscription update (mark/index prices, best bid/ask, sizes, greeks, and related fields). Returns an error if no ticker is available. Public endpoint.



## OpenAPI

````yaml /openapi.json post /public/get_ticker
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_ticker:
    post:
      tags:
        - Market Data
      summary: Get the ticker for one instrument
      description: >-
        Returns the latest ticker snapshot for a single instrument named by
        `instrument_name`. The payload matches the data of a
        `ticker_slim.{instrument}.{interval}` subscription update (mark/index
        prices, best bid/ask, sizes, greeks, and related fields). Returns an
        error if no ticker is available. Public endpoint.
      operationId: public_get_ticker
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTickerRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TickerSlimSnapshot'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    GetTickerRequest:
      type: object
      required:
        - instrument_name
      properties:
        instrument_name:
          type: string
    TickerSlimSnapshot:
      type: object
      required:
        - A
        - B
        - I
        - M
        - a
        - b
        - maxp
        - minp
        - stats
        - t
      properties:
        A:
          description: Amount of contracts / tokens available at the best ask price.
          type: string
        B:
          description: Amount of contracts / tokens available at the best bid price.
          type: string
        I:
          description: Index price.
          type: string
        M:
          description: Mark price.
          type: string
        a:
          description: Best ask price.
          type: string
        b:
          description: Best bid price.
          type: string
        f:
          description: Current hourly funding rate (perpetuals only; `null` otherwise).
          type:
            - string
            - 'null'
        maxp:
          description: >-
            Maximum price at which an aggressive buyer can be matched. Any
            portion of a market order that would execute above this price is
            cancelled. A limit buy order with limit price above this value is
            treated as post only (i.e. it is rejected if it would cross any
            existing resting order).
          type: string
        minp:
          description: >-
            Minimum price at which an aggressive seller can be matched. Any
            portion of a market order that would execute below this price is
            cancelled. A limit sell order with limit price below this value is
            treated as post only (i.e. it is rejected if it would cross any
            existing resting order).
          type: string
        option_pricing:
          description: Option greeks and implied vols (options only; `null` otherwise).
          anyOf:
            - $ref: '#/components/schemas/OptionPricing'
            - type: 'null'
        stats:
          $ref: '#/components/schemas/DailyTradingStatistics'
          description: Trailing 24-hour trading statistics.
        t:
          description: Snapshot creation timestamp, in milliseconds since the Unix epoch.
          type: integer
          format: int64
    OptionPricing:
      type: object
      required:
        - ai
        - bi
        - d
        - df
        - f
        - g
        - i
        - m
        - r
        - t
        - v
      properties:
        ai:
          description: Implied volatility of the current best ask.
          type: string
        bi:
          description: Implied volatility of the current best bid.
          type: string
        d:
          description: Delta of the option.
          type: string
        df:
          description: Discount factor used to calculate the option premium.
          type: string
        f:
          description: Forward price used to calculate the option premium.
          type: string
        g:
          description: Gamma of the option.
          type: string
        i:
          description: Implied volatility of the option.
          type: string
        m:
          description: Mark price of the option.
          type: string
        r:
          description: Rho of the option.
          type: string
        t:
          description: Theta of the option.
          type: string
        v:
          description: Vega of the option.
          type: string
    DailyTradingStatistics:
      type: object
      required:
        - c
        - h
        - l
        - 'n'
        - oi
        - p
        - pr
        - v
      properties:
        c:
          description: Number of contracts traded during last 24 hours
          type: string
          format: decimal
        h:
          description: Highest trade price during last 24h
          type: string
          format: decimal
        l:
          description: Lowest trade price during last 24h
          type: string
          format: decimal
        'n':
          description: Number of trades during last 24h
          type: integer
          format: uint64
          minimum: 0
        oi:
          description: Current total open interest
          type: string
          format: decimal
        p:
          description: >-
            Options: 24hr percent change in premium; Perps: 24hr percent change
            in mark price
          type: string
          format: decimal
        pr:
          description: Premium volume traded during last 24 hours
          type: string
          format: decimal
        v:
          description: Notional volume traded during last 24 hours
          type: string
          format: decimal

````

## Related topics

- [Get tickers for a currency and type](/api-reference/market-data/get-tickers-for-a-currency-and-type.md)
- [Ticker slim](/api-reference/channels/tickerslim.md)
- [Instrument Names](/trading/instrument-names.md)
