curl -X POST "https://api.tabsglobal.co/v1/fx/quotes/forward" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"sourceCurrency": "USD",
"sourceDebitAmount": 5000
}'
const response = await fetch("https://api.tabsglobal.co/v1/fx/quotes/forward", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
sourceCurrency: "USD",
sourceDebitAmount: 5000,
}),
});
const quote = await response.json();
console.log(quote);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/fx/quotes/forward",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"sourceCurrency": "USD", "sourceDebitAmount": 5000},
)
print(response.json())
{
"quoteId": "quote_4f1e9b2a-7c3d-4e5f-8a1b-9d0c2e3f4a5b",
"currency": "USD",
"direction": "FOREIGN_TO_NGN",
"foreignAmountMinor": "498462",
"rate": 1625.50,
"transferFeeMinor": "1538",
"ngnAmountMinor": "810250000",
"totalDebitMinor": "500000",
"expiresAt": "2026-09-21T03:00:00.000Z"
}
Foreign Exchange (FX) API
Request Forward FX Quote
Specify the exact foreign source wallet amount to debit and calculate the resulting converted NGN amount.
POST
/
v1
/
fx
/
quotes
/
forward
curl -X POST "https://api.tabsglobal.co/v1/fx/quotes/forward" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"sourceCurrency": "USD",
"sourceDebitAmount": 5000
}'
const response = await fetch("https://api.tabsglobal.co/v1/fx/quotes/forward", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
sourceCurrency: "USD",
sourceDebitAmount: 5000,
}),
});
const quote = await response.json();
console.log(quote);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/fx/quotes/forward",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"sourceCurrency": "USD", "sourceDebitAmount": 5000},
)
print(response.json())
{
"quoteId": "quote_4f1e9b2a-7c3d-4e5f-8a1b-9d0c2e3f4a5b",
"currency": "USD",
"direction": "FOREIGN_TO_NGN",
"foreignAmountMinor": "498462",
"rate": 1625.50,
"transferFeeMinor": "1538",
"ngnAmountMinor": "810250000",
"totalDebitMinor": "500000",
"expiresAt": "2026-09-21T03:00:00.000Z"
}
Calculates the recipient NGN settlement amount based on the exact amount debited from a foreign currency wallet (
USD, GBP, EUR).
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 spent (
USD, GBP, EUR).number
required
Exact amount in major units to debit from the source wallet (e.g.
5000 for 5,000 USD).Response
string
Unique quote identifier.
string
Source currency code.
string
Quote direction (
FOREIGN_TO_NGN).string
Net foreign amount converted after subtracting corridor fees.
number
Locked buy exchange rate.
string
Corridor transfer fee converted to foreign currency minor units.
string
Calculated NGN amount credited to recipient in minor units.
string
Total foreign currency amount debited in minor units.
string
ISO expiration timestamp.
curl -X POST "https://api.tabsglobal.co/v1/fx/quotes/forward" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"sourceCurrency": "USD",
"sourceDebitAmount": 5000
}'
const response = await fetch("https://api.tabsglobal.co/v1/fx/quotes/forward", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
sourceCurrency: "USD",
sourceDebitAmount: 5000,
}),
});
const quote = await response.json();
console.log(quote);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/fx/quotes/forward",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"sourceCurrency": "USD", "sourceDebitAmount": 5000},
)
print(response.json())
{
"quoteId": "quote_4f1e9b2a-7c3d-4e5f-8a1b-9d0c2e3f4a5b",
"currency": "USD",
"direction": "FOREIGN_TO_NGN",
"foreignAmountMinor": "498462",
"rate": 1625.50,
"transferFeeMinor": "1538",
"ngnAmountMinor": "810250000",
"totalDebitMinor": "500000",
"expiresAt": "2026-09-21T03:00:00.000Z"
}