Skip to main content

Wallets API Endpoints

Celar wallets are fully manageable through API calls. These endpoints allow PSPs to create wallets, view balances, track transactions, and deactivate wallets.

The dashboard can also be used to create and delete wallets too.

1. Create a Wallet​

Create a new celar wallet under your PSP organization.

curl --request POST \
  --url https://api.sandbox.celar.io/api/v1/psps/wallets \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "preferredName": "celar1",
  "chain": "polygon"
}'

Example Response​

{
  "message": "Wallet created successfully",
  "wallet": {
    "id": "cw_edf59f149ef0",
    "preferred_name": "celar1_polygon",
    "chain": "polygon",
    "address": "0xabAD28035be9DDB6703De46692cdE50cc786E8b7",
    "is_active": true,
    "created_at": "2025-09-26T14:59:58.999Z",
    "updated_at": "2025-09-26T14:59:58.999Z"
  }
}

2. Get All Wallets​

List all wallets owned by the PSP.

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/psps/wallets \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api_key>'

3. Get One Wallet​

Retrieve a single wallet by its ID. It will give you its details including its balance.

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/psps/wallets/id/<wallet_id> \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api_key>'

4. Get Total Balances​

Retrieve the total balances across all wallets under your PSP.

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/psps/wallets/total_balances \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api_key>'

5. Get Wallet Transactions​

Fetch the transaction history for a wallet. Supports filters such as limit and page.

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/psps/wallets/history/<wallet_id> \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api_key>'

6. Deactivate a Wallet​

Deactivate a wallet so it can no longer send or receive payments. ⚠️ Once deactivated, the wallet cannot be reactivated.

curl --request DELETE \
  --url https://api.sandbox.celar.io/api/v1/psps/wallets/id/<wallet_id> \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api_key>'

Example Response​

{
  "message": "Wallet deactivated successfully",
  "wallet": {
    "id": "cw_edf59f149ef0",
    "preferred_name": "celar1_polygon",
    "chain": "polygon",
    "address": "0xabAD28035be9DDB6703De46692cdE50cc786E8b7",
    "is_active": false,
    "created_at": "2025-09-26T14:59:58.999Z",
    "updated_at": "2025-09-26T15:18:33.846Z"
  }
}

Summary​

  • Create Wallets → per chain as needed.
  • View & Reconcile → via balances and history endpoints.
  • Deactivate Wallets → remove access when no longer required.