Redeem vault fees with an EVM Smart Account

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Wallet-Auth: <x-wallet-auth>' \
  --data '
{
  "vaultId": "vault_019f5f10-096a-7a23-86df-f479650d813f",
  "useCdpPaymaster": true
}
'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees"

payload = {
    "vaultId": "vault_019f5f10-096a-7a23-86df-f479650d813f",
    "useCdpPaymaster": True
}
headers = {
    "X-Wallet-Auth": "<x-wallet-auth>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Wallet-Auth': '<x-wallet-auth>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({vaultId: 'vault_019f5f10-096a-7a23-86df-f479650d813f', useCdpPaymaster: true})
};

fetch('https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees', 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/evm/smart-accounts/{address}/lend/redeem-fees",
  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([
    'vaultId' => 'vault_019f5f10-096a-7a23-86df-f479650d813f',
    'useCdpPaymaster' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Wallet-Auth: <x-wallet-auth>"
  ],
]);

$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/evm/smart-accounts/{address}/lend/redeem-fees"

	payload := strings.NewReader("{\n  \"vaultId\": \"vault_019f5f10-096a-7a23-86df-f479650d813f\",\n  \"useCdpPaymaster\": true\n}")

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

	req.Header.Add("X-Wallet-Auth", "<x-wallet-auth>")
	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/evm/smart-accounts/{address}/lend/redeem-fees")
  .header("X-Wallet-Auth", "<x-wallet-auth>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"vaultId\": \"vault_019f5f10-096a-7a23-86df-f479650d813f\",\n  \"useCdpPaymaster\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees")

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

request = Net::HTTP::Post.new(url)
request["X-Wallet-Auth"] = '<x-wallet-auth>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"vaultId\": \"vault_019f5f10-096a-7a23-86df-f479650d813f\",\n  \"useCdpPaymaster\": true\n}"

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

{
  "userOpHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

Lend

Redeem vault fees with an EVM Smart Account

Redeems every vault share held by the vault’s fee recipient EVM Smart Account for the vault’s underlying asset (e.g. USDC). The Smart Account must be the vault’s fee recipient, and its owner must be a CDP EVM account. CDP periodically distributes each vault’s accrued fees to its fee recipient as vault shares. This API redeems the Smart Account’s full share balance, including any shares from the Smart Account’s own deposits into the vault, so use a dedicated fee recipient Smart Account. The share approval and redemption are batched into a single user operation. For fee recipients that are EVM accounts, use redeemVaultFeesWithEvmAccount instead.

POST

evm

smart-accounts

{address}

lend

redeem-fees

Redeem vault fees with an EVM Smart Account

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Wallet-Auth: <x-wallet-auth>' \
  --data '
{
  "vaultId": "vault_019f5f10-096a-7a23-86df-f479650d813f",
  "useCdpPaymaster": true
}
'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees"

payload = {
    "vaultId": "vault_019f5f10-096a-7a23-86df-f479650d813f",
    "useCdpPaymaster": True
}
headers = {
    "X-Wallet-Auth": "<x-wallet-auth>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Wallet-Auth': '<x-wallet-auth>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({vaultId: 'vault_019f5f10-096a-7a23-86df-f479650d813f', useCdpPaymaster: true})
};

fetch('https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees', 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/evm/smart-accounts/{address}/lend/redeem-fees",
  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([
    'vaultId' => 'vault_019f5f10-096a-7a23-86df-f479650d813f',
    'useCdpPaymaster' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Wallet-Auth: <x-wallet-auth>"
  ],
]);

$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/evm/smart-accounts/{address}/lend/redeem-fees"

	payload := strings.NewReader("{\n  \"vaultId\": \"vault_019f5f10-096a-7a23-86df-f479650d813f\",\n  \"useCdpPaymaster\": true\n}")

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

	req.Header.Add("X-Wallet-Auth", "<x-wallet-auth>")
	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/evm/smart-accounts/{address}/lend/redeem-fees")
  .header("X-Wallet-Auth", "<x-wallet-auth>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"vaultId\": \"vault_019f5f10-096a-7a23-86df-f479650d813f\",\n  \"useCdpPaymaster\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/lend/redeem-fees")

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

request = Net::HTTP::Post.new(url)
request["X-Wallet-Auth"] = '<x-wallet-auth>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"vaultId\": \"vault_019f5f10-096a-7a23-86df-f479650d813f\",\n  \"useCdpPaymaster\": true\n}"

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

{
  "userOpHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

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 Smart Account that is the vault's fee recipient.

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

Body

application/json

A request to redeem the fee shares held by the vault's fee recipient EVM Smart Account for the vault's underlying asset (e.g. USDC). The share approval and redemption are batched into a single user operation.

vaultId

string

required

The globally unique ID of the vault, which is a UUID prefixed with the string vault_.

Pattern: ^vault_[a-f0-9-]{36}$

Example:

"vault_019f5f10-096a-7a23-86df-f479650d813f"

maxSlippageBps

integer

The maximum share-price movement tolerated between calldata construction and onchain execution, in basis points. Defaults to 100 bps (1%) when omitted.

Required range: 0 <= x <= 9999

Example:

100

useCdpPaymaster

boolean

Whether to use CDP Paymaster to sponsor gas fees. When true, the user operation gas will be paid by the Paymaster, allowing the account to redeem fees without holding native gas tokens. Cannot be used together with paymasterUrl.

Example:

true

paymasterUrl

string<uri>

Optional custom Paymaster URL to use for gas sponsorship. This allows you to use your own Paymaster service instead of CDP's Paymaster. Cannot be used together with useCdpPaymaster.

Required string length: 11 - 2048

Pattern: ^https?://.*$

Example:

"https://api.developer.coinbase.com/rpc/v1/base/AbCdEf123456"

paymasterContext

object

The ERC-7677 context object forwarded to the paymaster service as part of the paymasterService capability. The fields in this object are defined by the paymaster service provider; CDP forwards them to the paymaster unchanged. This field is only valid when a paymaster is configured for the request. Providing paymasterContext without a paymaster configured results in an invalid_request error.

Example:

{
  "policyId": "962b252c-a726-4a37-8d86-333ce0a07299"
}

Response

Successfully broadcast the fee redemption user operation.

The result of a vault fee redemption from an EVM Smart Account after broadcast.

userOpHash

string

required

The hash of the user operation executing the fee redemption, as a 0x-prefixed hex string. Poll getUserOperation for the operation's status.

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

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"