Skip to main content
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"
}
'
{
  "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"
  }
}

​
Headers

​
authorization
string
required
Base64-encoded HMAC-SHA256 signature of the request payload using your API secretExample: "5e73d044c44d733fcf819ad3409aaa..."
​
x-timestamp
string
required
Example: "2025-03-15T09:45:53.000Z"
​
x-request-id
string
required
Example: "550e8400-e29b-41d4-a716-446655440000"
​
x-access-id
string
required
Example: "your-access-id-here"
​
Content-Type
string
required
Example: "application/json"

​
Body

​
fiatAmount
integer
required
Amount the customer will pay in fiatCurrency, in whole units (e.g. NGN — not kobo)Example: 50000
​
fiatCurrency
string
ISO 4217 fiat currency code. Defaults to NGNExample: "NGN"
​
targetCurrency
string
required
Symbol of the cryptocurrency to deliverExample: "USDT"
​
targetChain
string
required
Blockchain network to deliver the crypto on. Use a chain id from Fetch On-ramp Chains.Example: "tron"

​
Response

​
status
string
required
Example: "success"
​
message
string
required
Example: "Quote generated"
​
data
object
required

Authorizations

​
authorization
string
header
required

HMAC-SHA256 signature. Required headers: x-access-id, x-request-id (UUID), x-timestamp (ISO), authorization (HMAC signature)

Headers

​
authorization
string
required
​
x-timestamp
string<date-time>
required
​
x-request-id
string<uuid>
required
​
x-access-id
string
required
​
Content-Type
string
required

Body

application/json
​
fiatAmount
integer
required
Example:

50000

​
targetCurrency
string
required
Example:

"USDT"

​
targetChain
string
required
Example:

"tron"

​
fiatCurrency
string
default:NGN
Example:

"NGN"

Response

Quote generated successfully

​
status
string
​
message
string
​
data
object