Skip to main content
POST
/
v2
/
evm
/
accounts
/
{address}
/
eip7702
/
delegation
Create EIP-7702 delegation
curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/evm/accounts/{address}/eip7702/delegation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Wallet-Auth: <x-wallet-auth>' \
  --data '
{
  "network": "base",
  "enableSpendPermissions": true
}
'
{
  "delegationOperationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

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 string 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: 1 - 128

Path Parameters

address
string
required

The 0x-prefixed address of the EVM account to delegate.

Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

Body

application/json
network
enum<string>
required

The network for the EIP-7702 delegation.

Available options:
base-sepolia,
base,
arbitrum,
optimism,
polygon,
ethereum,
ethereum-sepolia
Example:

"base"

enableSpendPermissions
boolean
default:false

Whether to configure spend permissions for the upgraded, delegated account. When enabled, the account can grant permissions for third parties to spend on its behalf.

Example:

true

Response

Delegation operation created successfully.

delegationOperationId
string<uuid>
required

The unique identifier for the delegation operation. Use this to poll the operation status.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"