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

# Multiple currencies rates

Retrieve real-time exchange rates for multiple specific currency pairs in a single request. This endpoint is efficient for applications that need to track a watchlist of currencies or update a specific set of rates without fetching the entire dataset.

### Path parameters

<ParamField path="format" type="string" optional default="json">
  The desired output format. Options: `json`, `xml`, `csv`.

  <Warning>
    If you choose `xml`, you must use the **POST** method. `GET` requests for XML will fail.
  </Warning>
</ParamField>

### Query parameters

<ParamField path="currency-pairs" type="string" optional>
  A JSON array of currency pair symbols to retrieve (e.g., `["EURUSD", "GBPUSD"]`). See the list of [available pairs](/docs/guides/available-currencies).
</ParamField>

### Response

<Warning>
  **Note on Precision**: Some currency pairs are returned with a [multiplier](/docs/http/metadata/multipliers) (e.g., 100 or 1000) to ensure high precision.
</Warning>

<ResponseField type="object">
  <ResponseField name="ask" type="string">
    The current ask price.
  </ResponseField>

  <ResponseField name="bid" type="string">
    The current bid price.
  </ResponseField>

  <ResponseField name="name" type="string">
    The currency pair symbol.
  </ResponseField>

  <ResponseField name="time" type="string">
    The Unix timestamp (epoch) of the rate.
  </ResponseField>
</ResponseField>

<ResponseExample>
  ```json JSON theme={null}
  [
    {
      "ask": "1.17714",
      "bid": "1.17680",
      "name": "EURUSD",
      "time": "1766956455.094"
    },
    {
      "ask": "1.35004",
      "bid": "1.34965",
      "name": "GBPUSD",
      "time": "1766956455.094"
    }
  ]
  ```

  ```xml XML theme={null}
  <result>
      <currency>
          <ask>1.17714</ask>
          <bid>1.17680</bid>
          <name>EURUSD</name>
          <time>1766955317.460</time>
      </currency>
      <currency>
          <ask>1.35004</ask>
          <bid>1.34965</bid>
          <name>GBPUSD</name>
          <time>1766955317.001</time>
      </currency>
  </result>
  ```

  ```csv CSV theme={null}
  ask,bid,name,time
  1.17714,1.17680,EURUSD,1766955317.000
  1.35004,1.34965,GBPUSD,1766955317.000
  ```
</ResponseExample>