Sign in

v1

latestOpenAPI 3.0.12026-07-2699111970.1 KB

Create Signature

Creates a new signature for signing messages or typed data.

API scope required: wallets:signatures.create

post/2025-06-09/wallets/{walletLocator}/signatures

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
  • twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
  • chainType[:<walletType>]:alias:<alias>

Headers

X-API-KEYstring required

API key required for authentication

x-idempotency-keystring

Unique key to prevent duplicate signature creation

Request body

OR
OR

Example request

{
  "params": {
    "signer": "external-wallet:0x1234567890123456789012345678901234567890"
  }
}

Response

The signature has been successfully created.

idstring required

Unique identifier for the signature

type'message' | 'typed-data' | 'auth-entries' required

The type of signature

chainType'evm' | 'solana' | 'aptos' | 'sui' | 'stellar' required

The blockchain type of the wallet

walletType'smart' | 'mpc' required

The wallet type (smart or mpc)

status'awaiting-approval' | 'pending' | 'failed' | 'success' required

Current status of the signature

{"stackTrail":"components:schemas:WalletsSignatureV2025ResponseDTO:properties:error","oasType":"schema","type":"unknown","description":"Error message if the signature fails"}
outputSignaturestring

The wallet's output signature of the request