Sign transaction via end user EVM account

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "transaction": "0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080",
  "walletSecretId": "e051beeb-7163-4527-a5b6-35e301529ff2"
}
'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction"

payload = {
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "transaction": "0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080",
    "walletSecretId": "e051beeb-7163-4527-a5b6-35e301529ff2"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    transaction: '0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080',
    walletSecretId: 'e051beeb-7163-4527-a5b6-35e301529ff2'
  })
};

fetch('https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'address' => '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    'transaction' => '0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080',
    'walletSecretId' => 'e051beeb-7163-4527-a5b6-35e301529ff2'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction"

	payload := strings.NewReader("{\n  \"address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"transaction\": \"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080\",\n  \"walletSecretId\": \"e051beeb-7163-4527-a5b6-35e301529ff2\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"transaction\": \"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080\",\n  \"walletSecretId\": \"e051beeb-7163-4527-a5b6-35e301529ff2\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"transaction\": \"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080\",\n  \"walletSecretId\": \"e051beeb-7163-4527-a5b6-35e301529ff2\"\n}"

response = http.request(request)
puts response.read_body

{
  "signedTransaction": "0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"
}

POST

embedded-wallet-api

end-users

{userId}

evm

sign

transaction

Sign transaction via end user EVM account

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "transaction": "0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080",
  "walletSecretId": "e051beeb-7163-4527-a5b6-35e301529ff2"
}
'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction"

payload = {
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "transaction": "0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080",
    "walletSecretId": "e051beeb-7163-4527-a5b6-35e301529ff2"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    transaction: '0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080',
    walletSecretId: 'e051beeb-7163-4527-a5b6-35e301529ff2'
  })
};

fetch('https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'address' => '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    'transaction' => '0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080',
    'walletSecretId' => 'e051beeb-7163-4527-a5b6-35e301529ff2'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction"

	payload := strings.NewReader("{\n  \"address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"transaction\": \"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080\",\n  \"walletSecretId\": \"e051beeb-7163-4527-a5b6-35e301529ff2\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"transaction\": \"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080\",\n  \"walletSecretId\": \"e051beeb-7163-4527-a5b6-35e301529ff2\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/evm/sign/transaction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"transaction\": \"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080\",\n  \"walletSecretId\": \"e051beeb-7163-4527-a5b6-35e301529ff2\"\n}"

response = http.request(request)
puts response.read_body

{
  "signedTransaction": "0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"
}

Authorizations

Authorization

string

header

required

A JWT signed using the developer's own JWT private key (in the case of JWT authentication), or an end user JWT signed by CDP, encoded in base64. This is used for End User Account APIs.

Headers

X-Wallet-Auth

string

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

X-Developer-Auth

string

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.

Path Parameters

userId

string

required

The ID of the end user.

Pattern: ^[a-zA-Z0-9-]{1,100}$

Example:

"e051beeb-7163-4527-a5b6-35e301529ff2"

Query Parameters

projectID

string

The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Example:

"8e03978e-40d5-43e8-bc93-6894a57f9324"

Body

application/json

address

string

required

The 0x-prefixed address of the EVM account belonging to the end user.

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

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

transaction

string

required

The RLP-encoded transaction to sign, as a 0x-prefixed hex string.

Example:

"0xf86b098505d21dba00830334509431415daf58e2c6b7323b4c58712fd92952145da79018080"

walletSecretId

string

Required when not using delegated signing. The ID of the Temporary Wallet Secret that was used to sign the X-Wallet-Auth Header.

Pattern: ^[a-zA-Z0-9-]{1,100}$

Example:

"e051beeb-7163-4527-a5b6-35e301529ff2"

Response

Successfully signed transaction.

signedTransaction

string

required

The RLP-encoded signed transaction, as a 0x-prefixed hex string.

Example:

"0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"

CDP API

REST API

Sign transaction via end user EVM account

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response