Payouts API

General Information

Create Payout

POST https://api.aquanow.io/accounts/v1/transaction

Generate a payout transaction.

Request Body

Name	Type	Description
address*	string	Address you wish to withdraw to
accountId*	string	e.g., CA1000012R Specify the accountId of the account you wish to make the transaction for
deliverCurrency*	string	Currency delivered by user to be traded.
deliverQuantity*	string	NOTE: Specify either deliverQuantity or receiveQuantity. Quantity of currency delivered by user.
receiveCurrency*	string	Currency you wish to withdraw
transactionType*	"PAYOUT"	must be payout
networkType	string	e.g., ETH Specify a networkType for symbols that support multiple networks. One of ETH, TRON,XLM, FTM, MATIC NOTE: Only applicable to USDT, USDC, MATIC, and FTM coins.
referenceId*	string	Reference Id for a saved counterparty. You must either: Create a counterparty beforehand and use the referenceId OR Provide a referenceId (unique) that you can attach your PII information to.
walletType*	"SELF_HOSTED" | "VASP" | "OTHER"	Required if using an address not part of the addressbook and the deliverCurrency is a cryptocurrency. The type of wallet being provided.
vaspId	uuid	Required IF walletType is "VASP". ID of the VASPs hosting the recipient’s wallet. You can either fetch the list of ids from our vasps endpoint, or specify "SELF_HOSTED" or UNKNOWN if not in the list. List of VASPs can be found in the section.
kycInfo*	object	PII Data required for KYC. This is required ONLY if you have provided a referenceId that is not already in the system.

200 : Success

{
    "orderId": "e324ca67-5eb1-47bd-aa11-6c3ba7e5afb8",
    "txId": "9d5955ff-6142-4ace-80da-3c860c1c4821",
    "transactionType": "PAYOUT",
    "status": "PROCESSING",
    "username": "woojpay",
    "accountId": "CA1001112C",
    "symbol": "USDT",
    "address": "0x279FEC0A6Dd30be27D88E837a1f8cC59bD2Bfc07",
    "deliverQuantity": 10,
    "receiveQuantity": 10.00171,
    "deliverCurrency": "USD",
    "receiveCurrency": "USDT",
    "networkFee": 0,
    "itemDateTime": 1740625055711,
    "referenceId": "clientid231",
    "networkType": "ETH",
    "quoteTime": 1740625055691,
    "expireTime": 1740625083691
}

400 Provide Wallet Host

Provide Reference

Execute Request

POST https://api.aquanow.io/trades/v1/executeQuote

Generate a bill under an invoice to get address

Request Body

Name	Type	Description
quoteId*	String	the orderId generated by the create payout endpoint above

200 Success

{
    "type": "rfqExecuteQuoteAck",
    "payload": {
        "accountId": "CA1001112C",
        "quoteId": "5ae24810-5f97-4a81-b15b-7ddf7b678f7a",
        "tradeDate": "2025-02-27",
        "valueDate": "2025-02-28"
    }
}

400 Quote Expired