1. Wallets
Artha All Module Api's
  • Introduction
  • Authentication
  • KYC/KYB Requirements
  • API Setup Guide
  • Products
    • List Products
      GET
    • Get Product
      GET
    • Get Customer Product Status
      GET
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Submit Applicant (KYC/KYB)
      POST
    • Create Onboarding Session
      POST
  • Wallets
    • Beneficiary
      • Create Crypto Beneficiary
      • Update Crypto Beneficiary
      • List Crypto Withdraw Beneficiaries
    • Create Wallet
      POST
    • Get Wallet Address
      GET
    • Get Customer Balances
      GET
    • List Wallets
      GET
    • List Withdrawals
      GET
    • List Withdrawal Networks
      GET
    • Preview Withdrawal Summary
      POST
    • Create Crypto Withdrawal
      POST
  • Cards
    • Issuance
      • Issue Card
      • List Cards
      • List Customer Cards
      • Get Card Details
      • Get Sensitive Card Details
    • Funding
      • Top Up Card
      • Get Card Balance
      • Get Top-Up Status
      • List Top-Up History
    • Operations
      • Resend Activation Code
      • Activate Card
      • Set Card PIN
      • Change Card PIN
      • Update Card Limits
      • Freeze Card
      • Unfreeze Card
      • Replace Card
      • Cancel Card
      • Get Card Limits
      • Show Card PIN Details
      • Get PIN View Iframe URL
      • Get PIN Change Iframe URL
      • Get PIN Set Iframe URL
      • Get Card View Iframe URL
      • Show Card PIN
  • Payees
    • Create a payee for a customer.
      POST
    • List a customer's payees.
      GET
    • Update a payee.
      PUT
    • Retrieve a payee by id.
      GET
    • Look up an existing payee.
      GET
    • List the currencies a payee can be created in.
      GET
    • List the accepted payment purpose codes for a payee.
      GET
    • List the countries a payee can be created in.
      GET
    • List currency/country pairings for payees.
      GET
    • List the accepted beneficiary relationship codes.
      GET
  • Payments
    • Onboarding
      • List the customer's payout-currency configuration sections.
      • Enable a payout-currency section for the customer.
      • Get the customer's terms-of-service acceptance status.
      • Enable or disable a payout-currency section.
    • Quote
      • List the currencies a beneficiary can be paid in under a product.
      • List the payout rails available for a product and beneficiary.
      • Create an FX quote giving the rate and fee for a cross-currency payout.
    • Order
      • Submit a payout order to send money to a beneficiary.
      • Retrieve the on-chain address to fund an order.
      • Retrieve the status and settlement detail of a payout order.
    • Lookups
      • List the accepted payment purpose codes for a payout.
      • List the accepted source-of-funds codes for a payout.
      • List the document types accepted on a payout order.
  • Banks
    • Accounts
      • Create Bank Account
      • Get Account Details
      • Get Account Issuance Status
    • Withdraw
      • Create Withdrawal Quote
      • List Withdrawal Purposes
      • Get Payment Schemes
      • Execute Withdrawal
  • Exchange
    • Quote
      • Get Exchange Rate
      • Create Price Quote
    • Order
      • Place Exchange Order
  • Transactions
    • List Transactions
    • Get Transaction Details
  • Utilities
    • List Currencies
    • List Countries
    • Get Fee Schedule
    • List Product Occupations
    • List Product Industry Codes
    • Upload File
  • Webhook's
    • Wallets Webhooks
    • Banks Webhooks
    • Payments Webhooks
    • Exchange Webhooks
    • Card Webhooks
  1. Wallets

Get Wallet Address

GET
/api/v1/wallets/{WalletId}/address
Retrieves the on-chain deposit address details for a specific wallet. Share this address with the customer for deposits. Only send assets matching the wallet's currency and network to this address — deposits on the wrong network may be lost.
Prerequisites
The wallet must already exist (created via POST /api/v1/wallets/createWallet).
Path Parameters
FieldTypeDescription
WalletIdstring (uuid)Wallet identifier
Query Parameters
FieldTypeDescription
customerIdstring (uuid)Unique identifier of the customer who owns this wallet — required. Must match the wallet's actual owner; if WalletId exists but belongs to a different customer, the response returns an empty result rather than another customer's wallet data.
Response Fields
data is an array of wallet entries (one per currency sharing the wallet's on-chain address):
FieldTypeDescription
data[].walletCodestringCurrency ticker of the wallet (e.g. USDT)
data[].networkstringBlockchain network (e.g. TRC-20)
data[].walletAddressstringOn-chain deposit address
requestIdstringUnique identifier of this API request
timestampstring (date-time)Server timestamp of the response (UTC)

Request

Authorization
or
Path Params

Query Params

Header Params

Responses

🟢200
application/json
OK.
Bodyapplication/json

🟠401
🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/wallets//address?CustomerId=' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'
Response Response Example
{
  "data": [
    { "walletCode": "USDT", "network": "TRC-20", "walletAddress": "TWFgpZGWq85xkGmUS8guHsuXQhkCqedfsj" }
  ],
  "requestId": "b71e0c94aa2d4c37b60d9e5f1a83c246",
  "timestamp": "2026-08-21T09:47:55.6620117Z"
}
Modified at 2026-08-22 09:33:58
Previous
Create Wallet
Next
Get Customer Balances
Built with