Get On-ramp Quote
curl --request POST \
--url https://secureapi.tender.cash/v1/api/onramp/quote \
--header 'Content-Type: <content-type>' \
--header 'authorization: <api-key>' \
--header 'x-access-id: <x-access-id>' \
--header 'x-request-id: <x-request-id>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"fiatCurrency": "NGN",
"fiatAmount": 50000,
"targetCurrency": "USDT",
"targetChain": "tron"
}
'const options = {
method: 'POST',
headers: {
authorization: '<api-key>',
'x-timestamp': '<x-timestamp>',
'x-request-id': '<x-request-id>',
'x-access-id': '<x-access-id>',
'Content-Type': '<content-type>'
},
body: JSON.stringify({
fiatCurrency: 'NGN',
fiatAmount: 50000,
targetCurrency: 'USDT',
targetChain: 'tron'
})
};
fetch('https://secureapi.tender.cash/v1/api/onramp/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://secureapi.tender.cash/v1/api/onramp/quote"
payload = {
"fiatCurrency": "NGN",
"fiatAmount": 50000,
"targetCurrency": "USDT",
"targetChain": "tron"
}
headers = {
"authorization": "<api-key>",
"x-timestamp": "<x-timestamp>",
"x-request-id": "<x-request-id>",
"x-access-id": "<x-access-id>",
"Content-Type": "<content-type>"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://secureapi.tender.cash/v1/api/onramp/quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'fiatCurrency' => 'NGN',
'fiatAmount' => 50000,
'targetCurrency' => 'USDT',
'targetChain' => 'tron'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: <content-type>",
"authorization: <api-key>",
"x-access-id: <x-access-id>",
"x-request-id: <x-request-id>",
"x-timestamp: <x-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": "success",
"message": "Quote generated",
"data": {
"quoteId": "b7f2a1c3-9d4e-4b2f-a8c0-1e2d3f4a5b6c",
"fiatCurrency": "NGN",
"fiatAmount": 50000,
"targetCurrency": "USDT",
"targetChain": "tron",
"swapCurrency": "usdt",
"swapChain": "tron",
"rate": 0.000597,
"estimatedCryptoAmount": "29.850000",
"expiresAt": "2025-06-10T10:05:00.000Z"
}
}On-ramp
Get On-ramp Quote
Fetch a live exchange rate estimate before initiating an on-ramp
POST
/
v1
/
api
/
onramp
/
quote
Get On-ramp Quote
curl --request POST \
--url https://secureapi.tender.cash/v1/api/onramp/quote \
--header 'Content-Type: <content-type>' \
--header 'authorization: <api-key>' \
--header 'x-access-id: <x-access-id>' \
--header 'x-request-id: <x-request-id>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"fiatCurrency": "NGN",
"fiatAmount": 50000,
"targetCurrency": "USDT",
"targetChain": "tron"
}
'const options = {
method: 'POST',
headers: {
authorization: '<api-key>',
'x-timestamp': '<x-timestamp>',
'x-request-id': '<x-request-id>',
'x-access-id': '<x-access-id>',
'Content-Type': '<content-type>'
},
body: JSON.stringify({
fiatCurrency: 'NGN',
fiatAmount: 50000,
targetCurrency: 'USDT',
targetChain: 'tron'
})
};
fetch('https://secureapi.tender.cash/v1/api/onramp/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://secureapi.tender.cash/v1/api/onramp/quote"
payload = {
"fiatCurrency": "NGN",
"fiatAmount": 50000,
"targetCurrency": "USDT",
"targetChain": "tron"
}
headers = {
"authorization": "<api-key>",
"x-timestamp": "<x-timestamp>",
"x-request-id": "<x-request-id>",
"x-access-id": "<x-access-id>",
"Content-Type": "<content-type>"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://secureapi.tender.cash/v1/api/onramp/quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'fiatCurrency' => 'NGN',
'fiatAmount' => 50000,
'targetCurrency' => 'USDT',
'targetChain' => 'tron'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: <content-type>",
"authorization: <api-key>",
"x-access-id: <x-access-id>",
"x-request-id: <x-request-id>",
"x-timestamp: <x-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": "success",
"message": "Quote generated",
"data": {
"quoteId": "b7f2a1c3-9d4e-4b2f-a8c0-1e2d3f4a5b6c",
"fiatCurrency": "NGN",
"fiatAmount": 50000,
"targetCurrency": "USDT",
"targetChain": "tron",
"swapCurrency": "usdt",
"swapChain": "tron",
"rate": 0.000597,
"estimatedCryptoAmount": "29.850000",
"expiresAt": "2025-06-10T10:05:00.000Z"
}
}Auth method: Signed (HMAC) — this endpoint requires the full set of signed
headers:
x-access-id, x-request-id, x-timestamp, and an HMAC-SHA256
authorization signature. See Authentication.Headers
string
required
Base64-encoded HMAC-SHA256 signature of the request payload using your API secretExample:
"5e73d044c44d733fcf819ad3409aaa..."string
required
Example:
"2025-03-15T09:45:53.000Z"string
required
Example:
"550e8400-e29b-41d4-a716-446655440000"string
required
Example:
"your-access-id-here"string
required
Example:
"application/json"Body
integer
required
Amount the customer will pay in
fiatCurrency, in whole units (e.g. NGN — not kobo)Example: 50000string
ISO 4217 fiat currency code. Defaults to
NGNExample: "NGN"string
required
Symbol of the cryptocurrency to deliverExample:
"USDT"string
required
Blockchain network to deliver the crypto on. Use a chain
id from
Fetch On-ramp Chains.Example: "tron"Response
string
required
Example:
"success"string
required
Example:
"Quote generated"object
required
Show data properties
Show data properties
string
UUID that identifies this quote. Pass this to Initiate On-ramp.Example:
"b7f2a1c3-9d4e-4b2f-a8c0-1e2d3f4a5b6c"string
Example:
"NGN"number
Example:
50000string
Example:
"USDT"string
Example:
"tron"string
Intermediate currency used during the swap leg (for informational purposes)Example:
"usdt"string
Intermediate chain used during the swap legExample:
"tron"number
Exchange rate: how many
swapCurrency units per 1 fiatCurrencyExample: 0.000597string
Estimated amount of
targetCurrency the customer will receive, based on fiatAmount × rateExample: "29.850000"string
ISO 8601 timestamp after which this quote is no longer valid. Initiate before this time.Example:
"2025-06-10T10:05:00.000Z"Authorizations
Signed (HMAC) authentication. Required headers: x-access-id, x-request-id (UUID v4), x-timestamp (ISO 8601), and authorization (Base64 HMAC-SHA256 signature of {timeStamp, requestId, accessId} using your access secret).
Headers
Body
application/json