---
title: "Link Wallet"
method: POST
path: "/api/v1/auth/wallet/link"
tags: ["Auth - Wallet"]
---

# Link Wallet

`POST /api/v1/auth/wallet/link`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.mor.org/oauth2/authorize`
    - Token URL: `https://auth.mor.org/oauth2/token` scopes: `aws.cognito.signin.user.admin`, `openid`, `email`, `profile`
  - HTTP bearer

Link a Web3 wallet to the authenticated user's account.

**Requirements:**
- Valid signature proving wallet ownership (EIP-191 personal_sign)
- Wallet not already linked to any other account
- Valid, unexpired nonce from POST /wallet/nonce

**Note:** Users can link multiple wallets to their account.
Each wallet can only be linked to ONE account in the entire system.

## Request body

- WalletLinkRequest: Request to link a Web3 wallet to the user's account.
  - `wallet_address` string, required: Ethereum wallet address (0x prefixed, 40 hex characters)
  - `signature` string, required: EIP-191 signature of the message (0x prefixed hex string)
  - `message` string, required: The exact message that was signed
  - `nonce` string, required: The nonce received from POST /wallet/nonce
  - `timestamp` string, required: ISO 8601 timestamp when the message was constructed

## Response `201`

Successful Response

- WalletLinkResponse: Response after successfully linking a wallet.
  - `id` integer, required: Wallet link ID
  - `wallet_address` string, required: The linked wallet address (checksummed)
  - `staked_amount` string: Staked MOR amount in wei (as string for precision)
  - `linked_at` string, date-time, required: Timestamp when the wallet was linked
  - `updated_at` string, date-time, required: Timestamp when the wallet was last updated

## Other responses

- `422`: Validation Error

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/auth/wallet/link/post.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)