> ## 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.

# Request Inverse FX Quote

> Specify the exact target NGN amount to receive and calculate the required source currency debit.

Calculates the exact foreign currency debit needed to deliver a target Nigerian Naira (NGN) payout.

### Scopes required

`fx:write` or `*`

### Headers

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

### Body

<ParamField body="sourceCurrency" type="string" required>
  The source foreign currency being debited (`USD`, `GBP`, `EUR`).
</ParamField>

<ParamField body="targetNgnAmount" type="number" required>
  Exact target amount in NGN major units to be received.
</ParamField>

### Response

<ResponseField name="quoteId" type="string">
  Unique quote identifier.
</ResponseField>

<ResponseField name="currency" type="string">
  Source foreign currency code.
</ResponseField>

<ResponseField name="direction" type="string">
  Quote direction (`FOREIGN_TO_NGN`).
</ResponseField>

<ResponseField name="foreignAmountMinor" type="string">
  Net foreign currency amount needed in minor units.
</ResponseField>

<ResponseField name="rate" type="number">
  Locked buy exchange rate.
</ResponseField>

<ResponseField name="transferFeeMinor" type="string">
  Corridor transfer fee converted to foreign currency minor units.
</ResponseField>

<ResponseField name="ngnAmountMinor" type="string">
  Target NGN amount in minor units.
</ResponseField>

<ResponseField name="totalDebitMinor" type="string">
  Total foreign currency amount required to debit in minor units.
</ResponseField>

<ResponseField name="expiresAt" type="string">
  ISO expiration timestamp.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.tabsglobal.co/v1/fx/quotes/inverse" \
    -H "Authorization: Bearer sk_live_..." \
    -H "Content-Type: application/json" \
    -d '{
      "sourceCurrency": "USD",
      "targetNgnAmount": 5000000
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.tabsglobal.co/v1/fx/quotes/inverse", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      sourceCurrency: "USD",
      targetNgnAmount: 5000000,
    }),
  });

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

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

  response = requests.post(
      "https://api.tabsglobal.co/v1/fx/quotes/inverse",
      headers={
          "Authorization": f"Bearer {API_KEY}",
          "Content-Type": "application/json",
      },
      json={"sourceCurrency": "USD", "targetNgnAmount": 5000000},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "quoteId": "quote_1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "currency": "USD",
    "direction": "FOREIGN_TO_NGN",
    "foreignAmountMinor": "307598",
    "rate": 1625.50,
    "transferFeeMinor": "154",
    "ngnAmountMinor": "500000000",
    "totalDebitMinor": "307752",
    "expiresAt": "2026-09-21T03:00:00.000Z"
  }
  ```
</ResponseExample>


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