> ## Documentation Index
> Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve current market rates and pricing information for specified instruments

> Provides real-time market data including bid/ask prices, conversion rates, and execution prices for specified financial instruments. Essential for price discovery and trade execution decisions.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/market-data/instruments/rates
openapi: 3.0.1
info:
  title: eToro Api
  version: v1.206.0
  description: >-
    eToro’s public API provides access to real-time financial data, trading
    insights, and account management features, allowing developers to integrate
    eToro’s services into their applications. With access to market prices,
    historical data, and social trading information, the API empowers users to
    enhance their trading strategies. Designed for security and scalability, the
    eToro API ensures smooth and reliable integration for a variety of financial
    applications.


    For more details on integrating with eToro's public WebSocket service,
    please refer to the dedicated [WebSocket
    documentation](./websocket/websocket-doc.html).
servers:
  - url: https://public-api.etoro.com
    description: eToro Public API
security: []
tags:
  - name: Agent Portfolios
  - name: Watchlists
  - name: Feeds
  - name: Asset Explorer
  - name: Market Data
  - name: Identity
  - name: Notifications
  - name: PI Data
  - name: Comments
  - name: Trading Demo
  - name: Trading Real
  - name: Users Info
  - name: Deprecated
paths:
  /api/v1/market-data/instruments/rates:
    get:
      tags:
        - Market Data
      summary: >-
        Retrieve current market rates and pricing information for specified
        instruments
      description: >-
        Provides real-time market data including bid/ask prices, conversion
        rates, and execution prices for specified financial instruments.
        Essential for price discovery and trade execution decisions.
      operationId: retrieveCurrentMarketRatesPricingInformation
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: c7f9d79e-5726-4a69-b911-6fa39be6a566
          description: A unique request identifier.
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
          description: API key for authentication.
        - name: x-user-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: >-
              eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
          description: User-specific authentication key.
        - name: instrumentIds
          in: query
          style: form
          description: >-
            Comma-separated list of instrument IDs to retrieve market rates for.
            Each ID represents a unique tradable asset in the system.
          explode: false
          schema:
            type: array
            items:
              type: integer
              format: int32
            maxItems: 100
          example: 1,2,3
          required: true
      responses:
        '200':
          description: Successfully retrieved current market rates
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveRatesResponse'
        '400':
          description: >-
            Invalid request - Typically due to invalid instrument IDs or
            exceeding maximum limit
components:
  schemas:
    LiveRatesResponse:
      type: object
      description: Container for real-time market rates data
      properties:
        rates:
          type: array
          description: Array of current market rates for requested instruments
          items:
            type: object
            description: Individual instrument rate information
            properties:
              instrumentID:
                type: integer
                description: Unique identifier for the financial instrument
              ask:
                type: number
                format: float
                description: >-
                  Current asking price (offer) for the instrument. This is the
                  price at which you can buy the asset.
              bid:
                type: number
                format: float
                description: >-
                  Current bid price for the instrument. This is the price at
                  which you can sell the asset.
              lastExecution:
                type: number
                format: float
                description: Price of the most recent trade execution for this instrument
              conversionRateAsk:
                type: number
                format: float
                description: >-
                  Current conversion rate (ask) from instrument's currency to
                  USD, used for position value calculations
              conversionRateBid:
                type: number
                format: float
                description: >-
                  Current conversion rate (bid) from instrument's currency to
                  USD, used for position value calculations
              date:
                type: string
                format: date-time
                description: The date-time of the price in the system
              unitMargin:
                type: number
                format: float
                description: (Obsolete) USD equivalent of the instrument price
              unitMarginAsk:
                type: number
                format: float
                description: (Obsolete) USD equivalent of the instrument ask price
              unitMarginBid:
                type: number
                format: float
                description: (Obsolete) USD equivalent of the instrument bid price
              priceRateID:
                type: integer
              bidDiscounted:
                type: number
                format: float
                description: Obsolete
              askDiscounted:
                type: number
                format: float
                description: Obsolete
              unitMarginBidDiscounted:
                type: number
                format: float
                description: Obsolete
              unitMarginAskDiscounted:
                type: number
                format: float
                description: Obsolete

````