Request For Quote

Endpoint: POST https://api.zamplabs.com/api/v1/transfer/rfq

This API will create a quote for payout

Request Body

Key	Value	Description	Optional
source_amount	Float	amount that will be deducted from the source account (only one of source or receiving amount is required, if sent both, source amount will be given priority)	Y
receiving_amount	Float	final amount that will be received by the recipient (only one of source or receiving amount is required, if sent both, source amount will be given priority)	Y
beneficiary_id	String	Beneficiary Id of the receipient	N
source_currency_code	String	source currency of the amount in String format (USD,USDC_ETH)	N
destination_currency_code	String	destination currency of the amount in String format (USD,USDC_ETH)	N
account_id	String	id of the account from which amount will be deducted	N

Request JSON Representation

{
    "account_id":"",
    "beneficiary_id": "iihr42_B9XkvSN47U9kW3UDZKVDcg_05_17",
    "source_amount": 20,
    "source_currency_code":"USD",
    "destination_currency_code":"USD",
    "receiving_amount": 
}

Response JSON Representation

Key	Value	Description
id	TestMerchant_xSbCCPqGtXWCDX2pmQLbKF_08_03	This is the UUID with which merchant can uniquely identify a RFQ on Zamp systems
corridor_id	String	The corridor Id of the desired corridor to send money to
source_amount	Float	The sending amount in float
exchange_rate	Float	The exchange rate for the corridor
receiving_amount	Float	The total amount the recipient will recieve
total_fees	Float	Transaction fees of the whole transaction
expired_at	GMT	The Requested Quote will expire after this time
source_currency_code	String	source currency of the amount in String format (USD,USDC_ETH)
destination_currency_code	String	destination currency of the amount in String format (USD,USDC_ETH)
total_fees_currency	String	currency code of the total fees in String format (USD,USDC_ETH)
converted_amount	Float	difference between the source amount and total fees

Response JSON Representation

{
    "data": {
        "id": "iihr42_HVLTQgQJTSahdqSmSXrHeF_06_02",
        "corridor_id": "iihr42_Vm6YbkiPJjuNySeoRdoBp8_05_17",
        "source_currency_code": "USD",
        "destination_currency_code": "USD",
        "source_amount": 20,
        "exchange_rate": 1,
        "receiving_amount": 19.5,
        "total_fees_currency": "USD",
        "total_fees": 0.5,
        "converted_amount": 19.5,
        "created_at": "2023-06-02T07:19:40.379579706Z",
        "updated_at": "2023-06-02T07:19:40.379579791Z",
        "expired_at": "2023-06-02T07:21:40.379579852Z"
    }
}

Error codes

HTTP Code	Error Response	Description
400	{"code":"INVALID_JSON","message":"Please check the request payload."}	The request body contains invalid JSON.
400	{ "code":"CORRIDOR_NOT_ACTIVE", "message":"Corridor Not Active"}	Source currency to destination corridor is not active. Contact Zamp team to enable this pair
404	{ "code":"RECORD_NOT_FOUND", "message":"Unable to find the record requested."}	Failed to find source account 2. Failed to find the beneficiary 3. Failed to find the corridor 4. Error getting merchant corridor configurations 5. Merchant not found
403	{"code":"ACCESS_FORBIDDEN","message":"You are not authorized to access this record."}	The Merchant is not allowed to access the requested resource (account).