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
}'
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);
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())
{
"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"
}
Foreign Exchange (FX) API
Request Inverse FX Quote
Specify the exact target NGN amount to receive and calculate the required source currency debit.
POST
/
v1
/
fx
/
quotes
/
inverse
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
}'
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);
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())
{
"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"
}
Calculates the exact foreign currency debit needed to deliver a target Nigerian Naira (NGN) payout.
Scopes required
fx:write or *
Headers
string
required
Bearer API secret key formatted as
Bearer sk_live_... or Bearer sk_test_....Body
string
required
The source foreign currency being debited (
USD, GBP, EUR).number
required
Exact target amount in NGN major units to be received.
Response
string
Unique quote identifier.
string
Source foreign currency code.
string
Quote direction (
FOREIGN_TO_NGN).string
Net foreign currency amount needed in minor units.
number
Locked buy exchange rate.
string
Corridor transfer fee converted to foreign currency minor units.
string
Target NGN amount in minor units.
string
Total foreign currency amount required to debit in minor units.
string
ISO expiration timestamp.
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
}'
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);
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())
{
"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"
}