---
title: "Sign Message"
method: POST
path: "/v1/wallets/sign-message"
tags: ["Wallets"]
---

# Sign Message

`POST /v1/wallets/sign-message`

Signs an arbitrary message using the specified wallet. This endpoint supports both text and hexadecimal message formats. The signing is performed using thirdweb Engine with smart wallet support for gasless transactions.

**Authentication**: This endpoint requires project authentication and wallet authentication. For backend usage, use `x-secret-key` header. For frontend usage, use `x-client-id` + `Authorization: Bearer <jwt>` headers.

## Request body

- object — Request body for signing a message
  - `from` string, required — The wallet address or ENS name that will sign the message.
  - `chainId` integer, required — The blockchain network identifier where the signing will occur. Common values include: 1 (Ethereum), 137 (Polygon), 56 (BSC).
  - `message` string, required — The message to be signed. Can be plain text or hexadecimal format (starting with 0x). The format is automatically detected.

## Response `200`

Message signed successfully. Returns the cryptographic signature that can be used for verification.

- object
  - `result` object, required
    - `signature` string, required — The cryptographic signature in hexadecimal format. This can be used for verification and authentication purposes.

## Other responses

- `400` — Invalid request parameters. This occurs when the wallet address format is invalid, chainId is not supported, or the message format is incorrect.
- `401` — Authentication required. For backend usage, include `x-secret-key` header. For frontend usage, include `x-client-id` + `Authorization: Bearer <jwt>` headers.
- `500` — Internal server error. This may occur due to wallet connectivity issues, signing service unavailability, or unexpected server errors.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)
