---
title: "Add Gateway Wallet"
method: POST
path: "/accounts/gateway/add-wallet"
tags: ["Accounts"]
---

# Add Gateway Wallet

`POST /accounts/gateway/add-wallet`

Add an existing wallet to Gateway using its private key.
Gateway handles encryption and storage internally.

Args:
    wallet_credential: Wallet credentials (chain, private_key, and optional set_default)

Returns:
    Wallet information from Gateway including address

Raises:
    HTTPException: 503 if Gateway unavailable, 400 on validation error

## Request body

- GatewayWalletCredential — Credentials for adding an existing wallet to Gateway
  - `chain` string, required — Blockchain chain (e.g., 'solana', 'ethereum')
  - `private_key` string, required — Wallet private key
  - `set_default` boolean — Set as default wallet for this chain

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-08** `92703f48a69e` — 1 warning, 3 info
  - removed the request property `network`
  - added the new optional request property `set_default`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-18** `2ad95b6a84b2` — 1 breaking
  - the response's body type changed from `object` to no type for status `201`
- **2026-01-18** `576ec8539f76` — 1 breaking
  - the response's body type changed from no type to `object` for status `201`
- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/accounts/gateway/add-wallet/post.md)

---

[API](https://skmtc.dev/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.dev/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/5347fe79537f/schema)