Sign EIP-712 typed data

Signs EIP-712 typed data with the given EVM account.

Authorizations

Authorization · string · header · required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Headers

X-Wallet-Auth · string · required

A JWT signed using your Wallet Secret, encoded in base64. Refer to the Generate Wallet Token section of our Authentication docs for more details on how to generate your Wallet Token.

X-Idempotency-Key · string

An optional UUID v4 request header for making requests safely retryable. When included, duplicate requests with the same key will return identical responses. Refer to our Idempotency docs for more information on using idempotency keys.

Required string length: 36

Path Parameters

address · string · required

The 0x-prefixed address of the EVM account.

Body

application/json

The message to sign using EIP-712.

domain · object · required

The domain of the EIP-712 typed data.

Show child attributes

Example:

{
  "name": "Permit2",
  "chainId": 1,
  "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
}

types · object · required

A mapping of struct names to an array of type objects (name + type). Each key corresponds to a type name (e.g., "EIP712Domain", "PermitTransferFrom").

Example:

{
  "EIP712Domain": [
    { "name": "name", "type": "string" },
    { "name": "chainId", "type": "uint256" },
    {
      "name": "verifyingContract",
      "type": "address"
    }
  ],
  "PermitTransferFrom": [
    {
      "name": "permitted",
      "type": "TokenPermissions"
    },
    { "name": "spender", "type": "address" },
    { "name": "nonce", "type": "uint256" },
    { "name": "deadline", "type": "uint256" }
  ],
  "TokenPermissions": [
    { "name": "token", "type": "address" },
    { "name": "amount", "type": "uint256" }
  ]
}

primaryType · string · required

The primary type of the message. This is the name of the struct in the types object that is the root of the message.

Example:

"PermitTransferFrom"

message · object · required

The message to sign. The structure of this message must match the primaryType struct in the types object.

Example:

{
  "permitted": {
    "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amount": "1000000"
  },
  "spender": "0x1111111254EEB25477B68fb85Ed929f73A960582",
  "nonce": "0",
  "deadline": "1716239020"
}

Response

200

application/json

Successfully signed typed data.

signature · string · required

The signature of the typed data, as a 0x-prefixed hex string.

Example:

"0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"