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

# Get Live FX Rates

> Retrieve real-time foreign exchange buy and sell market rates across supported currency corridors.

Fetches current real-time exchange rates with merchant markups across supported payout currencies (`USD`, `GBP`, `EUR`).

### Scopes required

`fx:read` or `*`

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer API secret key formatted as `Bearer sk_live_...` or `Bearer sk_test_...`.
</ParamField>

### Response

<ResponseField name="rates" type="object">
  Map of currency codes (`USD`, `GBP`, `EUR`) to their buy, sell rates and fixed rail fees.

  <Expandable title="Rate object properties">
    <ResponseField name="buy" type="number">
      Customer buy rate (inbound conversion rate to NGN).
    </ResponseField>

    <ResponseField name="sell" type="number">
      Customer sell rate (outbound conversion rate from NGN).
    </ResponseField>

    <ResponseField name="fixedFee" type="number">
      Fixed corridor transfer fee in NGN major units.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tabsglobal.co/v1/fx/rates" \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.tabsglobal.co/v1/fx/rates", {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
    },
  });

  const rates = await response.json();
  console.log(rates);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tabsglobal.co/v1/fx/rates",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "USD": {
      "buy": 1610.50,
      "sell": 1635.00,
      "fixedFee": 2500
    },
    "GBP": {
      "buy": 2130.00,
      "sell": 2165.50,
      "fixedFee": 2500
    },
    "EUR": {
      "buy": 1765.20,
      "sell": 1795.00,
      "fixedFee": 2500
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.