---
title: "Get instrument market rates"
method: GET
path: "/api/v1/market-data/instruments/rates"
tags: ["Market Data"]
---

# Get instrument market rates

`GET /api/v1/market-data/instruments/rates`

**Rate limit:** 120 requests per 60 seconds. This is a **shared quota** — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota:
- `GET /api/v1/market-data/exchanges`
- `GET /api/v1/market-data/instrument-types`
- `GET /api/v1/market-data/instruments`
- `GET /api/v1/market-data/instruments/history/closing-price`
- `GET /api/v1/market-data/instruments/{instrumentId}/history/candles/{direction}/{interval}/{candlesCount}`
- `GET /api/v1/market-data/search`
- `GET /api/v1/market-data/stocks-industries`

---

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.

## Query parameters

- `instrumentIds` integer[], required

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required

## Response `200`

Successfully retrieved current market rates

- LiveRatesResponse — Container for real-time market rates data
  - `rates` object[] — Array of current market rates for requested instruments
    - `instrumentID` integer — Unique identifier for the financial instrument
    - `ask` number, float — Current asking price (offer) for the instrument. This is the price at which you can buy the asset.
    - `bid` number, float — Current bid price for the instrument. This is the price at which you can sell the asset.
    - `lastExecution` number, float — Price of the most recent trade execution for this instrument
    - `conversionRateAsk` number, float — Current conversion rate (ask) from instrument's currency to USD, used for position value calculations
    - `conversionRateBid` number, float — Current conversion rate (bid) from instrument's currency to USD, used for position value calculations
    - `date` string, date-time — The date-time of the price in the system
    - `unitMargin` number, float — (Obsolete) USD equivalent of the instrument price
    - `unitMarginAsk` number, float — (Obsolete) USD equivalent of the instrument ask price
    - `unitMarginBid` number, float — (Obsolete) USD equivalent of the instrument bid price
    - `priceRateID` integer
    - `bidDiscounted` number, float — Obsolete
    - `askDiscounted` number, float — Obsolete
    - `unitMarginBidDiscounted` number, float — Obsolete
    - `unitMarginAskDiscounted` number, float — Obsolete

## Other responses

- `400` — Invalid request - Typically due to invalid instrument IDs or exceeding maximum limit
- `429` — Too Many Requests — the shared rate limit (120 requests / 60s) was exceeded.

---

[API](https://skmtc.dev/etoro/apis/etoro-api.md) · [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/etoro/etoro-api/revisions/69c1fb266c35/schema)