Skip to main content
POST
Get On-ramp Quote
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

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

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

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