Manage Crypto Addresses

Add, view, and remove your withdrawal addresses. If enabled, add, view, and remove source addresses so only funds originating from them are credited to your account.

Headers

All requests will require the following headers

Name	Type	Description
x-api-key*	String	{{x-api-key}} API Auth Key
x-signature*	String	Signature created using your API secret
x-nonce*	String	Timestamp in millisecond

Add Crypto Address

Add a crypto address to your address book. This endpoint is used for adding the client's withdrawal address.

If enabled for the feature, it can also be used to add a source address (the origin address from where the funds are coming from). When a source address is designated, only funds originating from that specific address will be credited to the client.

POST https://api.aquanow.io/users/v2/addressBook

Payload

Parmeter Name	Data Type	Required?	Description
currencyType	string	required	Must be “crypto”; specifies that this is a crypto address entry.
currency	string	optional	Crypto currency (e.g. “BTC”). If omitted, the address applies to all currencies supported on the specified network;
networkSymbol	string	required	Network identifier for the address
address	string	required	Destination/source address string.
addressTagMemo	string	optional	Tag/memo if supported by the network (e.g., destination tag for XRP, memo for XLM).
externalReferenceId	string	optional	Client-defined reference/alias for the saved address.
acceptTerms	boolean	required	Must be true; confirms legal and beneficial ownership/control.
addressType	array	required	Array of values: "sourceAddress", "withdrawalAddress". Indicates usage for incoming funds, withdrawals, or both.
walletType	string	required	One of: “SELF_HOSTED”, “VASP”, “OTHER_VASP”. Where the wallet is hosted.
vaspId	string	conditional	Required if walletType = “VASP”. A valid vaspId can be retrieved from https://docs.aquanow.io/pay/api-endpoints/wallet-types-api
vaspName	string	conditional	Required if walletType = “OTHER_VASP”.
vaspWebsite	string	optional	Optional when walletType = “OTHER_VASP”.

Example

{
    "currencyType": "crypto",
    "networkSymbol": "SOL",
    "address": "DqCRL4hv2NRpcFrrGQop75L7Jm8AdVJAggQRiGPzaTWi",
    "acceptTerms": true,
    "addressType": [
        "sourceAddress",
        "withdrawalAddress"
    ],
    "walletType": "VASP",
    "vaspId": "0cadf55b-c1c4-44d9-a6cc-92eaac292d4c"
}

Response

200: OK

{
    "currency": "ALL",
    "networkSymbol": "SOL",
    "currencyType": "crypto",
    "externalReferenceId": null,
    "addressBookId": "243a527b-bedd-429a-8c24-ab5618ffc137",
    "addressType": [
        "SOURCE",
        "WITHDRAWAL"
    ],
    "status": "ACTIVE"
}

401: Unauthorized

404: Bad Request

Delete Crypto Address

Delete a crypto address using the addressBookId

DELETE https://api.aquanow.io/users/v2/addressBook/{id}

Path Parameters

Name	Type	Description
id*	String	Unique identifier of the crypto address to delete

Response

200: OK

{
    "addressBookId": "243a527b-bedd-429a-8c24-ab5618ffc137",
    "status": "INACTIVE",
    "updatedAt": "2025-11-20T18:46:34.886Z"
}

404: Not found

401: Unauthorized

Get Crypto Addresses

Fetch a list of all addresses matching the query parameters. If currencyType is not specified, it will fetch Bank Instructions and Crypto Addresses.

Query Parameters

Parameter Name	Data Type	Required?
currencyType	string	optional
currency	string	optional
network	string	optional
address	string	optional
addressTagMemo	string	optional
addressType	string	optional
externalReferenceId	string	optional
addressBookId	string	optional

Examples

Filter by the unique identifier addressBookId

GET https://api.aquanow.io/users/v2/addressBook??addressBookId={addressBookId}

Response

200: OK

{
    "data": [
        {
            "addressBookId": "243a527b-bedd-429a-8c24-ab5618ffc137",
            "currency": "ALL",
            "networkSymbol": "SOL",
            "currencyType": "crypto",
            "address": "DqCRL4hv2NRpcFrrGQop75L7Jm8AdVJAggQRiGPzaTWi",
            "addressType": [
                "sourceAddress",
                "withdrawalAddress"
            ],
            "walletType": "VASP",
            "status": "ACTIVE",
            "vaspId": "0cadf55b-c1c4-44d9-a6cc-92eaac292d4c"
        }
    ]
}

404: Not found

401: Unauthorized

Filter by addressType

GET https://api.aquanow.io/users/v2/addressBook?addressType=sourceAddress

200: OK

{
    "data": [
        {
            "addressBookId": "9c940443-9f86-45d1-bb76-0d411223b2a1",
            "currency": "ETH",
            "networkSymbol": "ETH",
            "currencyType": "crypto",
            "address": "0x00b8FE32107A15189eeFc9979D42B4aD5E2b4B31",
            "addressType": [
                "sourceAddress",
                "withdrawalAddress"
            ],
            "walletType": "SELF_HOSTED",
            "status": "ACTIVE"
        },
        {
            "addressBookId": "b6c64620-92be-4820-bb19-d31f41d56e68",
            "status": "PENDING",
            "currencyType": "fiat",
            "externalReferenceId": "INV-2025-1001",
            "currency": "USD",
            "beneficiaryType": "BUSINESS",
            "beneficiaryLegalName": "JULIEHUANG",
            "beneficiaryAddress": {
                "addressLine1": "123 Main St",
                "city": "New York",
                "region": "NY",
                "postalCode": "10001",
                "country": "US"
            },
            "beneficiaryBankName": "RBC",
            "beneficiaryBankAddress": {
                "addressLine1": "270 Park Ave",
                "city": "New York",
                "region": "NY",
                "postalCode": "10017",
                "country": "US"
            },
            "beneficiaryBankBic": "CHASUS33XXX",
            "routingCode": "026009593",
            "beneficiaryAccountNumber": "000123456789",
            "beneficiaryBankMemo": "Reference: AQN-123456",
            "intermediaryBankName": "The Bank of New York Mellon",
            "intermediaryBankAddress": {
                "addressLine1": "240 Greenwich St",
                "city": "New York",
                "region": "NY",
                "postalCode": "10286",
                "country": "US"
            },
            "intermediaryBankBic": "IRVTUS3NXXX",
            "intermediaryAccountNumber": "109876543210"
        }
    ]
}

400: Bad Request

401: Unauthorized

Filter by multiple query search parameters

GET https://api.aquanow.io/users/v2/addressBook?addressType=sourceAddress&currency=ALL&networkSymbol=SOL

200: OK

{
    "data": [
        {
            "addressBookId": "243a527b-bedd-429a-8c24-ab5618ffc137",
            "currency": "ALL",
            "networkSymbol": "SOL",
            "currencyType": "crypto",
            "address": "DqCRL4hv2NRpcFrrGQop75L7Jm8AdVJAggQRiGPzaTWi",
            "addressType": [
                "sourceAddress",
                "withdrawalAddress"
            ],
            "walletType": "VASP",
            "status": "ACTIVE",
            "vaspId": "0cadf55b-c1c4-44d9-a6cc-92eaac292d4c"
        }
    ]
}

400: Bad Request

401: Unauthorized

Note: When querying by currency , it will also return addresses that support all currencies in that network. Some addresses returned will have currency: ALL For example: GET https://api.aquanow.io/users/v2/addressBook?addressType=sourceAddress&currency=ETH

{
    "data": [
        {
            "addressBookId": "29faf516-fa65-41aa-82f4-e27ad5972307",
            "currency": "ALL",
            "networkSymbol": "ETH",
            "currencyType": "crypto",
            "address": "0xad202e2ce23ede54162ef08a991a9bda873c181a",
            "addressType": [
                "sourceAddress",
                "withdrawalAddress"
            ],
            "walletType": "VASP",
            "status": "ACTIVE",
            "vaspId": "0cadf55b-c1c4-44d9-a6cc-92eaac292d4c"
        },
        {
            "addressBookId": "9c940443-9f86-45d1-bb76-0d411223b2a1",
            "currency": "ETH",
            "networkSymbol": "ETH",
            "currencyType": "crypto",
            "address": "0x00b8FE32107A15189eeFc9979D42B4aD5E2b4B31",
            "addressType": [
                "sourceAddress",
                "withdrawalAddress"
            ],
            "walletType": "SELF_HOSTED",
            "status": "ACTIVE"
        }
    ]
}