cdp.openapi_client.api package

Submodules

cdp.openapi_client.api.accounts_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.accounts_api.AccountsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_foundation_account(create_account_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create account

Create an account for your Entity. Support for creating Customer-owned accounts is in development.

Parameters:
  • create_account_request (CreateAccountRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Account

Returns:

Returns the result object.

async create_foundation_account_with_http_info(create_account_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create account

Create an account for your Entity. Support for creating Customer-owned accounts is in development.

Parameters:
  • create_account_request (CreateAccountRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Account]

Returns:

Returns the result object.

async create_foundation_account_without_preload_content(create_account_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create account

Create an account for your Entity. Support for creating Customer-owned accounts is in development.

Parameters:
  • create_account_request (CreateAccountRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_balance_by_asset(account_id, asset, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get balance for account

Get the balance for an account by asset.

Parameters:
  • account_id (str) – The unique identifier of the account. (required)

  • asset (str) – The symbol of the asset. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Balance

Returns:

Returns the result object.

async get_balance_by_asset_with_http_info(account_id, asset, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get balance for account

Get the balance for an account by asset.

Parameters:
  • account_id (str) – The unique identifier of the account. (required)

  • asset (str) – The symbol of the asset. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Balance]

Returns:

Returns the result object.

async get_balance_by_asset_without_preload_content(account_id, asset, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get balance for account

Get the balance for an account by asset.

Parameters:
  • account_id (str) – The unique identifier of the account. (required)

  • asset (str) – The symbol of the asset. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_foundation_account_by_id(account_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get account

Get an account by its ID.

Parameters:
  • account_id (str) – The ID of the account to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Account

Returns:

Returns the result object.

async get_foundation_account_by_id_with_http_info(account_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get account

Get an account by its ID.

Parameters:
  • account_id (str) – The ID of the account to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Account]

Returns:

Returns the result object.

async get_foundation_account_by_id_without_preload_content(account_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get account

Get an account by its ID.

Parameters:
  • account_id (str) – The ID of the account to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_balances(account_id, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List balances for account

List the balances for an account. Results are sorted by native-fiat equivalent balance in descending order.

Parameters:
  • account_id (str) – The unique identifier of the account. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListBalances200Response

Returns:

Returns the result object.

async list_balances_with_http_info(account_id, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List balances for account

List the balances for an account. Results are sorted by native-fiat equivalent balance in descending order.

Parameters:
  • account_id (str) – The unique identifier of the account. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListBalances200Response]

Returns:

Returns the result object.

async list_balances_without_preload_content(account_id, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List balances for account

List the balances for an account. Results are sorted by native-fiat equivalent balance in descending order.

Parameters:
  • account_id (str) – The unique identifier of the account. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_foundation_accounts(page_size=None, page_token=None, type=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List accounts

List all accounts. The API will return all accounts that the API Key has Permissions to access. You can filter the results by using query parameters, which will be treated as a single conjunction (i.e. AND). Results are sorted by creation date in descending order (newest first).

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • type (AccountType) – Filter accounts by account type. When omitted, accounts of any type are returned. Combined with owner using AND.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListFoundationAccounts200Response

Returns:

Returns the result object.

async list_foundation_accounts_with_http_info(page_size=None, page_token=None, type=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List accounts

List all accounts. The API will return all accounts that the API Key has Permissions to access. You can filter the results by using query parameters, which will be treated as a single conjunction (i.e. AND). Results are sorted by creation date in descending order (newest first).

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • type (AccountType) – Filter accounts by account type. When omitted, accounts of any type are returned. Combined with owner using AND.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListFoundationAccounts200Response]

Returns:

Returns the result object.

async list_foundation_accounts_without_preload_content(page_size=None, page_token=None, type=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List accounts

List all accounts. The API will return all accounts that the API Key has Permissions to access. You can filter the results by using query parameters, which will be treated as a single conjunction (i.e. AND). Results are sorted by creation date in descending order (newest first).

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • type (AccountType) – Filter accounts by account type. When omitted, accounts of any type are returned. Combined with owner using AND.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.deposit_destinations_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.deposit_destinations_api.DepositDestinationsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_deposit_destination(create_deposit_destination_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create deposit destination

Create a new deposit destination for an account. A deposit destination is a cryptocurrency address that can be used to receive funds. The address will be generated for the specified network.

Parameters:
  • create_deposit_destination_request (CreateDepositDestinationRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

DepositDestination

Returns:

Returns the result object.

async create_deposit_destination_with_http_info(create_deposit_destination_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create deposit destination

Create a new deposit destination for an account. A deposit destination is a cryptocurrency address that can be used to receive funds. The address will be generated for the specified network.

Parameters:
  • create_deposit_destination_request (CreateDepositDestinationRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[DepositDestination]

Returns:

Returns the result object.

async create_deposit_destination_without_preload_content(create_deposit_destination_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create deposit destination

Create a new deposit destination for an account. A deposit destination is a cryptocurrency address that can be used to receive funds. The address will be generated for the specified network.

Parameters:
  • create_deposit_destination_request (CreateDepositDestinationRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_deposit_destination_by_id(deposit_destination_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get deposit destination

Get a specific deposit destination by its ID.

Parameters:
  • deposit_destination_id (str) – The ID of the deposit address to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

DepositDestination

Returns:

Returns the result object.

async get_deposit_destination_by_id_with_http_info(deposit_destination_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get deposit destination

Get a specific deposit destination by its ID.

Parameters:
  • deposit_destination_id (str) – The ID of the deposit address to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[DepositDestination]

Returns:

Returns the result object.

async get_deposit_destination_by_id_without_preload_content(deposit_destination_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get deposit destination

Get a specific deposit destination by its ID.

Parameters:
  • deposit_destination_id (str) – The ID of the deposit address to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_deposit_destinations(account_id=None, address=None, type=None, network=None, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List deposit destinations

List deposit destinations. You can optionally filter the results by type, account ID, network, or cryptocurrency address. Results are sorted by creation date in descending order (newest first).

Parameters:
  • account_id (str) – Filter deposit destinations by account ID.

  • address (str) – Filter deposit destinations by the cryptocurrency address.

  • type (str) – Filter deposit destinations by type.

  • network (str) – Filter deposit destinations by network.

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListDepositDestinations200Response

Returns:

Returns the result object.

async list_deposit_destinations_with_http_info(account_id=None, address=None, type=None, network=None, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List deposit destinations

List deposit destinations. You can optionally filter the results by type, account ID, network, or cryptocurrency address. Results are sorted by creation date in descending order (newest first).

Parameters:
  • account_id (str) – Filter deposit destinations by account ID.

  • address (str) – Filter deposit destinations by the cryptocurrency address.

  • type (str) – Filter deposit destinations by type.

  • network (str) – Filter deposit destinations by network.

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListDepositDestinations200Response]

Returns:

Returns the result object.

async list_deposit_destinations_without_preload_content(account_id=None, address=None, type=None, network=None, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List deposit destinations

List deposit destinations. You can optionally filter the results by type, account ID, network, or cryptocurrency address. Results are sorted by creation date in descending order (newest first).

Parameters:
  • account_id (str) – Filter deposit destinations by account ID.

  • address (str) – Filter deposit destinations by the cryptocurrency address.

  • type (str) – Filter deposit destinations by type.

  • network (str) – Filter deposit destinations by network.

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.end_user_account_management_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.end_user_account_management_api.EndUserAccountManagementApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async add_end_user_evm_account(user_id, x_wallet_auth=None, x_idempotency_key=None, body=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add EVM account to end user

Adds a new EVM EOA account to an existing end user. End users can have up to 10 EVM accounts. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • body (object)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

AddEndUserEvmAccount201Response

Returns:

Returns the result object.

async add_end_user_evm_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, body=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add EVM account to end user

Adds a new EVM EOA account to an existing end user. End users can have up to 10 EVM accounts. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • body (object)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[AddEndUserEvmAccount201Response]

Returns:

Returns the result object.

async add_end_user_evm_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, body=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add EVM account to end user

Adds a new EVM EOA account to an existing end user. End users can have up to 10 EVM accounts. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • body (object)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async add_end_user_evm_smart_account(user_id, x_wallet_auth=None, x_idempotency_key=None, add_end_user_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add EVM smart account to end user

Creates an EVM smart account for an existing end user. The backend will create a new EVM EOA account to serve as the owner of the smart account. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the smart account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • add_end_user_evm_smart_account_request (AddEndUserEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

AddEndUserEvmSmartAccount201Response

Returns:

Returns the result object.

async add_end_user_evm_smart_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, add_end_user_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add EVM smart account to end user

Creates an EVM smart account for an existing end user. The backend will create a new EVM EOA account to serve as the owner of the smart account. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the smart account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • add_end_user_evm_smart_account_request (AddEndUserEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[AddEndUserEvmSmartAccount201Response]

Returns:

Returns the result object.

async add_end_user_evm_smart_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, add_end_user_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add EVM smart account to end user

Creates an EVM smart account for an existing end user. The backend will create a new EVM EOA account to serve as the owner of the smart account. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the smart account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • add_end_user_evm_smart_account_request (AddEndUserEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async add_end_user_solana_account(user_id, x_wallet_auth=None, x_idempotency_key=None, body=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add Solana account to end user

Adds a new Solana account to an existing end user. End users can have up to 10 Solana accounts. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • body (object)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

AddEndUserSolanaAccount201Response

Returns:

Returns the result object.

async add_end_user_solana_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, body=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add Solana account to end user

Adds a new Solana account to an existing end user. End users can have up to 10 Solana accounts. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • body (object)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[AddEndUserSolanaAccount201Response]

Returns:

Returns the result object.

async add_end_user_solana_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, body=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Add Solana account to end user

Adds a new Solana account to an existing end user. End users can have up to 10 Solana accounts. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to add the account to. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • body (object)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async create_end_user(x_wallet_auth=None, x_idempotency_key=None, create_end_user_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create end user

Creates an end user. An end user is an entity that can own CDP EVM accounts, EVM smart accounts, and/or Solana accounts. 1 or more authentication methods must be associated with an end user. By default, no accounts are created unless the optional evmAccount and/or solanaAccount fields are provided. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_end_user_request (CreateEndUserRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EndUser

Returns:

Returns the result object.

async create_end_user_with_http_info(x_wallet_auth=None, x_idempotency_key=None, create_end_user_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create end user

Creates an end user. An end user is an entity that can own CDP EVM accounts, EVM smart accounts, and/or Solana accounts. 1 or more authentication methods must be associated with an end user. By default, no accounts are created unless the optional evmAccount and/or solanaAccount fields are provided. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_end_user_request (CreateEndUserRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EndUser]

Returns:

Returns the result object.

async create_end_user_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, create_end_user_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create end user

Creates an end user. An end user is an entity that can own CDP EVM accounts, EVM smart accounts, and/or Solana accounts. 1 or more authentication methods must be associated with an end user. By default, no accounts are created unless the optional evmAccount and/or solanaAccount fields are provided. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_end_user_request (CreateEndUserRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_end_user(user_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get end user

Gets an end user by ID. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to get. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EndUser

Returns:

Returns the result object.

async get_end_user_with_http_info(user_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get end user

Gets an end user by ID. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to get. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EndUser]

Returns:

Returns the result object.

async get_end_user_without_preload_content(user_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get end user

Gets an end user by ID. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • user_id (str) – The ID of the end user to get. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async import_end_user(x_wallet_auth=None, x_idempotency_key=None, import_end_user_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import end user private key

Imports an existing private key for an end user into the developer’s CDP Project. The private key must be encrypted using the CDP SDK’s encryption scheme before being sent to this endpoint. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted. This endpoint allows developers to import existing keys for their end users, supporting both EVM and Solana key types. The end user must have at least one authentication method configured.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_end_user_request (ImportEndUserRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EndUser

Returns:

Returns the result object.

async import_end_user_with_http_info(x_wallet_auth=None, x_idempotency_key=None, import_end_user_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import end user private key

Imports an existing private key for an end user into the developer’s CDP Project. The private key must be encrypted using the CDP SDK’s encryption scheme before being sent to this endpoint. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted. This endpoint allows developers to import existing keys for their end users, supporting both EVM and Solana key types. The end user must have at least one authentication method configured.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_end_user_request (ImportEndUserRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EndUser]

Returns:

Returns the result object.

async import_end_user_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, import_end_user_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import end user private key

Imports an existing private key for an end user into the developer’s CDP Project. The private key must be encrypted using the CDP SDK’s encryption scheme before being sent to this endpoint. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted. This endpoint allows developers to import existing keys for their end users, supporting both EVM and Solana key types. The end user must have at least one authentication method configured.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_end_user_request (ImportEndUserRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_end_users(page_size=None, page_token=None, sort=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List end users

Lists the end users belonging to the developer’s CDP Project. By default, the response is sorted by creation date in ascending order and paginated to 20 users per page.

Parameters:
  • page_size (int) – The number of end users to return per page.

  • page_token (str) – The token for the desired page of end users. Will be empty if there are no more end users to fetch.

  • sort (List[str]) – Sort end users. Defaults to ascending order (oldest first).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListEndUsers200Response

Returns:

Returns the result object.

async list_end_users_with_http_info(page_size=None, page_token=None, sort=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List end users

Lists the end users belonging to the developer’s CDP Project. By default, the response is sorted by creation date in ascending order and paginated to 20 users per page.

Parameters:
  • page_size (int) – The number of end users to return per page.

  • page_token (str) – The token for the desired page of end users. Will be empty if there are no more end users to fetch.

  • sort (List[str]) – Sort end users. Defaults to ascending order (oldest first).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListEndUsers200Response]

Returns:

Returns the result object.

async list_end_users_without_preload_content(page_size=None, page_token=None, sort=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List end users

Lists the end users belonging to the developer’s CDP Project. By default, the response is sorted by creation date in ascending order and paginated to 20 users per page.

Parameters:
  • page_size (int) – The number of end users to return per page.

  • page_token (str) – The token for the desired page of end users. Will be empty if there are no more end users to fetch.

  • sort (List[str]) – Sort end users. Defaults to ascending order (oldest first).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async lookup_end_user(email=None, oauth_provider=None, oauth_subject=None, phone_number=None, siwe_address=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Look up end users by identity

Looks up end users. Exactly one lookup type must be provided per request: - email: searches across all email-based authentication methods (email, Google, Apple, GitHub). May return multiple end users if the same email address appears across different auth methods. - oauthProvider + oauthSubject: looks up a user by their OAuth provider and subject (the sub claim from the provider’s ID token). Both params must be provided together. - phoneNumber: looks up a user by their SMS-verified phone number. - siweAddress: looks up a user by the Ethereum address they authenticated with via Sign In With Ethereum (EIP-4361). Returns all matching end users. If no end users match, an empty array is returned. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • email (str) – The email address to search for across all email-based authentication methods.

  • oauth_provider (OAuth2ProviderType) – The OAuth provider to search by. Must be provided together with oauthSubject.

  • oauth_subject (str) – The OAuth subject (the sub claim from the provider’s ID token). Must be provided together with oauthProvider.

  • phone_number (str) – The E.164-formatted phone number to search for. Must be URL-encoded when passed as a query parameter (e.g. +14155552671%2B14155552671).

  • siwe_address (str) – The ERC-55 checksummed Ethereum address to search for. Looks up a user by the address they authenticated with via Sign In With Ethereum (EIP-4361).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

LookupEndUser200Response

Returns:

Returns the result object.

async lookup_end_user_with_http_info(email=None, oauth_provider=None, oauth_subject=None, phone_number=None, siwe_address=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Look up end users by identity

Looks up end users. Exactly one lookup type must be provided per request: - email: searches across all email-based authentication methods (email, Google, Apple, GitHub). May return multiple end users if the same email address appears across different auth methods. - oauthProvider + oauthSubject: looks up a user by their OAuth provider and subject (the sub claim from the provider’s ID token). Both params must be provided together. - phoneNumber: looks up a user by their SMS-verified phone number. - siweAddress: looks up a user by the Ethereum address they authenticated with via Sign In With Ethereum (EIP-4361). Returns all matching end users. If no end users match, an empty array is returned. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • email (str) – The email address to search for across all email-based authentication methods.

  • oauth_provider (OAuth2ProviderType) – The OAuth provider to search by. Must be provided together with oauthSubject.

  • oauth_subject (str) – The OAuth subject (the sub claim from the provider’s ID token). Must be provided together with oauthProvider.

  • phone_number (str) – The E.164-formatted phone number to search for. Must be URL-encoded when passed as a query parameter (e.g. +14155552671%2B14155552671).

  • siwe_address (str) – The ERC-55 checksummed Ethereum address to search for. Looks up a user by the address they authenticated with via Sign In With Ethereum (EIP-4361).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[LookupEndUser200Response]

Returns:

Returns the result object.

async lookup_end_user_without_preload_content(email=None, oauth_provider=None, oauth_subject=None, phone_number=None, siwe_address=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Look up end users by identity

Looks up end users. Exactly one lookup type must be provided per request: - email: searches across all email-based authentication methods (email, Google, Apple, GitHub). May return multiple end users if the same email address appears across different auth methods. - oauthProvider + oauthSubject: looks up a user by their OAuth provider and subject (the sub claim from the provider’s ID token). Both params must be provided together. - phoneNumber: looks up a user by their SMS-verified phone number. - siweAddress: looks up a user by the Ethereum address they authenticated with via Sign In With Ethereum (EIP-4361). Returns all matching end users. If no end users match, an empty array is returned. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • email (str) – The email address to search for across all email-based authentication methods.

  • oauth_provider (OAuth2ProviderType) – The OAuth provider to search by. Must be provided together with oauthSubject.

  • oauth_subject (str) – The OAuth subject (the sub claim from the provider’s ID token). Must be provided together with oauthProvider.

  • phone_number (str) – The E.164-formatted phone number to search for. Must be URL-encoded when passed as a query parameter (e.g. +14155552671%2B14155552671).

  • siwe_address (str) – The ERC-55 checksummed Ethereum address to search for. Looks up a user by the address they authenticated with via Sign In With Ethereum (EIP-4361).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async validate_end_user_access_token(validate_end_user_access_token_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Validate end user access token

Validates the end user’s access token and returns the end user’s information. Returns an error if the access token is invalid or expired. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • validate_end_user_access_token_request (ValidateEndUserAccessTokenRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EndUser

Returns:

Returns the result object.

async validate_end_user_access_token_with_http_info(validate_end_user_access_token_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Validate end user access token

Validates the end user’s access token and returns the end user’s information. Returns an error if the access token is invalid or expired. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • validate_end_user_access_token_request (ValidateEndUserAccessTokenRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EndUser]

Returns:

Returns the result object.

async validate_end_user_access_token_without_preload_content(validate_end_user_access_token_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Validate end user access token

Validates the end user’s access token and returns the end user’s information. Returns an error if the access token is invalid or expired. This API is intended to be used by the developer’s own backend, and is authenticated using the developer’s CDP API key.

Parameters:
  • validate_end_user_access_token_request (ValidateEndUserAccessTokenRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.end_user_accounts_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.end_user_accounts_api.EndUserAccountsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_delegation_for_end_user_account(user_id, address, create_delegation_for_end_user_account_request, x_wallet_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create account-scoped delegation for end user

Creates an account-scoped delegation that allows a developer to sign on behalf of an end user for a single blockchain account (identified by its address) for the specified duration. The end user must be authenticated to authorize this delegation. Multiple account-scoped delegations may exist concurrently for a single end user (one per canonical account address). Account-scoped and user-scoped delegations cannot coexist for the same user. When the address corresponds to an EVM Smart Account, the delegation is scoped to the Smart Account’s owner EOA rather than the Smart Account address itself. This means /address/{smartAccountAddress}/delegation and /address/{ownerEoaAddress}/delegation resolve to the same delegation, and the 409 account_scoped_delegation_active error may be returned when creating via either address if one already exists for the canonical owner.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account to scope this delegation to. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana). For EVM addresses, matching is case-insensitive. (required)

  • create_delegation_for_end_user_account_request (CreateDelegationForEndUserAccountRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetDelegationForEndUser200Response

Returns:

Returns the result object.

async create_delegation_for_end_user_account_with_http_info(user_id, address, create_delegation_for_end_user_account_request, x_wallet_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create account-scoped delegation for end user

Creates an account-scoped delegation that allows a developer to sign on behalf of an end user for a single blockchain account (identified by its address) for the specified duration. The end user must be authenticated to authorize this delegation. Multiple account-scoped delegations may exist concurrently for a single end user (one per canonical account address). Account-scoped and user-scoped delegations cannot coexist for the same user. When the address corresponds to an EVM Smart Account, the delegation is scoped to the Smart Account’s owner EOA rather than the Smart Account address itself. This means /address/{smartAccountAddress}/delegation and /address/{ownerEoaAddress}/delegation resolve to the same delegation, and the 409 account_scoped_delegation_active error may be returned when creating via either address if one already exists for the canonical owner.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account to scope this delegation to. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana). For EVM addresses, matching is case-insensitive. (required)

  • create_delegation_for_end_user_account_request (CreateDelegationForEndUserAccountRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[GetDelegationForEndUser200Response]

Returns:

Returns the result object.

async create_delegation_for_end_user_account_without_preload_content(user_id, address, create_delegation_for_end_user_account_request, x_wallet_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create account-scoped delegation for end user

Creates an account-scoped delegation that allows a developer to sign on behalf of an end user for a single blockchain account (identified by its address) for the specified duration. The end user must be authenticated to authorize this delegation. Multiple account-scoped delegations may exist concurrently for a single end user (one per canonical account address). Account-scoped and user-scoped delegations cannot coexist for the same user. When the address corresponds to an EVM Smart Account, the delegation is scoped to the Smart Account’s owner EOA rather than the Smart Account address itself. This means /address/{smartAccountAddress}/delegation and /address/{ownerEoaAddress}/delegation resolve to the same delegation, and the 409 account_scoped_delegation_active error may be returned when creating via either address if one already exists for the canonical owner.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account to scope this delegation to. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana). For EVM addresses, matching is case-insensitive. (required)

  • create_delegation_for_end_user_account_request (CreateDelegationForEndUserAccountRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async create_evm_eip7702_delegation_with_end_user_account(user_id, create_evm_eip7702_delegation_with_end_user_account_request, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EIP-7702 delegation for end user EVM account

Creates an EIP-7702 delegation for an end user’s EVM EOA account, upgrading it with smart account capabilities. This endpoint: - Retrieves delegation artifacts from onchain - Signs the EIP-7702 authorization for delegation - Assembles and submits a Type 4 transaction - Creates an associated smart account object The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • create_evm_eip7702_delegation_with_end_user_account_request (CreateEvmEip7702DelegationWithEndUserAccountRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

CreateEvmEip7702DelegationWithEndUserAccount201Response

Returns:

Returns the result object.

async create_evm_eip7702_delegation_with_end_user_account_with_http_info(user_id, create_evm_eip7702_delegation_with_end_user_account_request, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EIP-7702 delegation for end user EVM account

Creates an EIP-7702 delegation for an end user’s EVM EOA account, upgrading it with smart account capabilities. This endpoint: - Retrieves delegation artifacts from onchain - Signs the EIP-7702 authorization for delegation - Assembles and submits a Type 4 transaction - Creates an associated smart account object The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • create_evm_eip7702_delegation_with_end_user_account_request (CreateEvmEip7702DelegationWithEndUserAccountRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[CreateEvmEip7702DelegationWithEndUserAccount201Response]

Returns:

Returns the result object.

async create_evm_eip7702_delegation_with_end_user_account_without_preload_content(user_id, create_evm_eip7702_delegation_with_end_user_account_request, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EIP-7702 delegation for end user EVM account

Creates an EIP-7702 delegation for an end user’s EVM EOA account, upgrading it with smart account capabilities. This endpoint: - Retrieves delegation artifacts from onchain - Signs the EIP-7702 authorization for delegation - Assembles and submits a Type 4 transaction - Creates an associated smart account object The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • create_evm_eip7702_delegation_with_end_user_account_request (CreateEvmEip7702DelegationWithEndUserAccountRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_delegation_for_end_user(user_id, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get delegation for end user

Returns the active delegation for the specified end user, if one exists. This operation can be performed by the end user themselves or by a developer using their API key.

Parameters:
  • user_id (str) – The ID of the end user. (required)

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetDelegationForEndUser200Response

Returns:

Returns the result object.

async get_delegation_for_end_user_account(user_id, address, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get account-scoped delegation for end user

Returns the active account-scoped delegation for the specified end user account, if one exists. Useful for showing delegation status in a UI. When the address corresponds to an EVM Smart Account, this returns the delegation for the Smart Account’s owner EOA.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account to query. For EVM addresses, matching is case-insensitive. (required)

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetDelegationForEndUser200Response

Returns:

Returns the result object.

async get_delegation_for_end_user_account_with_http_info(user_id, address, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get account-scoped delegation for end user

Returns the active account-scoped delegation for the specified end user account, if one exists. Useful for showing delegation status in a UI. When the address corresponds to an EVM Smart Account, this returns the delegation for the Smart Account’s owner EOA.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account to query. For EVM addresses, matching is case-insensitive. (required)

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[GetDelegationForEndUser200Response]

Returns:

Returns the result object.

async get_delegation_for_end_user_account_without_preload_content(user_id, address, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get account-scoped delegation for end user

Returns the active account-scoped delegation for the specified end user account, if one exists. Useful for showing delegation status in a UI. When the address corresponds to an EVM Smart Account, this returns the delegation for the Smart Account’s owner EOA.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account to query. For EVM addresses, matching is case-insensitive. (required)

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_delegation_for_end_user_with_http_info(user_id, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get delegation for end user

Returns the active delegation for the specified end user, if one exists. This operation can be performed by the end user themselves or by a developer using their API key.

Parameters:
  • user_id (str) – The ID of the end user. (required)

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[GetDelegationForEndUser200Response]

Returns:

Returns the result object.

async get_delegation_for_end_user_without_preload_content(user_id, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get delegation for end user

Returns the active delegation for the specified end user, if one exists. This operation can be performed by the end user themselves or by a developer using their API key.

Parameters:
  • user_id (str) – The ID of the end user. (required)

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async revoke_delegation_for_end_user(user_id, revoke_delegation_for_end_user_request, x_wallet_auth=None, x_developer_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke delegation for end user

Revokes all active delegations for the specified end user. This operation can be performed by the end user themselves or by a developer using their API key.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • revoke_delegation_for_end_user_request (RevokeDelegationForEndUserRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

None

Returns:

Returns the result object.

async revoke_delegation_for_end_user_account(user_id, address, revoke_delegation_for_end_user_request, x_wallet_auth=None, x_developer_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke account-scoped delegation for end user

Revokes the active account-scoped delegation for the specified end user account. Other account-scoped delegations for the same user are unaffected. This operation can be performed by the end user themselves or by a developer using their API key. When the address corresponds to an EVM Smart Account, this revokes the delegation for the Smart Account’s owner EOA.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account whose delegation should be revoked. For EVM addresses, matching is case-insensitive. (required)

  • revoke_delegation_for_end_user_request (RevokeDelegationForEndUserRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

None

Returns:

Returns the result object.

async revoke_delegation_for_end_user_account_with_http_info(user_id, address, revoke_delegation_for_end_user_request, x_wallet_auth=None, x_developer_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke account-scoped delegation for end user

Revokes the active account-scoped delegation for the specified end user account. Other account-scoped delegations for the same user are unaffected. This operation can be performed by the end user themselves or by a developer using their API key. When the address corresponds to an EVM Smart Account, this revokes the delegation for the Smart Account’s owner EOA.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account whose delegation should be revoked. For EVM addresses, matching is case-insensitive. (required)

  • revoke_delegation_for_end_user_request (RevokeDelegationForEndUserRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[NoneType]

Returns:

Returns the result object.

async revoke_delegation_for_end_user_account_without_preload_content(user_id, address, revoke_delegation_for_end_user_request, x_wallet_auth=None, x_developer_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke account-scoped delegation for end user

Revokes the active account-scoped delegation for the specified end user account. Other account-scoped delegations for the same user are unaffected. This operation can be performed by the end user themselves or by a developer using their API key. When the address corresponds to an EVM Smart Account, this revokes the delegation for the Smart Account’s owner EOA.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The blockchain address of the end user account whose delegation should be revoked. For EVM addresses, matching is case-insensitive. (required)

  • revoke_delegation_for_end_user_request (RevokeDelegationForEndUserRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async revoke_delegation_for_end_user_with_http_info(user_id, revoke_delegation_for_end_user_request, x_wallet_auth=None, x_developer_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke delegation for end user

Revokes all active delegations for the specified end user. This operation can be performed by the end user themselves or by a developer using their API key.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • revoke_delegation_for_end_user_request (RevokeDelegationForEndUserRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[NoneType]

Returns:

Returns the result object.

async revoke_delegation_for_end_user_without_preload_content(user_id, revoke_delegation_for_end_user_request, x_wallet_auth=None, x_developer_auth=None, x_idempotency_key=None, project_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke delegation for end user

Revokes all active delegations for the specified end user. This operation can be performed by the end user themselves or by a developer using their API key.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • revoke_delegation_for_end_user_request (RevokeDelegationForEndUserRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

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

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_evm_asset_with_end_user_account(user_id, address, asset, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_evm_asset_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send USDC on EVM

Sends USDC from an end user’s EVM account (EOA or Smart Account) to a recipient address on a supported EVM network. This endpoint simplifies USDC transfers by automatically handling contract resolution, decimal conversion, gas estimation, and transaction encoding. The amount field accepts human-readable amounts as decimal strings (e.g., “1.5”, “25.50”).

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The 0x-prefixed address of the EVM account (EOA or Smart Account) to send USDC from. The address does not need to be checksummed. (required)

  • asset (str) – The asset to send. Currently only “usdc” is supported. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_evm_asset_with_end_user_account_request (SendEvmAssetWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SendEvmAssetWithEndUserAccount200Response

Returns:

Returns the result object.

async send_evm_asset_with_end_user_account_with_http_info(user_id, address, asset, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_evm_asset_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send USDC on EVM

Sends USDC from an end user’s EVM account (EOA or Smart Account) to a recipient address on a supported EVM network. This endpoint simplifies USDC transfers by automatically handling contract resolution, decimal conversion, gas estimation, and transaction encoding. The amount field accepts human-readable amounts as decimal strings (e.g., “1.5”, “25.50”).

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The 0x-prefixed address of the EVM account (EOA or Smart Account) to send USDC from. The address does not need to be checksummed. (required)

  • asset (str) – The asset to send. Currently only “usdc” is supported. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_evm_asset_with_end_user_account_request (SendEvmAssetWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SendEvmAssetWithEndUserAccount200Response]

Returns:

Returns the result object.

async send_evm_asset_with_end_user_account_without_preload_content(user_id, address, asset, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_evm_asset_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send USDC on EVM

Sends USDC from an end user’s EVM account (EOA or Smart Account) to a recipient address on a supported EVM network. This endpoint simplifies USDC transfers by automatically handling contract resolution, decimal conversion, gas estimation, and transaction encoding. The amount field accepts human-readable amounts as decimal strings (e.g., “1.5”, “25.50”).

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The 0x-prefixed address of the EVM account (EOA or Smart Account) to send USDC from. The address does not need to be checksummed. (required)

  • asset (str) – The asset to send. Currently only “usdc” is supported. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_evm_asset_with_end_user_account_request (SendEvmAssetWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_evm_transaction_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_evm_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction via end user EVM account

Signs a transaction with the given end user EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). Transaction fields and API behavior - to (Required): The address of the contract or account to send the transaction to. - chainId (Ignored): The value of the chainId field in the transaction is ignored. The transaction will be sent to the network indicated by the network field in the request body. - nonce (Optional): The nonce to use for the transaction. If not provided, the API will assign a nonce to the transaction based on the current state of the account. - maxPriorityFeePerGas (Optional): The maximum priority fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - maxFeePerGas (Optional): The maximum fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - gasLimit (Optional): The gas limit to use for the transaction. If not provided, the API will estimate a value based on the to and data fields of the transaction. - value (Optional): The amount of ETH, in wei, to send with the transaction. - data (Optional): The data to send with the transaction; only used for contract calls. - accessList (Optional): The access list to use for the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_evm_transaction_with_end_user_account_request (SendEvmTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SendEvmTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async send_evm_transaction_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_evm_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction via end user EVM account

Signs a transaction with the given end user EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). Transaction fields and API behavior - to (Required): The address of the contract or account to send the transaction to. - chainId (Ignored): The value of the chainId field in the transaction is ignored. The transaction will be sent to the network indicated by the network field in the request body. - nonce (Optional): The nonce to use for the transaction. If not provided, the API will assign a nonce to the transaction based on the current state of the account. - maxPriorityFeePerGas (Optional): The maximum priority fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - maxFeePerGas (Optional): The maximum fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - gasLimit (Optional): The gas limit to use for the transaction. If not provided, the API will estimate a value based on the to and data fields of the transaction. - value (Optional): The amount of ETH, in wei, to send with the transaction. - data (Optional): The data to send with the transaction; only used for contract calls. - accessList (Optional): The access list to use for the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_evm_transaction_with_end_user_account_request (SendEvmTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SendEvmTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async send_evm_transaction_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_evm_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction via end user EVM account

Signs a transaction with the given end user EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). Transaction fields and API behavior - to (Required): The address of the contract or account to send the transaction to. - chainId (Ignored): The value of the chainId field in the transaction is ignored. The transaction will be sent to the network indicated by the network field in the request body. - nonce (Optional): The nonce to use for the transaction. If not provided, the API will assign a nonce to the transaction based on the current state of the account. - maxPriorityFeePerGas (Optional): The maximum priority fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - maxFeePerGas (Optional): The maximum fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - gasLimit (Optional): The gas limit to use for the transaction. If not provided, the API will estimate a value based on the to and data fields of the transaction. - value (Optional): The amount of ETH, in wei, to send with the transaction. - data (Optional): The data to send with the transaction; only used for contract calls. - accessList (Optional): The access list to use for the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_evm_transaction_with_end_user_account_request (SendEvmTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_solana_asset_with_end_user_account(user_id, address, asset, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_solana_asset_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send USDC on Solana

Sends USDC from an end user’s Solana account to a recipient address on the Solana network. This endpoint simplifies USDC transfers by automatically handling mint resolution, Associated Token Account (ATA) creation, decimal conversion, and transaction encoding. The amount field accepts human-readable amounts as decimal strings (e.g., “1.5”, “25.50”). Use the optional createRecipientAta parameter to control whether the sender pays for creating the recipient’s Associated Token Account if it doesn’t exist.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The base58 encoded address of the Solana account to send USDC from. (required)

  • asset (str) – The asset to send. Currently only “usdc” is supported. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_solana_asset_with_end_user_account_request (SendSolanaAssetWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SendSolanaTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async send_solana_asset_with_end_user_account_with_http_info(user_id, address, asset, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_solana_asset_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send USDC on Solana

Sends USDC from an end user’s Solana account to a recipient address on the Solana network. This endpoint simplifies USDC transfers by automatically handling mint resolution, Associated Token Account (ATA) creation, decimal conversion, and transaction encoding. The amount field accepts human-readable amounts as decimal strings (e.g., “1.5”, “25.50”). Use the optional createRecipientAta parameter to control whether the sender pays for creating the recipient’s Associated Token Account if it doesn’t exist.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The base58 encoded address of the Solana account to send USDC from. (required)

  • asset (str) – The asset to send. Currently only “usdc” is supported. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_solana_asset_with_end_user_account_request (SendSolanaAssetWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SendSolanaTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async send_solana_asset_with_end_user_account_without_preload_content(user_id, address, asset, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_solana_asset_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send USDC on Solana

Sends USDC from an end user’s Solana account to a recipient address on the Solana network. This endpoint simplifies USDC transfers by automatically handling mint resolution, Associated Token Account (ATA) creation, decimal conversion, and transaction encoding. The amount field accepts human-readable amounts as decimal strings (e.g., “1.5”, “25.50”). Use the optional createRecipientAta parameter to control whether the sender pays for creating the recipient’s Associated Token Account if it doesn’t exist.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The base58 encoded address of the Solana account to send USDC from. (required)

  • asset (str) – The asset to send. Currently only “usdc” is supported. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_solana_asset_with_end_user_account_request (SendSolanaAssetWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_solana_transaction_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_solana_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction via end user Solana account

Signs a transaction with the given end user Solana account and sends it to the indicated supported network. The API handles recent blockhash management and fee estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana.com/developers/guides/advanced/versions#current-transaction-versions) * [Versioned transactions](https://solana.com/developers/guides/advanced/versions) Instruction Batching To batch multiple operations, include multiple instructions within a single transaction. All instructions within a transaction are executed atomically - if any instruction fails, the entire transaction fails and is rolled back. Network Support The following Solana networks are supported: * solana - Solana Mainnet * solana-devnet - Solana Devnet The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_solana_transaction_with_end_user_account_request (SendSolanaTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SendSolanaTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async send_solana_transaction_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_solana_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction via end user Solana account

Signs a transaction with the given end user Solana account and sends it to the indicated supported network. The API handles recent blockhash management and fee estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana.com/developers/guides/advanced/versions#current-transaction-versions) * [Versioned transactions](https://solana.com/developers/guides/advanced/versions) Instruction Batching To batch multiple operations, include multiple instructions within a single transaction. All instructions within a transaction are executed atomically - if any instruction fails, the entire transaction fails and is rolled back. Network Support The following Solana networks are supported: * solana - Solana Mainnet * solana-devnet - Solana Devnet The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_solana_transaction_with_end_user_account_request (SendSolanaTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SendSolanaTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async send_solana_transaction_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, send_solana_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction via end user Solana account

Signs a transaction with the given end user Solana account and sends it to the indicated supported network. The API handles recent blockhash management and fee estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana.com/developers/guides/advanced/versions#current-transaction-versions) * [Versioned transactions](https://solana.com/developers/guides/advanced/versions) Instruction Batching To batch multiple operations, include multiple instructions within a single transaction. All instructions within a transaction are executed atomically - if any instruction fails, the entire transaction fails and is rolled back. Network Support The following Solana networks are supported: * solana - Solana Mainnet * solana-devnet - Solana Devnet The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_solana_transaction_with_end_user_account_request (SendSolanaTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_user_operation_with_end_user_account(user_id, address, x_idempotency_key=None, x_wallet_auth=None, x_developer_auth=None, project_id=None, send_user_operation_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send user operation for end user Smart Account

Prepares, signs, and sends a user operation for an end user’s Smart Account.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The address of the EVM Smart Account to execute the user operation from. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_user_operation_with_end_user_account_request (SendUserOperationWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async send_user_operation_with_end_user_account_with_http_info(user_id, address, x_idempotency_key=None, x_wallet_auth=None, x_developer_auth=None, project_id=None, send_user_operation_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send user operation for end user Smart Account

Prepares, signs, and sends a user operation for an end user’s Smart Account.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The address of the EVM Smart Account to execute the user operation from. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_user_operation_with_end_user_account_request (SendUserOperationWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async send_user_operation_with_end_user_account_without_preload_content(user_id, address, x_idempotency_key=None, x_wallet_auth=None, x_developer_auth=None, project_id=None, send_user_operation_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send user operation for end user Smart Account

Prepares, signs, and sends a user operation for an end user’s Smart Account.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • address (str) – The address of the EVM Smart Account to execute the user operation from. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • send_user_operation_with_end_user_account_request (SendUserOperationWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_message_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_message_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-191 message via end user EVM account

Signs an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) message with the given end user EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed Message:n” + len(message)> before being signed.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_message_with_end_user_account_request (SignEvmMessageWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmMessageWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_evm_message_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_message_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-191 message via end user EVM account

Signs an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) message with the given end user EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed Message:n” + len(message)> before being signed.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_message_with_end_user_account_request (SignEvmMessageWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmMessageWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_evm_message_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_message_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-191 message via end user EVM account

Signs an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) message with the given end user EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed Message:n” + len(message)> before being signed.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_message_with_end_user_account_request (SignEvmMessageWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_transaction_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction via end user EVM account

Signs a transaction with the given end user EVM account. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_transaction_with_end_user_account_request (SignEvmTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_evm_transaction_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction via end user EVM account

Signs a transaction with the given end user EVM account. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_transaction_with_end_user_account_request (SignEvmTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_evm_transaction_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction via end user EVM account

Signs a transaction with the given end user EVM account. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_transaction_with_end_user_account_request (SignEvmTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_typed_data_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_typed_data_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-712 typed data via end user EVM account

Signs [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data with the given end user EVM account.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_typed_data_with_end_user_account_request (SignEvmTypedDataWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmTypedDataWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_evm_typed_data_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_typed_data_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-712 typed data via end user EVM account

Signs [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data with the given end user EVM account.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_typed_data_with_end_user_account_request (SignEvmTypedDataWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmTypedDataWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_evm_typed_data_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_evm_typed_data_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-712 typed data via end user EVM account

Signs [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data with the given end user EVM account.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_evm_typed_data_with_end_user_account_request (SignEvmTypedDataWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_solana_message_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_solana_message_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign Base64-encoded message

Signs an arbitrary Base64 encoded message with the given Solana account. WARNING: Never sign a message that you didn’t generate as it may put your funds at risk.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_solana_message_with_end_user_account_request (SignSolanaMessageWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignSolanaMessageWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_solana_message_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_solana_message_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign Base64-encoded message

Signs an arbitrary Base64 encoded message with the given Solana account. WARNING: Never sign a message that you didn’t generate as it may put your funds at risk.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_solana_message_with_end_user_account_request (SignSolanaMessageWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignSolanaMessageWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_solana_message_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_solana_message_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign Base64-encoded message

Signs an arbitrary Base64 encoded message with the given Solana account. WARNING: Never sign a message that you didn’t generate as it may put your funds at risk.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_solana_message_with_end_user_account_request (SignSolanaMessageWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_solana_transaction_with_end_user_account(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_solana_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction via end user Solana account

Signs a transaction with the given end user Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html) * [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html) The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_solana_transaction_with_end_user_account_request (SignSolanaTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignSolanaTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_solana_transaction_with_end_user_account_with_http_info(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_solana_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction via end user Solana account

Signs a transaction with the given end user Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html) * [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html) The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_solana_transaction_with_end_user_account_request (SignSolanaTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignSolanaTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_solana_transaction_with_end_user_account_without_preload_content(user_id, x_wallet_auth=None, x_idempotency_key=None, x_developer_auth=None, project_id=None, sign_solana_transaction_with_end_user_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction via end user Solana account

Signs a transaction with the given end user Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html) * [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html) The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • user_id (str) – The ID of the end user. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_developer_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

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

  • sign_solana_transaction_with_end_user_account_request (SignSolanaTransactionWithEndUserAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.evm_accounts_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.evm_accounts_api.EVMAccountsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_evm_account(x_wallet_auth=None, x_idempotency_key=None, create_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EVM account

Creates a new EVM account.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_evm_account_request (CreateEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmAccount

Returns:

Returns the result object.

async create_evm_account_with_http_info(x_wallet_auth=None, x_idempotency_key=None, create_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EVM account

Creates a new EVM account.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_evm_account_request (CreateEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmAccount]

Returns:

Returns the result object.

async create_evm_account_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, create_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EVM account

Creates a new EVM account.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_evm_account_request (CreateEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async create_evm_eip7702_delegation(address, create_evm_eip7702_delegation_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EIP-7702 delegation

Creates an EIP-7702 delegation for an EVM EOA account, upgrading it with smart account capabilities. This endpoint: - Retrieves delegation artifacts from onchain - Signs the EIP-7702 authorization for delegation - Assembles and submits a Type 4 transaction - Creates an associated smart account object The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account to delegate. (required)

  • create_evm_eip7702_delegation_request (CreateEvmEip7702DelegationRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

CreateEvmEip7702DelegationWithEndUserAccount201Response

Returns:

Returns the result object.

async create_evm_eip7702_delegation_with_http_info(address, create_evm_eip7702_delegation_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EIP-7702 delegation

Creates an EIP-7702 delegation for an EVM EOA account, upgrading it with smart account capabilities. This endpoint: - Retrieves delegation artifacts from onchain - Signs the EIP-7702 authorization for delegation - Assembles and submits a Type 4 transaction - Creates an associated smart account object The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account to delegate. (required)

  • create_evm_eip7702_delegation_request (CreateEvmEip7702DelegationRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[CreateEvmEip7702DelegationWithEndUserAccount201Response]

Returns:

Returns the result object.

async create_evm_eip7702_delegation_without_preload_content(address, create_evm_eip7702_delegation_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create EIP-7702 delegation

Creates an EIP-7702 delegation for an EVM EOA account, upgrading it with smart account capabilities. This endpoint: - Retrieves delegation artifacts from onchain - Signs the EIP-7702 authorization for delegation - Assembles and submits a Type 4 transaction - Creates an associated smart account object The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account to delegate. (required)

  • create_evm_eip7702_delegation_request (CreateEvmEip7702DelegationRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async export_evm_account(address, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export EVM account

Export an existing EVM account’s private key. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ExportEvmAccount200Response

Returns:

Returns the result object.

async export_evm_account_by_name(name, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export EVM account by name

Export an existing EVM account’s private key by its name. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • name (str) – The name of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ExportEvmAccount200Response

Returns:

Returns the result object.

async export_evm_account_by_name_with_http_info(name, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export EVM account by name

Export an existing EVM account’s private key by its name. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • name (str) – The name of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ExportEvmAccount200Response]

Returns:

Returns the result object.

async export_evm_account_by_name_without_preload_content(name, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export EVM account by name

Export an existing EVM account’s private key by its name. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • name (str) – The name of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async export_evm_account_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export EVM account

Export an existing EVM account’s private key. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ExportEvmAccount200Response]

Returns:

Returns the result object.

async export_evm_account_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export EVM account

Export an existing EVM account’s private key. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_evm_account(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EVM account by address

Gets an EVM account by its address.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmAccount

Returns:

Returns the result object.

async get_evm_account_by_name(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EVM account by name

Gets an EVM account by its name.

Parameters:
  • name (str) – The name of the EVM account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmAccount

Returns:

Returns the result object.

async get_evm_account_by_name_with_http_info(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EVM account by name

Gets an EVM account by its name.

Parameters:
  • name (str) – The name of the EVM account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmAccount]

Returns:

Returns the result object.

async get_evm_account_by_name_without_preload_content(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EVM account by name

Gets an EVM account by its name.

Parameters:
  • name (str) – The name of the EVM account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_evm_account_with_http_info(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EVM account by address

Gets an EVM account by its address.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmAccount]

Returns:

Returns the result object.

async get_evm_account_without_preload_content(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EVM account by address

Gets an EVM account by its address.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_evm_eip7702_delegation_operation_by_id(delegation_operation_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EIP-7702 delegation operation by ID

Returns the EIP-7702 delegation operation. Use the delegationOperationId returned by the Create EIP-7702 delegation endpoint to poll for operation completion.

Parameters:
  • delegation_operation_id (str) – The unique identifier for the delegation operation. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmEip7702DelegationOperation

Returns:

Returns the result object.

async get_evm_eip7702_delegation_operation_by_id_with_http_info(delegation_operation_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EIP-7702 delegation operation by ID

Returns the EIP-7702 delegation operation. Use the delegationOperationId returned by the Create EIP-7702 delegation endpoint to poll for operation completion.

Parameters:
  • delegation_operation_id (str) – The unique identifier for the delegation operation. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmEip7702DelegationOperation]

Returns:

Returns the result object.

async get_evm_eip7702_delegation_operation_by_id_without_preload_content(delegation_operation_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get EIP-7702 delegation operation by ID

Returns the EIP-7702 delegation operation. Use the delegationOperationId returned by the Create EIP-7702 delegation endpoint to poll for operation completion.

Parameters:
  • delegation_operation_id (str) – The unique identifier for the delegation operation. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async import_evm_account(x_wallet_auth=None, x_idempotency_key=None, import_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import EVM account

Import an existing EVM account into the developer’s CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_evm_account_request (ImportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmAccount

Returns:

Returns the result object.

async import_evm_account_with_http_info(x_wallet_auth=None, x_idempotency_key=None, import_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import EVM account

Import an existing EVM account into the developer’s CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_evm_account_request (ImportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmAccount]

Returns:

Returns the result object.

async import_evm_account_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, import_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import EVM account

Import an existing EVM account into the developer’s CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_evm_account_request (ImportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_evm_accounts(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM accounts

Lists the EVM accounts belonging to the developer’s CDP Project. The response is paginated, and by default, returns 20 accounts per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListEvmAccounts200Response

Returns:

Returns the result object.

async list_evm_accounts_with_http_info(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM accounts

Lists the EVM accounts belonging to the developer’s CDP Project. The response is paginated, and by default, returns 20 accounts per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListEvmAccounts200Response]

Returns:

Returns the result object.

async list_evm_accounts_without_preload_content(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM accounts

Lists the EVM accounts belonging to the developer’s CDP Project. The response is paginated, and by default, returns 20 accounts per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_evm_transaction(address, x_wallet_auth=None, x_idempotency_key=None, send_evm_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction

Signs a transaction with the given EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). Transaction fields and API behavior - to (Required): The address of the contract or account to send the transaction to. - chainId (Ignored): The value of the chainId field in the transaction is ignored. The transaction will be sent to the network indicated by the network field in the request body. - nonce (Optional): The nonce to use for the transaction. If not provided, the API will assign a nonce to the transaction based on the current state of the account. - maxPriorityFeePerGas (Optional): The maximum priority fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - maxFeePerGas (Optional): The maximum fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - gasLimit (Optional): The gas limit to use for the transaction. If not provided, the API will estimate a value based on the to and data fields of the transaction. - value (Optional): The amount of ETH, in wei, to send with the transaction. - data (Optional): The data to send with the transaction; only used for contract calls. - accessList (Optional): The access list to use for the transaction.

Parameters:
  • address (str) – The 0x-prefixed address of the Ethereum account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • send_evm_transaction_request (SendEvmTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SendEvmTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async send_evm_transaction_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, send_evm_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction

Signs a transaction with the given EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). Transaction fields and API behavior - to (Required): The address of the contract or account to send the transaction to. - chainId (Ignored): The value of the chainId field in the transaction is ignored. The transaction will be sent to the network indicated by the network field in the request body. - nonce (Optional): The nonce to use for the transaction. If not provided, the API will assign a nonce to the transaction based on the current state of the account. - maxPriorityFeePerGas (Optional): The maximum priority fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - maxFeePerGas (Optional): The maximum fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - gasLimit (Optional): The gas limit to use for the transaction. If not provided, the API will estimate a value based on the to and data fields of the transaction. - value (Optional): The amount of ETH, in wei, to send with the transaction. - data (Optional): The data to send with the transaction; only used for contract calls. - accessList (Optional): The access list to use for the transaction.

Parameters:
  • address (str) – The 0x-prefixed address of the Ethereum account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • send_evm_transaction_request (SendEvmTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SendEvmTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async send_evm_transaction_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, send_evm_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send transaction

Signs a transaction with the given EVM account and sends it to the indicated supported network. This API handles nonce management and gas estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). Transaction fields and API behavior - to (Required): The address of the contract or account to send the transaction to. - chainId (Ignored): The value of the chainId field in the transaction is ignored. The transaction will be sent to the network indicated by the network field in the request body. - nonce (Optional): The nonce to use for the transaction. If not provided, the API will assign a nonce to the transaction based on the current state of the account. - maxPriorityFeePerGas (Optional): The maximum priority fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - maxFeePerGas (Optional): The maximum fee per gas to use for the transaction. If not provided, the API will estimate a value based on current network conditions. - gasLimit (Optional): The gas limit to use for the transaction. If not provided, the API will estimate a value based on the to and data fields of the transaction. - value (Optional): The amount of ETH, in wei, to send with the transaction. - data (Optional): The data to send with the transaction; only used for contract calls. - accessList (Optional): The access list to use for the transaction.

Parameters:
  • address (str) – The 0x-prefixed address of the Ethereum account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • send_evm_transaction_request (SendEvmTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_hash(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_hash_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign hash

Signs an arbitrary 32 byte hash with the given EVM account.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_hash_request (SignEvmHashRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmHash200Response

Returns:

Returns the result object.

async sign_evm_hash_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_hash_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign hash

Signs an arbitrary 32 byte hash with the given EVM account.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_hash_request (SignEvmHashRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmHash200Response]

Returns:

Returns the result object.

async sign_evm_hash_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_hash_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign hash

Signs an arbitrary 32 byte hash with the given EVM account.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_hash_request (SignEvmHashRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_message(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_message_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-191 message

Signs an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) message with the given EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed Message:n” + len(message)> before being signed.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_message_request (SignEvmMessageRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmMessageWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_evm_message_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_message_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-191 message

Signs an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) message with the given EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed Message:n” + len(message)> before being signed.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_message_request (SignEvmMessageRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmMessageWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_evm_message_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_message_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-191 message

Signs an [EIP-191](https://eips.ethereum.org/EIPS/eip-191) message with the given EVM account. Per the specification, the message in the request body is prepended with 0x19 <0x45 (E)> <thereum Signed Message:n” + len(message)> before being signed.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_message_request (SignEvmMessageRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_transaction(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction

Signs a transaction with the given EVM account. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_transaction_request (SignEvmTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_evm_transaction_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction

Signs a transaction with the given EVM account. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_transaction_request (SignEvmTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_evm_transaction_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, sign_evm_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction

Signs a transaction with the given EVM account. The transaction should be serialized as a hex string using [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/). The transaction must be an [EIP-1559 dynamic fee transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_evm_transaction_request (SignEvmTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_evm_typed_data(address, x_wallet_auth=None, x_idempotency_key=None, eip712_message=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-712 typed data

Signs [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data with the given EVM account.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • eip712_message (EIP712Message)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignEvmTypedDataWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_evm_typed_data_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, eip712_message=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-712 typed data

Signs [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data with the given EVM account.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • eip712_message (EIP712Message)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignEvmTypedDataWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_evm_typed_data_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, eip712_message=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign EIP-712 typed data

Signs [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data with the given EVM account.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • eip712_message (EIP712Message)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async update_evm_account(address, x_idempotency_key=None, update_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update EVM account

Updates an existing EVM account. Use this to update the account’s name or account-level policy.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • update_evm_account_request (UpdateEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmAccount

Returns:

Returns the result object.

async update_evm_account_with_http_info(address, x_idempotency_key=None, update_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update EVM account

Updates an existing EVM account. Use this to update the account’s name or account-level policy.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • update_evm_account_request (UpdateEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmAccount]

Returns:

Returns the result object.

async update_evm_account_without_preload_content(address, x_idempotency_key=None, update_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update EVM account

Updates an existing EVM account. Use this to update the account’s name or account-level policy.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM account. The address does not need to be checksummed. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • update_evm_account_request (UpdateEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.evm_smart_accounts_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.evm_smart_accounts_api.EVMSmartAccountsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_evm_smart_account(x_idempotency_key=None, create_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create Smart Account

Creates a new Smart Account.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_evm_smart_account_request (CreateEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmSmartAccount

Returns:

Returns the result object.

async create_evm_smart_account_with_http_info(x_idempotency_key=None, create_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create Smart Account

Creates a new Smart Account.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_evm_smart_account_request (CreateEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmSmartAccount]

Returns:

Returns the result object.

async create_evm_smart_account_without_preload_content(x_idempotency_key=None, create_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create Smart Account

Creates a new Smart Account.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_evm_smart_account_request (CreateEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async create_spend_permission(address, create_spend_permission_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create spend permission

Creates a spend permission for the given smart account address.

Parameters:
  • address (str) – The address of the Smart Account to create the spend permission for. (required)

  • create_spend_permission_request (CreateSpendPermissionRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async create_spend_permission_with_http_info(address, create_spend_permission_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create spend permission

Creates a spend permission for the given smart account address.

Parameters:
  • address (str) – The address of the Smart Account to create the spend permission for. (required)

  • create_spend_permission_request (CreateSpendPermissionRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async create_spend_permission_without_preload_content(address, create_spend_permission_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create spend permission

Creates a spend permission for the given smart account address.

Parameters:
  • address (str) – The address of the Smart Account to create the spend permission for. (required)

  • create_spend_permission_request (CreateSpendPermissionRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_evm_smart_account(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Smart Account by address

Gets a Smart Account by its address.

Parameters:
  • address (str) – The 0x-prefixed address of the Smart Account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmSmartAccount

Returns:

Returns the result object.

async get_evm_smart_account_by_name(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Smart Account by name

Gets a Smart Account by its name.

Parameters:
  • name (str) – The name of the Smart Account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmSmartAccount

Returns:

Returns the result object.

async get_evm_smart_account_by_name_with_http_info(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Smart Account by name

Gets a Smart Account by its name.

Parameters:
  • name (str) – The name of the Smart Account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmSmartAccount]

Returns:

Returns the result object.

async get_evm_smart_account_by_name_without_preload_content(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Smart Account by name

Gets a Smart Account by its name.

Parameters:
  • name (str) – The name of the Smart Account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_evm_smart_account_with_http_info(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Smart Account by address

Gets a Smart Account by its address.

Parameters:
  • address (str) – The 0x-prefixed address of the Smart Account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmSmartAccount]

Returns:

Returns the result object.

async get_evm_smart_account_without_preload_content(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Smart Account by address

Gets a Smart Account by its address.

Parameters:
  • address (str) – The 0x-prefixed address of the Smart Account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_user_operation(address, user_op_hash, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get user operation

Gets a user operation by its hash.

Parameters:
  • address (str) – The address of the Smart Account the user operation belongs to. (required)

  • user_op_hash (str) – The hash of the user operation to fetch. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async get_user_operation_with_http_info(address, user_op_hash, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get user operation

Gets a user operation by its hash.

Parameters:
  • address (str) – The address of the Smart Account the user operation belongs to. (required)

  • user_op_hash (str) – The hash of the user operation to fetch. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async get_user_operation_without_preload_content(address, user_op_hash, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get user operation

Gets a user operation by its hash.

Parameters:
  • address (str) – The address of the Smart Account the user operation belongs to. (required)

  • user_op_hash (str) – The hash of the user operation to fetch. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_evm_smart_accounts(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Smart Accounts

Lists the Smart Accounts belonging to the developer’s CDP Project. The response is paginated, and by default, returns 20 accounts per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListEvmSmartAccounts200Response

Returns:

Returns the result object.

async list_evm_smart_accounts_with_http_info(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Smart Accounts

Lists the Smart Accounts belonging to the developer’s CDP Project. The response is paginated, and by default, returns 20 accounts per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListEvmSmartAccounts200Response]

Returns:

Returns the result object.

async list_evm_smart_accounts_without_preload_content(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Smart Accounts

Lists the Smart Accounts belonging to the developer’s CDP Project. The response is paginated, and by default, returns 20 accounts per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_spend_permissions(address, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List spend permissions

Lists spend permission for the given smart account address.

Parameters:
  • address (str) – The address of the Smart account to list spend permissions for. (required)

  • page_size (int) – The number of spend permissions to return per page.

  • page_token (str) – The token for the next page of spend permissions. Will be empty if there are no more spend permissions to fetch.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListSpendPermissions200Response

Returns:

Returns the result object.

async list_spend_permissions_with_http_info(address, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List spend permissions

Lists spend permission for the given smart account address.

Parameters:
  • address (str) – The address of the Smart account to list spend permissions for. (required)

  • page_size (int) – The number of spend permissions to return per page.

  • page_token (str) – The token for the next page of spend permissions. Will be empty if there are no more spend permissions to fetch.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListSpendPermissions200Response]

Returns:

Returns the result object.

async list_spend_permissions_without_preload_content(address, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List spend permissions

Lists spend permission for the given smart account address.

Parameters:
  • address (str) – The address of the Smart account to list spend permissions for. (required)

  • page_size (int) – The number of spend permissions to return per page.

  • page_token (str) – The token for the next page of spend permissions. Will be empty if there are no more spend permissions to fetch.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async prepare_and_send_user_operation(address, x_idempotency_key=None, x_wallet_auth=None, prepare_and_send_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Prepare and send user operation

Prepares, signs, and sends a user operation for an EVM Smart Account. This API can be used only if the owner on Smart Account is a CDP EVM Account.

Parameters:
  • address (str) – The address of the EVM Smart Account to execute the user operation from. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • prepare_and_send_user_operation_request (PrepareAndSendUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async prepare_and_send_user_operation_with_http_info(address, x_idempotency_key=None, x_wallet_auth=None, prepare_and_send_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Prepare and send user operation

Prepares, signs, and sends a user operation for an EVM Smart Account. This API can be used only if the owner on Smart Account is a CDP EVM Account.

Parameters:
  • address (str) – The address of the EVM Smart Account to execute the user operation from. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • prepare_and_send_user_operation_request (PrepareAndSendUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async prepare_and_send_user_operation_without_preload_content(address, x_idempotency_key=None, x_wallet_auth=None, prepare_and_send_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Prepare and send user operation

Prepares, signs, and sends a user operation for an EVM Smart Account. This API can be used only if the owner on Smart Account is a CDP EVM Account.

Parameters:
  • address (str) – The address of the EVM Smart Account to execute the user operation from. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • prepare_and_send_user_operation_request (PrepareAndSendUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async prepare_user_operation(address, prepare_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Prepare user operation

Prepares a new user operation on a Smart Account for a specific network.

Parameters:
  • address (str) – The address of the Smart Account to create the user operation on. (required)

  • prepare_user_operation_request (PrepareUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async prepare_user_operation_with_http_info(address, prepare_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Prepare user operation

Prepares a new user operation on a Smart Account for a specific network.

Parameters:
  • address (str) – The address of the Smart Account to create the user operation on. (required)

  • prepare_user_operation_request (PrepareUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async prepare_user_operation_without_preload_content(address, prepare_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Prepare user operation

Prepares a new user operation on a Smart Account for a specific network.

Parameters:
  • address (str) – The address of the Smart Account to create the user operation on. (required)

  • prepare_user_operation_request (PrepareUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async revoke_spend_permission(address, revoke_spend_permission_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke spend permission

Revokes an existing spend permission.

Parameters:
  • address (str) – The address of the Smart account this spend permission is valid for. (required)

  • revoke_spend_permission_request (RevokeSpendPermissionRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async revoke_spend_permission_with_http_info(address, revoke_spend_permission_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke spend permission

Revokes an existing spend permission.

Parameters:
  • address (str) – The address of the Smart account this spend permission is valid for. (required)

  • revoke_spend_permission_request (RevokeSpendPermissionRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async revoke_spend_permission_without_preload_content(address, revoke_spend_permission_request, x_wallet_auth=None, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Revoke spend permission

Revokes an existing spend permission.

Parameters:
  • address (str) – The address of the Smart account this spend permission is valid for. (required)

  • revoke_spend_permission_request (RevokeSpendPermissionRequest) – (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_user_operation(address, user_op_hash, send_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send user operation

Sends a user operation with a signature. The payload to sign must be the userOpHash field of the user operation. This hash should be signed directly (not using personal_sign or EIP-191 message hashing). The signature must be 65 bytes in length, consisting of: - 32 bytes for the r value - 32 bytes for the s value - 1 byte for the v value (must be 27 or 28) If using the CDP Paymaster, the user operation must be signed and sent within 2 minutes of being prepared.

Parameters:
  • address (str) – The address of the Smart Account to send the user operation from. (required)

  • user_op_hash (str) – The hash of the user operation to send. (required)

  • send_user_operation_request (SendUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmUserOperation

Returns:

Returns the result object.

async send_user_operation_with_http_info(address, user_op_hash, send_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send user operation

Sends a user operation with a signature. The payload to sign must be the userOpHash field of the user operation. This hash should be signed directly (not using personal_sign or EIP-191 message hashing). The signature must be 65 bytes in length, consisting of: - 32 bytes for the r value - 32 bytes for the s value - 1 byte for the v value (must be 27 or 28) If using the CDP Paymaster, the user operation must be signed and sent within 2 minutes of being prepared.

Parameters:
  • address (str) – The address of the Smart Account to send the user operation from. (required)

  • user_op_hash (str) – The hash of the user operation to send. (required)

  • send_user_operation_request (SendUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmUserOperation]

Returns:

Returns the result object.

async send_user_operation_without_preload_content(address, user_op_hash, send_user_operation_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send user operation

Sends a user operation with a signature. The payload to sign must be the userOpHash field of the user operation. This hash should be signed directly (not using personal_sign or EIP-191 message hashing). The signature must be 65 bytes in length, consisting of: - 32 bytes for the r value - 32 bytes for the s value - 1 byte for the v value (must be 27 or 28) If using the CDP Paymaster, the user operation must be signed and sent within 2 minutes of being prepared.

Parameters:
  • address (str) – The address of the Smart Account to send the user operation from. (required)

  • user_op_hash (str) – The hash of the user operation to send. (required)

  • send_user_operation_request (SendUserOperationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async update_evm_smart_account(address, update_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update EVM Smart Account

Updates an existing EVM smart account. Use this to update the smart account’s name.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM smart account. The address does not need to be checksummed. (required)

  • update_evm_smart_account_request (UpdateEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

EvmSmartAccount

Returns:

Returns the result object.

async update_evm_smart_account_with_http_info(address, update_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update EVM Smart Account

Updates an existing EVM smart account. Use this to update the smart account’s name.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM smart account. The address does not need to be checksummed. (required)

  • update_evm_smart_account_request (UpdateEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[EvmSmartAccount]

Returns:

Returns the result object.

async update_evm_smart_account_without_preload_content(address, update_evm_smart_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update EVM Smart Account

Updates an existing EVM smart account. Use this to update the smart account’s name.

Parameters:
  • address (str) – The 0x-prefixed address of the EVM smart account. The address does not need to be checksummed. (required)

  • update_evm_smart_account_request (UpdateEvmSmartAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.evm_swaps_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.evm_swaps_api.EVMSwapsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_evm_swap_quote(create_evm_swap_quote_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create swap quote

Create a swap quote, which includes the payload to sign as well as the transaction data needed to execute the swap. The developer is responsible for signing the payload and submitting the transaction to the network in order to execute the swap.

Parameters:
  • create_evm_swap_quote_request (CreateEvmSwapQuoteRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

CreateSwapQuoteResponseWrapper

Returns:

Returns the result object.

async create_evm_swap_quote_with_http_info(create_evm_swap_quote_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create swap quote

Create a swap quote, which includes the payload to sign as well as the transaction data needed to execute the swap. The developer is responsible for signing the payload and submitting the transaction to the network in order to execute the swap.

Parameters:
  • create_evm_swap_quote_request (CreateEvmSwapQuoteRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[CreateSwapQuoteResponseWrapper]

Returns:

Returns the result object.

async create_evm_swap_quote_without_preload_content(create_evm_swap_quote_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create swap quote

Create a swap quote, which includes the payload to sign as well as the transaction data needed to execute the swap. The developer is responsible for signing the payload and submitting the transaction to the network in order to execute the swap.

Parameters:
  • create_evm_swap_quote_request (CreateEvmSwapQuoteRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_evm_swap_price(network, to_token, from_token, from_amount, taker, signer_address=None, gas_price=None, slippage_bps=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get swap price estimate

Get a price estimate for a swap between two tokens on an EVM network.

Parameters:
  • network (EvmSwapsNetwork) – (required)

  • to_token (str) – (required)

  • from_token (str) – (required)

  • from_amount (str) – (required)

  • taker (str) – (required)

  • signer_address (str)

  • gas_price (str)

  • slippage_bps (int)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetSwapPriceResponseWrapper

Returns:

Returns the result object.

async get_evm_swap_price_with_http_info(network, to_token, from_token, from_amount, taker, signer_address=None, gas_price=None, slippage_bps=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get swap price estimate

Get a price estimate for a swap between two tokens on an EVM network.

Parameters:
  • network (EvmSwapsNetwork) – (required)

  • to_token (str) – (required)

  • from_token (str) – (required)

  • from_amount (str) – (required)

  • taker (str) – (required)

  • signer_address (str)

  • gas_price (str)

  • slippage_bps (int)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[GetSwapPriceResponseWrapper]

Returns:

Returns the result object.

async get_evm_swap_price_without_preload_content(network, to_token, from_token, from_amount, taker, signer_address=None, gas_price=None, slippage_bps=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get swap price estimate

Get a price estimate for a swap between two tokens on an EVM network.

Parameters:
  • network (EvmSwapsNetwork) – (required)

  • to_token (str) – (required)

  • from_token (str) – (required)

  • from_amount (str) – (required)

  • taker (str) – (required)

  • signer_address (str)

  • gas_price (str)

  • slippage_bps (int)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.evm_token_balances_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.evm_token_balances_api.EVMTokenBalancesApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async list_evm_token_balances(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM token balances

Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page. Note: This endpoint is still under development and does not yet provide strong freshness guarantees. Specifically, balances of new tokens can, on occasion, take up to ~30 seconds to appear, while balances of tokens already belonging to an address will generally be close to chain tip. Freshness of new token balances will improve over the coming weeks.

Parameters:
  • address (str) – The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed. (required)

  • network (ListEvmTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListEvmTokenBalances200Response

Returns:

Returns the result object.

async list_evm_token_balances_with_http_info(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM token balances

Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page. Note: This endpoint is still under development and does not yet provide strong freshness guarantees. Specifically, balances of new tokens can, on occasion, take up to ~30 seconds to appear, while balances of tokens already belonging to an address will generally be close to chain tip. Freshness of new token balances will improve over the coming weeks.

Parameters:
  • address (str) – The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed. (required)

  • network (ListEvmTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListEvmTokenBalances200Response]

Returns:

Returns the result object.

async list_evm_token_balances_without_preload_content(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM token balances

Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page. Note: This endpoint is still under development and does not yet provide strong freshness guarantees. Specifically, balances of new tokens can, on occasion, take up to ~30 seconds to appear, while balances of tokens already belonging to an address will generally be close to chain tip. Freshness of new token balances will improve over the coming weeks.

Parameters:
  • address (str) – The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed. (required)

  • network (ListEvmTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.faucets_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.faucets_api.FaucetsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async request_evm_faucet(request_evm_faucet_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request funds on EVM test networks

Request funds from the CDP Faucet on supported EVM test networks. Faucets are available for ETH, USDC, EURC, and cbBTC on Base Sepolia and Ethereum Sepolia, and for ETH only on Ethereum Hoodi. To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested. These limits are applied at both the CDP User level and the blockchain address level. A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address. | Token | Amount per Faucet Request |Rolling 24-hour window Rate Limits| |:-----:|:————————-:|:--------------------------------:| | ETH | 0.0001 ETH | 0.1 ETH | | USDC | 1 USDC | 10 USDC | | EURC | 1 EURC | 10 EURC | | cbBTC | 0.0001 cbBTC | 0.001 cbBTC |

Parameters:
  • request_evm_faucet_request (RequestEvmFaucetRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

RequestEvmFaucet200Response

Returns:

Returns the result object.

async request_evm_faucet_with_http_info(request_evm_faucet_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request funds on EVM test networks

Request funds from the CDP Faucet on supported EVM test networks. Faucets are available for ETH, USDC, EURC, and cbBTC on Base Sepolia and Ethereum Sepolia, and for ETH only on Ethereum Hoodi. To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested. These limits are applied at both the CDP User level and the blockchain address level. A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address. | Token | Amount per Faucet Request |Rolling 24-hour window Rate Limits| |:-----:|:————————-:|:--------------------------------:| | ETH | 0.0001 ETH | 0.1 ETH | | USDC | 1 USDC | 10 USDC | | EURC | 1 EURC | 10 EURC | | cbBTC | 0.0001 cbBTC | 0.001 cbBTC |

Parameters:
  • request_evm_faucet_request (RequestEvmFaucetRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[RequestEvmFaucet200Response]

Returns:

Returns the result object.

async request_evm_faucet_without_preload_content(request_evm_faucet_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request funds on EVM test networks

Request funds from the CDP Faucet on supported EVM test networks. Faucets are available for ETH, USDC, EURC, and cbBTC on Base Sepolia and Ethereum Sepolia, and for ETH only on Ethereum Hoodi. To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested. These limits are applied at both the CDP User level and the blockchain address level. A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address. | Token | Amount per Faucet Request |Rolling 24-hour window Rate Limits| |:-----:|:————————-:|:--------------------------------:| | ETH | 0.0001 ETH | 0.1 ETH | | USDC | 1 USDC | 10 USDC | | EURC | 1 EURC | 10 EURC | | cbBTC | 0.0001 cbBTC | 0.001 cbBTC |

Parameters:
  • request_evm_faucet_request (RequestEvmFaucetRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async request_solana_faucet(request_solana_faucet_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request funds on Solana devnet

Request funds from the CDP Faucet on Solana devnet. Faucets are available for SOL, USDC, and CBTUSD. To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested. These limits are applied at both the CDP Project level and the blockchain address level. A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address. | Token | Amount per Faucet Request |Rolling 24-hour window Rate Limits| |:-----: |:-------------------------:|:——————————–:| | SOL | 0.00125 SOL | 0.0125 SOL | | USDC | 1 USDC | 10 USDC | | CBTUSD | 1 CBTUSD | 10 CBTUSD |

Parameters:
  • request_solana_faucet_request (RequestSolanaFaucetRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

RequestSolanaFaucet200Response

Returns:

Returns the result object.

async request_solana_faucet_with_http_info(request_solana_faucet_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request funds on Solana devnet

Request funds from the CDP Faucet on Solana devnet. Faucets are available for SOL, USDC, and CBTUSD. To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested. These limits are applied at both the CDP Project level and the blockchain address level. A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address. | Token | Amount per Faucet Request |Rolling 24-hour window Rate Limits| |:-----: |:-------------------------:|:——————————–:| | SOL | 0.00125 SOL | 0.0125 SOL | | USDC | 1 USDC | 10 USDC | | CBTUSD | 1 CBTUSD | 10 CBTUSD |

Parameters:
  • request_solana_faucet_request (RequestSolanaFaucetRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[RequestSolanaFaucet200Response]

Returns:

Returns the result object.

async request_solana_faucet_without_preload_content(request_solana_faucet_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request funds on Solana devnet

Request funds from the CDP Faucet on Solana devnet. Faucets are available for SOL, USDC, and CBTUSD. To prevent abuse, we enforce rate limits within a rolling 24-hour window to control the amount of funds that can be requested. These limits are applied at both the CDP Project level and the blockchain address level. A single blockchain address cannot exceed the specified limits, even if multiple users submit requests to the same address. | Token | Amount per Faucet Request |Rolling 24-hour window Rate Limits| |:-----: |:-------------------------:|:——————————–:| | SOL | 0.00125 SOL | 0.0125 SOL | | USDC | 1 USDC | 10 USDC | | CBTUSD | 1 CBTUSD | 10 CBTUSD |

Parameters:
  • request_solana_faucet_request (RequestSolanaFaucetRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.onchain_data_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.onchain_data_api.OnchainDataApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async list_data_token_balances(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM token balances

Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page. Note: This endpoint provides <1 second freshness from chain tip, <500ms response latency for wallets with reasonable token history, and 99.9% uptime for production use.

Parameters:
  • address (str) – The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed. (required)

  • network (ListEvmTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListEvmTokenBalances200Response

Returns:

Returns the result object.

async list_data_token_balances_with_http_info(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM token balances

Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page. Note: This endpoint provides <1 second freshness from chain tip, <500ms response latency for wallets with reasonable token history, and 99.9% uptime for production use.

Parameters:
  • address (str) – The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed. (required)

  • network (ListEvmTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListEvmTokenBalances200Response]

Returns:

Returns the result object.

async list_data_token_balances_without_preload_content(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List EVM token balances

Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page. Note: This endpoint provides <1 second freshness from chain tip, <500ms response latency for wallets with reasonable token history, and 99.9% uptime for production use.

Parameters:
  • address (str) – The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed. (required)

  • network (ListEvmTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_tokens_for_account(network, address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List token addresses for account

Retrieve all ERC-20 token contract addresses that an account has ever received tokens from. Analyzes transaction history to discover token interactions.

Parameters:
  • network (str) – The blockchain network to query. (required)

  • address (str) – The account address to analyze for token interactions. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

AccountTokenAddressesResponse

Returns:

Returns the result object.

async list_tokens_for_account_with_http_info(network, address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List token addresses for account

Retrieve all ERC-20 token contract addresses that an account has ever received tokens from. Analyzes transaction history to discover token interactions.

Parameters:
  • network (str) – The blockchain network to query. (required)

  • address (str) – The account address to analyze for token interactions. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[AccountTokenAddressesResponse]

Returns:

Returns the result object.

async list_tokens_for_account_without_preload_content(network, address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List token addresses for account

Retrieve all ERC-20 token contract addresses that an account has ever received tokens from. Analyzes transaction history to discover token interactions.

Parameters:
  • network (str) – The blockchain network to query. (required)

  • address (str) – The account address to analyze for token interactions. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.onramp_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.onramp_api.OnrampApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_onramp_order(create_onramp_order_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create an onramp order

Create a new Onramp order or get a quote for an Onramp order. Either paymentAmount or purchaseAmount must be provided. This API currently only supports the payment method GUEST_CHECKOUT_APPLE_PAY. For detailed integration instructions and to get access to this API, refer to the [Apple Pay Onramp API docs](https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/apple-pay-onramp-api).

Parameters:
  • create_onramp_order_request (CreateOnrampOrderRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

CreateOnrampOrder201Response

Returns:

Returns the result object.

async create_onramp_order_with_http_info(create_onramp_order_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create an onramp order

Create a new Onramp order or get a quote for an Onramp order. Either paymentAmount or purchaseAmount must be provided. This API currently only supports the payment method GUEST_CHECKOUT_APPLE_PAY. For detailed integration instructions and to get access to this API, refer to the [Apple Pay Onramp API docs](https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/apple-pay-onramp-api).

Parameters:
  • create_onramp_order_request (CreateOnrampOrderRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[CreateOnrampOrder201Response]

Returns:

Returns the result object.

async create_onramp_order_without_preload_content(create_onramp_order_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create an onramp order

Create a new Onramp order or get a quote for an Onramp order. Either paymentAmount or purchaseAmount must be provided. This API currently only supports the payment method GUEST_CHECKOUT_APPLE_PAY. For detailed integration instructions and to get access to this API, refer to the [Apple Pay Onramp API docs](https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/apple-pay-onramp-api).

Parameters:
  • create_onramp_order_request (CreateOnrampOrderRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async create_onramp_session(onramp_session_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create an onramp session

Returns a single-use URL for an Onramp session. This API provides flexible functionality based on the parameters provided, supporting three cases: Important: The returned URL is single-use only. Once a user visits the URL, no one else can access it. ## Use Cases ### 1. Basic Session (Minimum Parameters) Required: destinationAddress, purchaseCurrency, destinationNetwork Returns: Basic single-use onramp URL. The quote object will not be included in the response. ### 2. One-Click Onramp URL Required: Basic parameters + (paymentAmount OR purchaseAmount), paymentCurrency Returns: One-click onramp URL for streamlined checkout. The quote object will not be included in the response. ### 3. One-Click Onramp URL with Quote Required: One-Click Onramp parameters + paymentMethod, country, subdivision Returns: Complete pricing quote and one-click onramp URL. Both session and quote objects will be included in the response. Note: Only one of paymentAmount or purchaseAmount should be provided, not both. Providing both will result in an error. When paymentAmount is provided, the quote shows how much crypto the user will receive for the specified fiat amount (fee-inclusive). When purchaseAmount is provided, the quote shows how much fiat the user needs to pay for the specified crypto amount (fee-exclusive).

Parameters:
  • onramp_session_request (OnrampSessionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

CreateOnrampSession201Response

Returns:

Returns the result object.

async create_onramp_session_with_http_info(onramp_session_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create an onramp session

Returns a single-use URL for an Onramp session. This API provides flexible functionality based on the parameters provided, supporting three cases: Important: The returned URL is single-use only. Once a user visits the URL, no one else can access it. ## Use Cases ### 1. Basic Session (Minimum Parameters) Required: destinationAddress, purchaseCurrency, destinationNetwork Returns: Basic single-use onramp URL. The quote object will not be included in the response. ### 2. One-Click Onramp URL Required: Basic parameters + (paymentAmount OR purchaseAmount), paymentCurrency Returns: One-click onramp URL for streamlined checkout. The quote object will not be included in the response. ### 3. One-Click Onramp URL with Quote Required: One-Click Onramp parameters + paymentMethod, country, subdivision Returns: Complete pricing quote and one-click onramp URL. Both session and quote objects will be included in the response. Note: Only one of paymentAmount or purchaseAmount should be provided, not both. Providing both will result in an error. When paymentAmount is provided, the quote shows how much crypto the user will receive for the specified fiat amount (fee-inclusive). When purchaseAmount is provided, the quote shows how much fiat the user needs to pay for the specified crypto amount (fee-exclusive).

Parameters:
  • onramp_session_request (OnrampSessionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[CreateOnrampSession201Response]

Returns:

Returns the result object.

async create_onramp_session_without_preload_content(onramp_session_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create an onramp session

Returns a single-use URL for an Onramp session. This API provides flexible functionality based on the parameters provided, supporting three cases: Important: The returned URL is single-use only. Once a user visits the URL, no one else can access it. ## Use Cases ### 1. Basic Session (Minimum Parameters) Required: destinationAddress, purchaseCurrency, destinationNetwork Returns: Basic single-use onramp URL. The quote object will not be included in the response. ### 2. One-Click Onramp URL Required: Basic parameters + (paymentAmount OR purchaseAmount), paymentCurrency Returns: One-click onramp URL for streamlined checkout. The quote object will not be included in the response. ### 3. One-Click Onramp URL with Quote Required: One-Click Onramp parameters + paymentMethod, country, subdivision Returns: Complete pricing quote and one-click onramp URL. Both session and quote objects will be included in the response. Note: Only one of paymentAmount or purchaseAmount should be provided, not both. Providing both will result in an error. When paymentAmount is provided, the quote shows how much crypto the user will receive for the specified fiat amount (fee-inclusive). When purchaseAmount is provided, the quote shows how much fiat the user needs to pay for the specified crypto amount (fee-exclusive).

Parameters:
  • onramp_session_request (OnrampSessionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_onramp_order_by_id(order_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get an onramp order by ID

Get an onramp order by ID.

Parameters:
  • order_id (str) – The ID of the onramp order to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetOnrampOrderById200Response

Returns:

Returns the result object.

async get_onramp_order_by_id_with_http_info(order_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get an onramp order by ID

Get an onramp order by ID.

Parameters:
  • order_id (str) – The ID of the onramp order to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[GetOnrampOrderById200Response]

Returns:

Returns the result object.

async get_onramp_order_by_id_without_preload_content(order_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get an onramp order by ID

Get an onramp order by ID.

Parameters:
  • order_id (str) – The ID of the onramp order to retrieve. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_onramp_user_limits(get_onramp_user_limits_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get onramp user limits

Returns the transaction limits for an onramp user based on their payment method and user identifier. Use this API to show users their remaining purchase capacity before initiating an onramp transaction. Currently supports GUEST_CHECKOUT_APPLE_PAY payment method with phone number identification. The phone number must have been previously verified via OTP.

Parameters:
  • get_onramp_user_limits_request (GetOnrampUserLimitsRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

GetOnrampUserLimits200Response

Returns:

Returns the result object.

async get_onramp_user_limits_with_http_info(get_onramp_user_limits_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get onramp user limits

Returns the transaction limits for an onramp user based on their payment method and user identifier. Use this API to show users their remaining purchase capacity before initiating an onramp transaction. Currently supports GUEST_CHECKOUT_APPLE_PAY payment method with phone number identification. The phone number must have been previously verified via OTP.

Parameters:
  • get_onramp_user_limits_request (GetOnrampUserLimitsRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[GetOnrampUserLimits200Response]

Returns:

Returns the result object.

async get_onramp_user_limits_without_preload_content(get_onramp_user_limits_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get onramp user limits

Returns the transaction limits for an onramp user based on their payment method and user identifier. Use this API to show users their remaining purchase capacity before initiating an onramp transaction. Currently supports GUEST_CHECKOUT_APPLE_PAY payment method with phone number identification. The phone number must have been previously verified via OTP.

Parameters:
  • get_onramp_user_limits_request (GetOnrampUserLimitsRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async initiate_onramp_verification(x_idempotency_key=None, initiate_onramp_verification_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Initiate onramp verification

Initiates OTP verification by sending a 6-digit code to the user via the specified channel (SMS or email). Returns a verificationId that must be passed to the Submit Onramp Verification endpoint along with the OTP code within 10 minutes. Access to this API requires allowlisting. During Onramp Headless API onboarding, contact the Onramp team to enable Onramp-managed verification for your application.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • initiate_onramp_verification_request (InitiateOnrampVerificationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

OnrampVerificationInitiation

Returns:

Returns the result object.

async initiate_onramp_verification_with_http_info(x_idempotency_key=None, initiate_onramp_verification_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Initiate onramp verification

Initiates OTP verification by sending a 6-digit code to the user via the specified channel (SMS or email). Returns a verificationId that must be passed to the Submit Onramp Verification endpoint along with the OTP code within 10 minutes. Access to this API requires allowlisting. During Onramp Headless API onboarding, contact the Onramp team to enable Onramp-managed verification for your application.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • initiate_onramp_verification_request (InitiateOnrampVerificationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[OnrampVerificationInitiation]

Returns:

Returns the result object.

async initiate_onramp_verification_without_preload_content(x_idempotency_key=None, initiate_onramp_verification_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Initiate onramp verification

Initiates OTP verification by sending a 6-digit code to the user via the specified channel (SMS or email). Returns a verificationId that must be passed to the Submit Onramp Verification endpoint along with the OTP code within 10 minutes. Access to this API requires allowlisting. During Onramp Headless API onboarding, contact the Onramp team to enable Onramp-managed verification for your application.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • initiate_onramp_verification_request (InitiateOnrampVerificationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async request_limits_upgrade(onramp_limit_upgrade_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request limit upgrade

Requests a limit upgrade for an onramp user by submitting identity information. Only phone number is currently supported as a userId. The verification process is asynchronous. After calling this endpoint, use the [Get Onramp User Limits](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/get-onramp-user-limits) endpoint to check the status in the limitUpgradeOptions array. Prerequisites: - The phone number must have been previously verified by your app via OTP. - Upgrades may not be available until a certain number of successful transactions by the user. Supported fields: - ssnLast4: Last 4 digits of the Social Security Number (no dashes or spaces). - dateOfBirth: Date of birth (day, month, year as zero-padded strings).

Parameters:
  • onramp_limit_upgrade_request (OnrampLimitUpgradeRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

None

Returns:

Returns the result object.

async request_limits_upgrade_with_http_info(onramp_limit_upgrade_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request limit upgrade

Requests a limit upgrade for an onramp user by submitting identity information. Only phone number is currently supported as a userId. The verification process is asynchronous. After calling this endpoint, use the [Get Onramp User Limits](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/get-onramp-user-limits) endpoint to check the status in the limitUpgradeOptions array. Prerequisites: - The phone number must have been previously verified by your app via OTP. - Upgrades may not be available until a certain number of successful transactions by the user. Supported fields: - ssnLast4: Last 4 digits of the Social Security Number (no dashes or spaces). - dateOfBirth: Date of birth (day, month, year as zero-padded strings).

Parameters:
  • onramp_limit_upgrade_request (OnrampLimitUpgradeRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[NoneType]

Returns:

Returns the result object.

async request_limits_upgrade_without_preload_content(onramp_limit_upgrade_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Request limit upgrade

Requests a limit upgrade for an onramp user by submitting identity information. Only phone number is currently supported as a userId. The verification process is asynchronous. After calling this endpoint, use the [Get Onramp User Limits](https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/get-onramp-user-limits) endpoint to check the status in the limitUpgradeOptions array. Prerequisites: - The phone number must have been previously verified by your app via OTP. - Upgrades may not be available until a certain number of successful transactions by the user. Supported fields: - ssnLast4: Last 4 digits of the Social Security Number (no dashes or spaces). - dateOfBirth: Date of birth (day, month, year as zero-padded strings).

Parameters:
  • onramp_limit_upgrade_request (OnrampLimitUpgradeRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async submit_onramp_verification(verification_id, x_idempotency_key=None, submit_onramp_verification_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Submit onramp verification

Submits the OTP code to complete verification. On success, marks the verification as verified and returns the same verificationId. The destination does not need to be re-sent. Onramp uses the value captured at initiation time. The returned verificationId should be stored on the user’s device and passed to the Create Onramp Order endpoint. It is valid for 60 days. Access to this API requires allowlisting. During Onramp Headless API onboarding, contact the Onramp team to enable Onramp-managed verification for your application.

Parameters:
  • verification_id (str) – The verification ID returned by the Initiate Onramp Verification endpoint. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • submit_onramp_verification_request (SubmitOnrampVerificationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

OnrampVerificationConfirmation

Returns:

Returns the result object.

async submit_onramp_verification_with_http_info(verification_id, x_idempotency_key=None, submit_onramp_verification_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Submit onramp verification

Submits the OTP code to complete verification. On success, marks the verification as verified and returns the same verificationId. The destination does not need to be re-sent. Onramp uses the value captured at initiation time. The returned verificationId should be stored on the user’s device and passed to the Create Onramp Order endpoint. It is valid for 60 days. Access to this API requires allowlisting. During Onramp Headless API onboarding, contact the Onramp team to enable Onramp-managed verification for your application.

Parameters:
  • verification_id (str) – The verification ID returned by the Initiate Onramp Verification endpoint. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • submit_onramp_verification_request (SubmitOnrampVerificationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[OnrampVerificationConfirmation]

Returns:

Returns the result object.

async submit_onramp_verification_without_preload_content(verification_id, x_idempotency_key=None, submit_onramp_verification_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Submit onramp verification

Submits the OTP code to complete verification. On success, marks the verification as verified and returns the same verificationId. The destination does not need to be re-sent. Onramp uses the value captured at initiation time. The returned verificationId should be stored on the user’s device and passed to the Create Onramp Order endpoint. It is valid for 60 days. Access to this API requires allowlisting. During Onramp Headless API onboarding, contact the Onramp team to enable Onramp-managed verification for your application.

Parameters:
  • verification_id (str) – The verification ID returned by the Initiate Onramp Verification endpoint. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • submit_onramp_verification_request (SubmitOnrampVerificationRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.payment_methods_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.payment_methods_api.PaymentMethodsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async get_payment_method(payment_method_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get payment method

Get details of a specific payment method by its ID. Returns 404 if the payment method is not found or not owned by the requesting entity.

Parameters:
  • payment_method_id (str) – The unique identifier of the payment method. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

PaymentMethodsPaymentMethod

Returns:

Returns the result object.

async get_payment_method_with_http_info(payment_method_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get payment method

Get details of a specific payment method by its ID. Returns 404 if the payment method is not found or not owned by the requesting entity.

Parameters:
  • payment_method_id (str) – The unique identifier of the payment method. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[PaymentMethodsPaymentMethod]

Returns:

Returns the result object.

async get_payment_method_without_preload_content(payment_method_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get payment method

Get details of a specific payment method by its ID. Returns 404 if the payment method is not found or not owned by the requesting entity.

Parameters:
  • payment_method_id (str) – The unique identifier of the payment method. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_payment_methods(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List payment methods

List payment methods linked to your entity. Payment methods represent external financial instruments that can be used as a target for transfers. The list will not include disabled or deleted payment methods. Currently Supported Types: - fedwire: Domestic USD wire transfers - swift: International wire transfers - sepa: SEPA EUR transfers Note: Payment methods are created and verified through your linked CDP entity. Currently, fetching payment methods is only supported for Prime investment vehicles linked to CDP.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListPaymentMethods200Response

Returns:

Returns the result object.

async list_payment_methods_with_http_info(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List payment methods

List payment methods linked to your entity. Payment methods represent external financial instruments that can be used as a target for transfers. The list will not include disabled or deleted payment methods. Currently Supported Types: - fedwire: Domestic USD wire transfers - swift: International wire transfers - sepa: SEPA EUR transfers Note: Payment methods are created and verified through your linked CDP entity. Currently, fetching payment methods is only supported for Prime investment vehicles linked to CDP.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListPaymentMethods200Response]

Returns:

Returns the result object.

async list_payment_methods_without_preload_content(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List payment methods

List payment methods linked to your entity. Payment methods represent external financial instruments that can be used as a target for transfers. The list will not include disabled or deleted payment methods. Currently Supported Types: - fedwire: Domestic USD wire transfers - swift: International wire transfers - sepa: SEPA EUR transfers Note: Payment methods are created and verified through your linked CDP entity. Currently, fetching payment methods is only supported for Prime investment vehicles linked to CDP.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.policy_engine_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.policy_engine_api.PolicyEngineApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_policy(create_policy_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create policy

Create a policy that can be used to govern the behavior of accounts.

Parameters:
  • create_policy_request (CreatePolicyRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Policy

Returns:

Returns the result object.

async create_policy_with_http_info(create_policy_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create policy

Create a policy that can be used to govern the behavior of accounts.

Parameters:
  • create_policy_request (CreatePolicyRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Policy]

Returns:

Returns the result object.

async create_policy_without_preload_content(create_policy_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create policy

Create a policy that can be used to govern the behavior of accounts.

Parameters:
  • create_policy_request (CreatePolicyRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async delete_policy(policy_id, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Delete policy

Delete a policy by its ID. This will have the effect of removing the policy from all accounts that are currently using it.

Parameters:
  • policy_id (str) – The ID of the policy to delete. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

None

Returns:

Returns the result object.

async delete_policy_with_http_info(policy_id, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Delete policy

Delete a policy by its ID. This will have the effect of removing the policy from all accounts that are currently using it.

Parameters:
  • policy_id (str) – The ID of the policy to delete. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[NoneType]

Returns:

Returns the result object.

async delete_policy_without_preload_content(policy_id, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Delete policy

Delete a policy by its ID. This will have the effect of removing the policy from all accounts that are currently using it.

Parameters:
  • policy_id (str) – The ID of the policy to delete. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_policy_by_id(policy_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get policy by ID

Get a policy by its ID.

Parameters:
  • policy_id (str) – The ID of the policy to get. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Policy

Returns:

Returns the result object.

async get_policy_by_id_with_http_info(policy_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get policy by ID

Get a policy by its ID.

Parameters:
  • policy_id (str) – The ID of the policy to get. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Policy]

Returns:

Returns the result object.

async get_policy_by_id_without_preload_content(policy_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get policy by ID

Get a policy by its ID.

Parameters:
  • policy_id (str) – The ID of the policy to get. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_policies(page_size=None, page_token=None, scope=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List policies

Lists the policies belonging to the developer’s CDP Project. Use the scope parameter to filter the policies by scope. The response is paginated, and by default, returns 20 policies per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • scope (str) – The scope of the policies to return. If project, the response will include exactly one policy, which is the project-level policy. If account, the response will include all account-level policies for the developer’s CDP Project.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListPolicies200Response

Returns:

Returns the result object.

async list_policies_with_http_info(page_size=None, page_token=None, scope=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List policies

Lists the policies belonging to the developer’s CDP Project. Use the scope parameter to filter the policies by scope. The response is paginated, and by default, returns 20 policies per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • scope (str) – The scope of the policies to return. If project, the response will include exactly one policy, which is the project-level policy. If account, the response will include all account-level policies for the developer’s CDP Project.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListPolicies200Response]

Returns:

Returns the result object.

async list_policies_without_preload_content(page_size=None, page_token=None, scope=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List policies

Lists the policies belonging to the developer’s CDP Project. Use the scope parameter to filter the policies by scope. The response is paginated, and by default, returns 20 policies per page.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • scope (str) – The scope of the policies to return. If project, the response will include exactly one policy, which is the project-level policy. If account, the response will include all account-level policies for the developer’s CDP Project.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async update_policy(policy_id, update_policy_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update policy

Updates a policy by its ID. This will have the effect of applying the updated policy to all accounts that are currently using it.

Parameters:
  • policy_id (str) – The ID of the policy to update. (required)

  • update_policy_request (UpdatePolicyRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Policy

Returns:

Returns the result object.

async update_policy_with_http_info(policy_id, update_policy_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update policy

Updates a policy by its ID. This will have the effect of applying the updated policy to all accounts that are currently using it.

Parameters:
  • policy_id (str) – The ID of the policy to update. (required)

  • update_policy_request (UpdatePolicyRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Policy]

Returns:

Returns the result object.

async update_policy_without_preload_content(policy_id, update_policy_request, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update policy

Updates a policy by its ID. This will have the effect of applying the updated policy to all accounts that are currently using it.

Parameters:
  • policy_id (str) – The ID of the policy to update. (required)

  • update_policy_request (UpdatePolicyRequest) – (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.solana_accounts_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.solana_accounts_api.SolanaAccountsApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_solana_account(x_wallet_auth=None, x_idempotency_key=None, create_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create Solana account

Creates a new Solana account.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_solana_account_request (CreateSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SolanaAccount

Returns:

Returns the result object.

async create_solana_account_with_http_info(x_wallet_auth=None, x_idempotency_key=None, create_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create Solana account

Creates a new Solana account.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_solana_account_request (CreateSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SolanaAccount]

Returns:

Returns the result object.

async create_solana_account_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, create_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create Solana account

Creates a new Solana account.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • create_solana_account_request (CreateSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async export_solana_account(address, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export Solana account

Export an existing Solana account’s private key. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ExportSolanaAccount200Response

Returns:

Returns the result object.

async export_solana_account_by_name(name, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export Solana account by name

Export an existing Solana account’s private key by its name. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • name (str) – The name of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ExportSolanaAccount200Response

Returns:

Returns the result object.

async export_solana_account_by_name_with_http_info(name, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export Solana account by name

Export an existing Solana account’s private key by its name. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • name (str) – The name of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ExportSolanaAccount200Response]

Returns:

Returns the result object.

async export_solana_account_by_name_without_preload_content(name, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export Solana account by name

Export an existing Solana account’s private key by its name. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • name (str) – The name of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async export_solana_account_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export Solana account

Export an existing Solana account’s private key. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ExportSolanaAccount200Response]

Returns:

Returns the result object.

async export_solana_account_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, export_evm_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Export Solana account

Export an existing Solana account’s private key. It is important to store the private key in a secure place after it’s exported.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • export_evm_account_request (ExportEvmAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_solana_account(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Solana account by address

Gets a Solana account by its address.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SolanaAccount

Returns:

Returns the result object.

async get_solana_account_by_name(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Solana account by name

Gets a Solana account by its name.

Parameters:
  • name (str) – The name of the Solana account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SolanaAccount

Returns:

Returns the result object.

async get_solana_account_by_name_with_http_info(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Solana account by name

Gets a Solana account by its name.

Parameters:
  • name (str) – The name of the Solana account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SolanaAccount]

Returns:

Returns the result object.

async get_solana_account_by_name_without_preload_content(name, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Solana account by name

Gets a Solana account by its name.

Parameters:
  • name (str) – The name of the Solana account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_solana_account_with_http_info(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Solana account by address

Gets a Solana account by its address.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SolanaAccount]

Returns:

Returns the result object.

async get_solana_account_without_preload_content(address, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get Solana account by address

Gets a Solana account by its address.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async import_solana_account(x_wallet_auth=None, x_idempotency_key=None, import_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import Solana account

Import an existing Solana account into the developer’s CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_solana_account_request (ImportSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SolanaAccount

Returns:

Returns the result object.

async import_solana_account_with_http_info(x_wallet_auth=None, x_idempotency_key=None, import_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import Solana account

Import an existing Solana account into the developer’s CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_solana_account_request (ImportSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SolanaAccount]

Returns:

Returns the result object.

async import_solana_account_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, import_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Import Solana account

Import an existing Solana account into the developer’s CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • import_solana_account_request (ImportSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_solana_accounts(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Solana accounts

Lists the Solana accounts belonging to the developer. The response is paginated, and by default, returns 20 accounts per page. If a name is provided, the response will contain only the account with that name.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListSolanaAccounts200Response

Returns:

Returns the result object.

async list_solana_accounts_with_http_info(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Solana accounts

Lists the Solana accounts belonging to the developer. The response is paginated, and by default, returns 20 accounts per page. If a name is provided, the response will contain only the account with that name.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListSolanaAccounts200Response]

Returns:

Returns the result object.

async list_solana_accounts_without_preload_content(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Solana accounts

Lists the Solana accounts belonging to the developer. The response is paginated, and by default, returns 20 accounts per page. If a name is provided, the response will contain only the account with that name.

Parameters:
  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async send_solana_transaction(x_wallet_auth=None, x_idempotency_key=None, send_solana_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send Solana transaction

Signs and sends a single Solana transaction using multiple Solana accounts. The transaction may contain contain several instructions, each of which may require signatures from different account keys. The transaction should be serialized into a byte array and base64 encoded. The API handles recent blockhash management and fee estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana.com/developers/guides/advanced/versions#current-transaction-versions) * [Versioned transactions](https://solana.com/developers/guides/advanced/versions) Instruction Batching To batch multiple operations, include multiple instructions within a single transaction. All instructions within a transaction are executed atomically - if any instruction fails, the entire transaction fails and is rolled back. Network Support The following Solana networks are supported: * solana - Solana Mainnet * solana-devnet - Solana Devnet The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • send_solana_transaction_request (SendSolanaTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SendSolanaTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async send_solana_transaction_with_http_info(x_wallet_auth=None, x_idempotency_key=None, send_solana_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send Solana transaction

Signs and sends a single Solana transaction using multiple Solana accounts. The transaction may contain contain several instructions, each of which may require signatures from different account keys. The transaction should be serialized into a byte array and base64 encoded. The API handles recent blockhash management and fee estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana.com/developers/guides/advanced/versions#current-transaction-versions) * [Versioned transactions](https://solana.com/developers/guides/advanced/versions) Instruction Batching To batch multiple operations, include multiple instructions within a single transaction. All instructions within a transaction are executed atomically - if any instruction fails, the entire transaction fails and is rolled back. Network Support The following Solana networks are supported: * solana - Solana Mainnet * solana-devnet - Solana Devnet The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • send_solana_transaction_request (SendSolanaTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SendSolanaTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async send_solana_transaction_without_preload_content(x_wallet_auth=None, x_idempotency_key=None, send_solana_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Send Solana transaction

Signs and sends a single Solana transaction using multiple Solana accounts. The transaction may contain contain several instructions, each of which may require signatures from different account keys. The transaction should be serialized into a byte array and base64 encoded. The API handles recent blockhash management and fee estimation, leaving the developer to provide only the minimal set of fields necessary to send the transaction. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana.com/developers/guides/advanced/versions#current-transaction-versions) * [Versioned transactions](https://solana.com/developers/guides/advanced/versions) Instruction Batching To batch multiple operations, include multiple instructions within a single transaction. All instructions within a transaction are executed atomically - if any instruction fails, the entire transaction fails and is rolled back. Network Support The following Solana networks are supported: * solana - Solana Mainnet * solana-devnet - Solana Devnet The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • send_solana_transaction_request (SendSolanaTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_solana_message(address, x_wallet_auth=None, x_idempotency_key=None, sign_solana_message_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign message

Signs an arbitrary message with the given Solana account. WARNING: Never sign a message that you didn’t generate, as it can be an arbitrary transaction. For example, it might send all of your funds to an attacker.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_solana_message_request (SignSolanaMessageRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignSolanaMessageWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_solana_message_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, sign_solana_message_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign message

Signs an arbitrary message with the given Solana account. WARNING: Never sign a message that you didn’t generate, as it can be an arbitrary transaction. For example, it might send all of your funds to an attacker.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_solana_message_request (SignSolanaMessageRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignSolanaMessageWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_solana_message_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, sign_solana_message_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign message

Signs an arbitrary message with the given Solana account. WARNING: Never sign a message that you didn’t generate, as it can be an arbitrary transaction. For example, it might send all of your funds to an attacker.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_solana_message_request (SignSolanaMessageRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async sign_solana_transaction(address, x_wallet_auth=None, x_idempotency_key=None, sign_solana_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction

Signs a transaction with the given Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html) * [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html) The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_solana_transaction_request (SignSolanaTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SignSolanaTransactionWithEndUserAccount200Response

Returns:

Returns the result object.

async sign_solana_transaction_with_http_info(address, x_wallet_auth=None, x_idempotency_key=None, sign_solana_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction

Signs a transaction with the given Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html) * [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html) The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_solana_transaction_request (SignSolanaTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SignSolanaTransactionWithEndUserAccount200Response]

Returns:

Returns the result object.

async sign_solana_transaction_without_preload_content(address, x_wallet_auth=None, x_idempotency_key=None, sign_solana_transaction_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Sign transaction

Signs a transaction with the given Solana account. The unsigned transaction should be serialized into a byte array and then encoded as base64. Transaction types The following transaction types are supported: * [Legacy transactions](https://solana-labs.github.io/solana-web3.js/classes/Transaction.html) * [Versioned transactions](https://solana-labs.github.io/solana-web3.js/classes/VersionedTransaction.html) The developer is responsible for ensuring that the unsigned transaction is valid, as the API will not validate the transaction.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_wallet_auth (str) – A JWT signed using your Wallet Secret, encoded in base64. Refer to the [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token) section of our Authentication docs for more details on how to generate your Wallet Token.

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • sign_solana_transaction_request (SignSolanaTransactionRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async update_solana_account(address, x_idempotency_key=None, update_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update Solana account

Updates an existing Solana account. Use this to update the account’s name or account-level policy.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • update_solana_account_request (UpdateSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

SolanaAccount

Returns:

Returns the result object.

async update_solana_account_with_http_info(address, x_idempotency_key=None, update_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update Solana account

Updates an existing Solana account. Use this to update the account’s name or account-level policy.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • update_solana_account_request (UpdateSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[SolanaAccount]

Returns:

Returns the result object.

async update_solana_account_without_preload_content(address, x_idempotency_key=None, update_solana_account_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update Solana account

Updates an existing Solana account. Use this to update the account’s name or account-level policy.

Parameters:
  • address (str) – The base58 encoded address of the Solana account. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • update_solana_account_request (UpdateSolanaAccountRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.solana_token_balances_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.solana_token_balances_api.SolanaTokenBalancesApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async list_solana_token_balances(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Solana token balances

Lists the token balances of a Solana address on a given network. The balances include SPL tokens and the native SOL token. The response is paginated, and by default, returns 20 balances per page. Note: This endpoint is still under development and does not yet provide strong availability or freshness guarantees. Freshness and availability of new token balances will improve over the coming weeks.

Parameters:
  • address (str) – The base58 encoded Solana address to get balances for. (required)

  • network (ListSolanaTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of balances to return per page.

  • page_token (str) – The token for the next page of balances. Will be empty if there are no more balances to fetch.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListSolanaTokenBalances200Response

Returns:

Returns the result object.

async list_solana_token_balances_with_http_info(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Solana token balances

Lists the token balances of a Solana address on a given network. The balances include SPL tokens and the native SOL token. The response is paginated, and by default, returns 20 balances per page. Note: This endpoint is still under development and does not yet provide strong availability or freshness guarantees. Freshness and availability of new token balances will improve over the coming weeks.

Parameters:
  • address (str) – The base58 encoded Solana address to get balances for. (required)

  • network (ListSolanaTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of balances to return per page.

  • page_token (str) – The token for the next page of balances. Will be empty if there are no more balances to fetch.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListSolanaTokenBalances200Response]

Returns:

Returns the result object.

async list_solana_token_balances_without_preload_content(address, network, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List Solana token balances

Lists the token balances of a Solana address on a given network. The balances include SPL tokens and the native SOL token. The response is paginated, and by default, returns 20 balances per page. Note: This endpoint is still under development and does not yet provide strong availability or freshness guarantees. Freshness and availability of new token balances will improve over the coming weeks.

Parameters:
  • address (str) – The base58 encoded Solana address to get balances for. (required)

  • network (ListSolanaTokenBalancesNetwork) – The human-readable network name to get the balances for. (required)

  • page_size (int) – The number of balances to return per page.

  • page_token (str) – The token for the next page of balances. Will be empty if there are no more balances to fetch.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.sqlapi_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.sqlapi_api.SQLAPIApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async get_sql_grammar(_request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get SQL grammar

Retrieve the SQL grammar for the SQL API. The SQL queries that are supported by the SQL API are defined in ANTLR4 grammar which is evaluated by server before executing the query. This ensures the safety and soundness of the SQL query before execution. This endpoint returns the ANTLR4 grammar that is used to evaluate the SQL queries so that developers can understand the SQL API and build SQL queries with high confidence and correctness. LLMs interact well with ANTLR4 grammar. You can feed the grammar directly into the LLMs to help generate SQL queries.

Parameters:
  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

str

Returns:

Returns the result object.

async get_sql_grammar_with_http_info(_request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get SQL grammar

Retrieve the SQL grammar for the SQL API. The SQL queries that are supported by the SQL API are defined in ANTLR4 grammar which is evaluated by server before executing the query. This ensures the safety and soundness of the SQL query before execution. This endpoint returns the ANTLR4 grammar that is used to evaluate the SQL queries so that developers can understand the SQL API and build SQL queries with high confidence and correctness. LLMs interact well with ANTLR4 grammar. You can feed the grammar directly into the LLMs to help generate SQL queries.

Parameters:
  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[str]

Returns:

Returns the result object.

async get_sql_grammar_without_preload_content(_request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get SQL grammar

Retrieve the SQL grammar for the SQL API. The SQL queries that are supported by the SQL API are defined in ANTLR4 grammar which is evaluated by server before executing the query. This ensures the safety and soundness of the SQL query before execution. This endpoint returns the ANTLR4 grammar that is used to evaluate the SQL queries so that developers can understand the SQL API and build SQL queries with high confidence and correctness. LLMs interact well with ANTLR4 grammar. You can feed the grammar directly into the LLMs to help generate SQL queries.

Parameters:
  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_sql_schema(database=None, table=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get schema details

Retrieve the schema information for the available tables in the SQL API’s indexed data. This includes table names, column definitions, data types, and indexed fields.

Parameters:
  • database (str) – The name of the database to query. Defaults to “base” when not specified.

  • table (str) – Get the schema for a specific table.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

OnchainDataSchemaResponse

Returns:

Returns the result object.

async get_sql_schema_with_http_info(database=None, table=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get schema details

Retrieve the schema information for the available tables in the SQL API’s indexed data. This includes table names, column definitions, data types, and indexed fields.

Parameters:
  • database (str) – The name of the database to query. Defaults to “base” when not specified.

  • table (str) – Get the schema for a specific table.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[OnchainDataSchemaResponse]

Returns:

Returns the result object.

async get_sql_schema_without_preload_content(database=None, table=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get schema details

Retrieve the schema information for the available tables in the SQL API’s indexed data. This includes table names, column definitions, data types, and indexed fields.

Parameters:
  • database (str) – The name of the database to query. Defaults to “base” when not specified.

  • table (str) – Get the schema for a specific table.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async run_sql_query(onchain_data_query, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Run SQL Query

Run a read-only SQL query against indexed blockchain data including transactions, events, and decoded logs. This endpoint provides direct SQL access to comprehensive blockchain data across supported networks. Queries are executed against optimized data structures for high-performance analytics. ### Allowed Queries - Standard SQL syntax (CoinbaSeQL dialect, based on ClickHouse dialect) - Read-only queries (SELECT statements) - No DDL or DML operations - Query that follow limits (defined below) ### Supported Networks - Base Mainnet: base - Base Sepolia: base_sepolia - Solana Mainnet: solana - Hyperevm Mainnet: hyperevm ### Supported Tables The below tables are supported for base and base_sepolia networks. | Table | Description | | — | — | | <network>.events | Decoded event logs with parameters, event signature, topics, and more. | | <network>.transactions | Transaction data including hash, block number, and gas usage. | | <network>.blocks | Block information. | | <network>.encoded_logs | Encoded log data for event logs that cannot be decoded by our event decoder (ex: log0 opcode). | | <network>.decoded_user_operations | Decoded user operations data including hash, block number, gas usage, builder codes, entrypoint version, and more. | | <network>.transaction_attributions | Information about the attributions of a transaction to a builder and associated builder codes. | Following the above, the valid tables on Base Mainnet are base.events, base.transactions, base.blocks, base.encoded_logs, base.decoded_user_operations, and base.transaction_attributions. Separately, there is a limited set of tables supported for solana and hyperevm networks: | Table | Description | | — | — | | solana.instructions | Solana instruction call data including program ID, instruction data, and more. Currently supports just Token2022 and SPL Token programs. | | hyperevm.events | Hyperevm decoded event logs with parameters, event signature, topics, and more. Currently supports just B20 events. | ### Query Limits - Maximum result set: 50,000 rows - Maximum query length: 10,000 characters - Maximum on-disk data to read: 100GB - Maximum memory usage: 15GB - Query timeout: 30 seconds - Maximum JOINs: 12 ### Query Caching By default, each query result is returned from cache so long as the result is from an identical query and less than 750ms old. This freshness tolerance can be modified upwards, to a maximum of 900000ms (i.e. 900s, 15m). This can be helpful for users who wish to reduce expensive calls to the SQL API by reusing cached results.

Parameters:
  • onchain_data_query (OnchainDataQuery) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

OnchainDataResult

Returns:

Returns the result object.

async run_sql_query_with_http_info(onchain_data_query, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Run SQL Query

Run a read-only SQL query against indexed blockchain data including transactions, events, and decoded logs. This endpoint provides direct SQL access to comprehensive blockchain data across supported networks. Queries are executed against optimized data structures for high-performance analytics. ### Allowed Queries - Standard SQL syntax (CoinbaSeQL dialect, based on ClickHouse dialect) - Read-only queries (SELECT statements) - No DDL or DML operations - Query that follow limits (defined below) ### Supported Networks - Base Mainnet: base - Base Sepolia: base_sepolia - Solana Mainnet: solana - Hyperevm Mainnet: hyperevm ### Supported Tables The below tables are supported for base and base_sepolia networks. | Table | Description | | — | — | | <network>.events | Decoded event logs with parameters, event signature, topics, and more. | | <network>.transactions | Transaction data including hash, block number, and gas usage. | | <network>.blocks | Block information. | | <network>.encoded_logs | Encoded log data for event logs that cannot be decoded by our event decoder (ex: log0 opcode). | | <network>.decoded_user_operations | Decoded user operations data including hash, block number, gas usage, builder codes, entrypoint version, and more. | | <network>.transaction_attributions | Information about the attributions of a transaction to a builder and associated builder codes. | Following the above, the valid tables on Base Mainnet are base.events, base.transactions, base.blocks, base.encoded_logs, base.decoded_user_operations, and base.transaction_attributions. Separately, there is a limited set of tables supported for solana and hyperevm networks: | Table | Description | | — | — | | solana.instructions | Solana instruction call data including program ID, instruction data, and more. Currently supports just Token2022 and SPL Token programs. | | hyperevm.events | Hyperevm decoded event logs with parameters, event signature, topics, and more. Currently supports just B20 events. | ### Query Limits - Maximum result set: 50,000 rows - Maximum query length: 10,000 characters - Maximum on-disk data to read: 100GB - Maximum memory usage: 15GB - Query timeout: 30 seconds - Maximum JOINs: 12 ### Query Caching By default, each query result is returned from cache so long as the result is from an identical query and less than 750ms old. This freshness tolerance can be modified upwards, to a maximum of 900000ms (i.e. 900s, 15m). This can be helpful for users who wish to reduce expensive calls to the SQL API by reusing cached results.

Parameters:
  • onchain_data_query (OnchainDataQuery) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[OnchainDataResult]

Returns:

Returns the result object.

async run_sql_query_without_preload_content(onchain_data_query, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Run SQL Query

Run a read-only SQL query against indexed blockchain data including transactions, events, and decoded logs. This endpoint provides direct SQL access to comprehensive blockchain data across supported networks. Queries are executed against optimized data structures for high-performance analytics. ### Allowed Queries - Standard SQL syntax (CoinbaSeQL dialect, based on ClickHouse dialect) - Read-only queries (SELECT statements) - No DDL or DML operations - Query that follow limits (defined below) ### Supported Networks - Base Mainnet: base - Base Sepolia: base_sepolia - Solana Mainnet: solana - Hyperevm Mainnet: hyperevm ### Supported Tables The below tables are supported for base and base_sepolia networks. | Table | Description | | — | — | | <network>.events | Decoded event logs with parameters, event signature, topics, and more. | | <network>.transactions | Transaction data including hash, block number, and gas usage. | | <network>.blocks | Block information. | | <network>.encoded_logs | Encoded log data for event logs that cannot be decoded by our event decoder (ex: log0 opcode). | | <network>.decoded_user_operations | Decoded user operations data including hash, block number, gas usage, builder codes, entrypoint version, and more. | | <network>.transaction_attributions | Information about the attributions of a transaction to a builder and associated builder codes. | Following the above, the valid tables on Base Mainnet are base.events, base.transactions, base.blocks, base.encoded_logs, base.decoded_user_operations, and base.transaction_attributions. Separately, there is a limited set of tables supported for solana and hyperevm networks: | Table | Description | | — | — | | solana.instructions | Solana instruction call data including program ID, instruction data, and more. Currently supports just Token2022 and SPL Token programs. | | hyperevm.events | Hyperevm decoded event logs with parameters, event signature, topics, and more. Currently supports just B20 events. | ### Query Limits - Maximum result set: 50,000 rows - Maximum query length: 10,000 characters - Maximum on-disk data to read: 100GB - Maximum memory usage: 15GB - Query timeout: 30 seconds - Maximum JOINs: 12 ### Query Caching By default, each query result is returned from cache so long as the result is from an identical query and less than 750ms old. This freshness tolerance can be modified upwards, to a maximum of 900000ms (i.e. 900s, 15m). This can be helpful for users who wish to reduce expensive calls to the SQL API by reusing cached results.

Parameters:
  • onchain_data_query (OnchainDataQuery) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.transfers_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.transfers_api.TransfersApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_transfer(x_idempotency_key=None, transfer_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create transfer

Create a new transfer to move funds from a source to a target. All transfers first transition to quoted. If execute: false, the transfer stays quoted until you call /v2/transfers/{transferId}/execute. If execute: true, quoted status emits momentarily before the transfer moves to processing, where execution proceeds. Subscribe to the transfers webhook to follow progress in real time instead of polling.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • transfer_request (TransferRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Transfer

Returns:

Returns the result object.

async create_transfer_with_http_info(x_idempotency_key=None, transfer_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create transfer

Create a new transfer to move funds from a source to a target. All transfers first transition to quoted. If execute: false, the transfer stays quoted until you call /v2/transfers/{transferId}/execute. If execute: true, quoted status emits momentarily before the transfer moves to processing, where execution proceeds. Subscribe to the transfers webhook to follow progress in real time instead of polling.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • transfer_request (TransferRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Transfer]

Returns:

Returns the result object.

async create_transfer_without_preload_content(x_idempotency_key=None, transfer_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create transfer

Create a new transfer to move funds from a source to a target. All transfers first transition to quoted. If execute: false, the transfer stays quoted until you call /v2/transfers/{transferId}/execute. If execute: true, quoted status emits momentarily before the transfer moves to processing, where execution proceeds. Subscribe to the transfers webhook to follow progress in real time instead of polling.

Parameters:
  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • transfer_request (TransferRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async execute_fund_transfer(transfer_id, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Execute transfer

Executes a transfer which was created using the Create a transfer endpoint.

Parameters:
  • transfer_id (str) – The ID of the transfer. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Transfer

Returns:

Returns the result object.

async execute_fund_transfer_with_http_info(transfer_id, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Execute transfer

Executes a transfer which was created using the Create a transfer endpoint.

Parameters:
  • transfer_id (str) – The ID of the transfer. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Transfer]

Returns:

Returns the result object.

async execute_fund_transfer_without_preload_content(transfer_id, x_idempotency_key=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Execute transfer

Executes a transfer which was created using the Create a transfer endpoint.

Parameters:
  • transfer_id (str) – The ID of the transfer. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_transfer_by_id(transfer_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get transfer

Get a transfer by its ID.

Parameters:
  • transfer_id (str) – The unique identifier of the transfer. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

Transfer

Returns:

Returns the result object.

async get_transfer_by_id_with_http_info(transfer_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get transfer

Get a transfer by its ID.

Parameters:
  • transfer_id (str) – The unique identifier of the transfer. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[Transfer]

Returns:

Returns the result object.

async get_transfer_by_id_without_preload_content(transfer_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get transfer

Get a transfer by its ID.

Parameters:
  • transfer_id (str) – The unique identifier of the transfer. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_transfers(status=None, account_id=None, source_account_id=None, target_account_id=None, created_after=None, created_before=None, updated_after=None, updated_before=None, source_asset=None, target_asset=None, source_address=None, target_address=None, target_email=None, transfer_id=None, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List transfers

List transfers for your organization. Use this to view and monitor your transfer activity. Status Filtering: Filter by specific status to efficiently manage transfers: * ?status=processing - Monitor active transfers. * ?status=quoted - Find transfers awaiting execution. * ?status=failed - Review failed transfers for troubleshooting. * ?status=completed - Find completed transfers. Account Filtering: Filter by account ID to find transfers involving a specific account: * ?accountId=<ID> - All transfers where the account is either source or target (OR semantics). * ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). * ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400. Date Range Filtering: Filter by creation or last-updated time for reconciliation: * ?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. * ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync. Asset Filtering: Filter by source or target asset symbol: * ?sourceAsset=usd - Transfers funded from a USD account. * ?targetAsset=usdc - Transfers delivering USDC to the target. Other Filters: * ?sourceAddress=0x… - Transfers from a specific on-chain source address. * ?targetAddress=0x… - Transfers to a specific on-chain destination address. * ?targetEmail=user@example.com - Transfers to a specific email recipient. * ?transferId=transfer_… - Look up a single transfer by ID; bypasses pagination.

Parameters:
  • status (TransferStatus) – Filter transfers by status. Useful for building dashboards, monitoring active transfers, or finding transfers needing action.

  • account_id (str) – Filter transfers by account ID. Returns transfers where the specified account is either the source or target (OR semantics). Cannot be combined with sourceAccountId or targetAccountId.

  • source_account_id (str) – Filter transfers by source account ID. Returns only transfers where the specified account is the source. Cannot be combined with accountId.

  • target_account_id (str) – Filter transfers by target account ID. Returns only transfers where the specified account is the target. Cannot be combined with accountId.

  • created_after (datetime) – Filter transfers to those created at or after this datetime (inclusive). ISO 8601 format.

  • created_before (datetime) – Filter transfers to those created at or before this datetime (inclusive). ISO 8601 format.

  • updated_after (datetime) – Filter transfers to those updated at or after this datetime (inclusive). ISO 8601 format. Useful for incremental sync — poll for transfers that changed state since your last check.

  • updated_before (datetime) – Filter transfers to those updated at or before this datetime (inclusive). ISO 8601 format.

  • source_asset (str) – Filter transfers by source asset symbol (e.g., usd, usdc).

  • target_asset (str) – Filter transfers by target asset symbol (e.g., usdc, eth).

  • source_address (str) – Filter transfers by the on-chain address of the source.

  • target_address (str) – Filter transfers by the on-chain destination address of the target.

  • target_email (str) – Filter transfers by the email address of the target recipient.

  • transfer_id (str) – Filter to a specific transfer by ID. When provided, returns only the matching transfer and bypasses pagination.

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListTransfers200Response

Returns:

Returns the result object.

async list_transfers_with_http_info(status=None, account_id=None, source_account_id=None, target_account_id=None, created_after=None, created_before=None, updated_after=None, updated_before=None, source_asset=None, target_asset=None, source_address=None, target_address=None, target_email=None, transfer_id=None, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List transfers

List transfers for your organization. Use this to view and monitor your transfer activity. Status Filtering: Filter by specific status to efficiently manage transfers: * ?status=processing - Monitor active transfers. * ?status=quoted - Find transfers awaiting execution. * ?status=failed - Review failed transfers for troubleshooting. * ?status=completed - Find completed transfers. Account Filtering: Filter by account ID to find transfers involving a specific account: * ?accountId=<ID> - All transfers where the account is either source or target (OR semantics). * ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). * ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400. Date Range Filtering: Filter by creation or last-updated time for reconciliation: * ?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. * ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync. Asset Filtering: Filter by source or target asset symbol: * ?sourceAsset=usd - Transfers funded from a USD account. * ?targetAsset=usdc - Transfers delivering USDC to the target. Other Filters: * ?sourceAddress=0x… - Transfers from a specific on-chain source address. * ?targetAddress=0x… - Transfers to a specific on-chain destination address. * ?targetEmail=user@example.com - Transfers to a specific email recipient. * ?transferId=transfer_… - Look up a single transfer by ID; bypasses pagination.

Parameters:
  • status (TransferStatus) – Filter transfers by status. Useful for building dashboards, monitoring active transfers, or finding transfers needing action.

  • account_id (str) – Filter transfers by account ID. Returns transfers where the specified account is either the source or target (OR semantics). Cannot be combined with sourceAccountId or targetAccountId.

  • source_account_id (str) – Filter transfers by source account ID. Returns only transfers where the specified account is the source. Cannot be combined with accountId.

  • target_account_id (str) – Filter transfers by target account ID. Returns only transfers where the specified account is the target. Cannot be combined with accountId.

  • created_after (datetime) – Filter transfers to those created at or after this datetime (inclusive). ISO 8601 format.

  • created_before (datetime) – Filter transfers to those created at or before this datetime (inclusive). ISO 8601 format.

  • updated_after (datetime) – Filter transfers to those updated at or after this datetime (inclusive). ISO 8601 format. Useful for incremental sync — poll for transfers that changed state since your last check.

  • updated_before (datetime) – Filter transfers to those updated at or before this datetime (inclusive). ISO 8601 format.

  • source_asset (str) – Filter transfers by source asset symbol (e.g., usd, usdc).

  • target_asset (str) – Filter transfers by target asset symbol (e.g., usdc, eth).

  • source_address (str) – Filter transfers by the on-chain address of the source.

  • target_address (str) – Filter transfers by the on-chain destination address of the target.

  • target_email (str) – Filter transfers by the email address of the target recipient.

  • transfer_id (str) – Filter to a specific transfer by ID. When provided, returns only the matching transfer and bypasses pagination.

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[ListTransfers200Response]

Returns:

Returns the result object.

async list_transfers_without_preload_content(status=None, account_id=None, source_account_id=None, target_account_id=None, created_after=None, created_before=None, updated_after=None, updated_before=None, source_asset=None, target_asset=None, source_address=None, target_address=None, target_email=None, transfer_id=None, page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List transfers

List transfers for your organization. Use this to view and monitor your transfer activity. Status Filtering: Filter by specific status to efficiently manage transfers: * ?status=processing - Monitor active transfers. * ?status=quoted - Find transfers awaiting execution. * ?status=failed - Review failed transfers for troubleshooting. * ?status=completed - Find completed transfers. Account Filtering: Filter by account ID to find transfers involving a specific account: * ?accountId=<ID> - All transfers where the account is either source or target (OR semantics). * ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). * ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400. Date Range Filtering: Filter by creation or last-updated time for reconciliation: * ?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. * ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync. Asset Filtering: Filter by source or target asset symbol: * ?sourceAsset=usd - Transfers funded from a USD account. * ?targetAsset=usdc - Transfers delivering USDC to the target. Other Filters: * ?sourceAddress=0x… - Transfers from a specific on-chain source address. * ?targetAddress=0x… - Transfers to a specific on-chain destination address. * ?targetEmail=user@example.com - Transfers to a specific email recipient. * ?transferId=transfer_… - Look up a single transfer by ID; bypasses pagination.

Parameters:
  • status (TransferStatus) – Filter transfers by status. Useful for building dashboards, monitoring active transfers, or finding transfers needing action.

  • account_id (str) – Filter transfers by account ID. Returns transfers where the specified account is either the source or target (OR semantics). Cannot be combined with sourceAccountId or targetAccountId.

  • source_account_id (str) – Filter transfers by source account ID. Returns only transfers where the specified account is the source. Cannot be combined with accountId.

  • target_account_id (str) – Filter transfers by target account ID. Returns only transfers where the specified account is the target. Cannot be combined with accountId.

  • created_after (datetime) – Filter transfers to those created at or after this datetime (inclusive). ISO 8601 format.

  • created_before (datetime) – Filter transfers to those created at or before this datetime (inclusive). ISO 8601 format.

  • updated_after (datetime) – Filter transfers to those updated at or after this datetime (inclusive). ISO 8601 format. Useful for incremental sync — poll for transfers that changed state since your last check.

  • updated_before (datetime) – Filter transfers to those updated at or before this datetime (inclusive). ISO 8601 format.

  • source_asset (str) – Filter transfers by source asset symbol (e.g., usd, usdc).

  • target_asset (str) – Filter transfers by target asset symbol (e.g., usdc, eth).

  • source_address (str) – Filter transfers by the on-chain address of the source.

  • target_address (str) – Filter transfers by the on-chain destination address of the target.

  • target_email (str) – Filter transfers by the email address of the target recipient.

  • transfer_id (str) – Filter to a specific transfer by ID. When provided, returns only the matching transfer and bypasses pagination.

  • page_size (int) – The number of resources to return per page.

  • page_token (str) – The token for the next page of resources, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async submit_deposit_travel_rule(transfer_id, x_idempotency_key=None, deposit_travel_rule_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Submit deposit travel rule information

Submit travel rule information for a deposit transfer held pending compliance review. Required fields vary by jurisdiction and may include originator name, address, date of birth, personal ID, and VASP information. If the submitted information satisfies all jurisdictional requirements, status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.

Parameters:
  • transfer_id (str) – The unique identifier of the transfer. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • deposit_travel_rule_request (DepositTravelRuleRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

DepositTravelRuleResponse

Returns:

Returns the result object.

async submit_deposit_travel_rule_with_http_info(transfer_id, x_idempotency_key=None, deposit_travel_rule_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Submit deposit travel rule information

Submit travel rule information for a deposit transfer held pending compliance review. Required fields vary by jurisdiction and may include originator name, address, date of birth, personal ID, and VASP information. If the submitted information satisfies all jurisdictional requirements, status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.

Parameters:
  • transfer_id (str) – The unique identifier of the transfer. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • deposit_travel_rule_request (DepositTravelRuleRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[DepositTravelRuleResponse]

Returns:

Returns the result object.

async submit_deposit_travel_rule_without_preload_content(transfer_id, x_idempotency_key=None, deposit_travel_rule_request=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Submit deposit travel rule information

Submit travel rule information for a deposit transfer held pending compliance review. Required fields vary by jurisdiction and may include originator name, address, date of birth, personal ID, and VASP information. If the submitted information satisfies all jurisdictional requirements, status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.

Parameters:
  • transfer_id (str) – The unique identifier of the transfer. (required)

  • x_idempotency_key (str) – 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](https://docs.cdp.coinbase.com/api-reference/v2/idempotency) for more information on using idempotency keys.

  • deposit_travel_rule_request (DepositTravelRuleRequest)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.webhooks_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.webhooks_api.WebhooksApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async create_webhook_subscription(webhook_subscription_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create webhook subscription

Subscribe to real-time events across CDP products. ### Filtering Onchain events can utilize multi-label filtering to only receive events that match all the specified labels. Allows labels are: - network (required) — Blockchain network - contract_address — Smart contract address - event_name — Event name (e.g., “Transfer”, “Burn”) - event_signature — Event signature (e.g., “Transfer(address,address,uint256)”) - transaction_from — Transaction sender address - transaction_to — Transaction recipient address - params.* — Any event parameter from the log event (e.g., params.from, params.to, params.sender, params.tokenId) For webhook types that aren’t onchain.*, labels are ignored. ### Webhook Signature Verification All webhooks include an HMAC-SHA256 signed header for security. The signature is signed with the secret that is returned in the secret field when creating a subscription. Do not lose the secret, as you will not be able to recreate it. If you lose the secret, you will need to create a new subscription. See the [verification guide](https://docs.cdp.coinbase.com/onramp-&-offramp/webhooks#webhook-signature-verification) for implementation details.

Parameters:
  • webhook_subscription_request (WebhookSubscriptionRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

WebhookSubscriptionResponse

Returns:

Returns the result object.

async create_webhook_subscription_with_http_info(webhook_subscription_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create webhook subscription

Subscribe to real-time events across CDP products. ### Filtering Onchain events can utilize multi-label filtering to only receive events that match all the specified labels. Allows labels are: - network (required) — Blockchain network - contract_address — Smart contract address - event_name — Event name (e.g., “Transfer”, “Burn”) - event_signature — Event signature (e.g., “Transfer(address,address,uint256)”) - transaction_from — Transaction sender address - transaction_to — Transaction recipient address - params.* — Any event parameter from the log event (e.g., params.from, params.to, params.sender, params.tokenId) For webhook types that aren’t onchain.*, labels are ignored. ### Webhook Signature Verification All webhooks include an HMAC-SHA256 signed header for security. The signature is signed with the secret that is returned in the secret field when creating a subscription. Do not lose the secret, as you will not be able to recreate it. If you lose the secret, you will need to create a new subscription. See the [verification guide](https://docs.cdp.coinbase.com/onramp-&-offramp/webhooks#webhook-signature-verification) for implementation details.

Parameters:
  • webhook_subscription_request (WebhookSubscriptionRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[WebhookSubscriptionResponse]

Returns:

Returns the result object.

async create_webhook_subscription_without_preload_content(webhook_subscription_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Create webhook subscription

Subscribe to real-time events across CDP products. ### Filtering Onchain events can utilize multi-label filtering to only receive events that match all the specified labels. Allows labels are: - network (required) — Blockchain network - contract_address — Smart contract address - event_name — Event name (e.g., “Transfer”, “Burn”) - event_signature — Event signature (e.g., “Transfer(address,address,uint256)”) - transaction_from — Transaction sender address - transaction_to — Transaction recipient address - params.* — Any event parameter from the log event (e.g., params.from, params.to, params.sender, params.tokenId) For webhook types that aren’t onchain.*, labels are ignored. ### Webhook Signature Verification All webhooks include an HMAC-SHA256 signed header for security. The signature is signed with the secret that is returned in the secret field when creating a subscription. Do not lose the secret, as you will not be able to recreate it. If you lose the secret, you will need to create a new subscription. See the [verification guide](https://docs.cdp.coinbase.com/onramp-&-offramp/webhooks#webhook-signature-verification) for implementation details.

Parameters:
  • webhook_subscription_request (WebhookSubscriptionRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async delete_webhook_subscription(subscription_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Delete webhook subscription

Permanently delete a webhook subscription and stop all event deliveries. This action cannot be undone. ### Important Notes - All webhook deliveries will cease immediately - Subscription cannot be recovered after deletion - Consider disabling instead of deleting for temporary pauses

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

None

Returns:

Returns the result object.

async delete_webhook_subscription_with_http_info(subscription_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Delete webhook subscription

Permanently delete a webhook subscription and stop all event deliveries. This action cannot be undone. ### Important Notes - All webhook deliveries will cease immediately - Subscription cannot be recovered after deletion - Consider disabling instead of deleting for temporary pauses

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[NoneType]

Returns:

Returns the result object.

async delete_webhook_subscription_without_preload_content(subscription_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Delete webhook subscription

Permanently delete a webhook subscription and stop all event deliveries. This action cannot be undone. ### Important Notes - All webhook deliveries will cease immediately - Subscription cannot be recovered after deletion - Consider disabling instead of deleting for temporary pauses

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async get_webhook_subscription(subscription_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get webhook subscription

Retrieve detailed information about a specific webhook subscription including configuration, status, creation timestamp, and webhook signature secret. ### Response Includes - Subscription configuration and filters - Target URL and custom headers - Webhook signature secret for verification - Creation timestamp and status

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

WebhookSubscriptionResponse

Returns:

Returns the result object.

async get_webhook_subscription_with_http_info(subscription_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get webhook subscription

Retrieve detailed information about a specific webhook subscription including configuration, status, creation timestamp, and webhook signature secret. ### Response Includes - Subscription configuration and filters - Target URL and custom headers - Webhook signature secret for verification - Creation timestamp and status

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[WebhookSubscriptionResponse]

Returns:

Returns the result object.

async get_webhook_subscription_without_preload_content(subscription_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get webhook subscription

Retrieve detailed information about a specific webhook subscription including configuration, status, creation timestamp, and webhook signature secret. ### Response Includes - Subscription configuration and filters - Target URL and custom headers - Webhook signature secret for verification - Creation timestamp and status

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_webhook_subscription_events(subscription_id, event_id=None, min_created_at=None, max_created_at=None, event_type_names=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List webhook subscription events

Retrieve webhook event delivery attempts for a specific subscription. Returns event deliveries in descending order by creation time (newest first), including delivery status, retry count, and response details. ### Use Cases - Debug webhook delivery failures and inspect response codes - Monitor delivery status and retry counts - Audit event delivery history for a subscription - Verify that expected events were sent to webhook URLs ### Filtering Use optional query parameters to narrow results: - eventId — find a specific event by ID - minCreatedAt / maxCreatedAt — filter by time range - eventTypeNames — filter by event type (comma-separated) Note: Results are limited to the 50 most recent events (newest first). No pagination is supported.

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • event_id (str) – Filter by a specific event ID.

  • min_created_at (datetime) – Filter events created at or after this timestamp (RFC 3339 format).

  • max_created_at (datetime) – Filter events created at or before this timestamp (RFC 3339 format).

  • event_type_names (str) – Filter by event type names (comma-separated).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

WebhookEventListResponse

Returns:

Returns the result object.

async list_webhook_subscription_events_with_http_info(subscription_id, event_id=None, min_created_at=None, max_created_at=None, event_type_names=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List webhook subscription events

Retrieve webhook event delivery attempts for a specific subscription. Returns event deliveries in descending order by creation time (newest first), including delivery status, retry count, and response details. ### Use Cases - Debug webhook delivery failures and inspect response codes - Monitor delivery status and retry counts - Audit event delivery history for a subscription - Verify that expected events were sent to webhook URLs ### Filtering Use optional query parameters to narrow results: - eventId — find a specific event by ID - minCreatedAt / maxCreatedAt — filter by time range - eventTypeNames — filter by event type (comma-separated) Note: Results are limited to the 50 most recent events (newest first). No pagination is supported.

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • event_id (str) – Filter by a specific event ID.

  • min_created_at (datetime) – Filter events created at or after this timestamp (RFC 3339 format).

  • max_created_at (datetime) – Filter events created at or before this timestamp (RFC 3339 format).

  • event_type_names (str) – Filter by event type names (comma-separated).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[WebhookEventListResponse]

Returns:

Returns the result object.

async list_webhook_subscription_events_without_preload_content(subscription_id, event_id=None, min_created_at=None, max_created_at=None, event_type_names=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List webhook subscription events

Retrieve webhook event delivery attempts for a specific subscription. Returns event deliveries in descending order by creation time (newest first), including delivery status, retry count, and response details. ### Use Cases - Debug webhook delivery failures and inspect response codes - Monitor delivery status and retry counts - Audit event delivery history for a subscription - Verify that expected events were sent to webhook URLs ### Filtering Use optional query parameters to narrow results: - eventId — find a specific event by ID - minCreatedAt / maxCreatedAt — filter by time range - eventTypeNames — filter by event type (comma-separated) Note: Results are limited to the 50 most recent events (newest first). No pagination is supported.

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • event_id (str) – Filter by a specific event ID.

  • min_created_at (datetime) – Filter events created at or after this timestamp (RFC 3339 format).

  • max_created_at (datetime) – Filter events created at or before this timestamp (RFC 3339 format).

  • event_type_names (str) – Filter by event type names (comma-separated).

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_webhook_subscriptions(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List webhook subscriptions

Retrieve a paginated list of webhook subscriptions for the authenticated project. Returns subscriptions for all CDP product events (onchain, onramp/offramp, wallet, etc.) in descending order by creation time. ### Use Cases - Monitor all active webhook subscriptions across CDP products - Audit webhook configurations - Manage subscription lifecycle

Parameters:
  • page_size (int) – The number of subscriptions to return per page.

  • page_token (str) – The token for the next page of subscriptions, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

WebhookSubscriptionListResponse

Returns:

Returns the result object.

async list_webhook_subscriptions_with_http_info(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List webhook subscriptions

Retrieve a paginated list of webhook subscriptions for the authenticated project. Returns subscriptions for all CDP product events (onchain, onramp/offramp, wallet, etc.) in descending order by creation time. ### Use Cases - Monitor all active webhook subscriptions across CDP products - Audit webhook configurations - Manage subscription lifecycle

Parameters:
  • page_size (int) – The number of subscriptions to return per page.

  • page_token (str) – The token for the next page of subscriptions, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[WebhookSubscriptionListResponse]

Returns:

Returns the result object.

async list_webhook_subscriptions_without_preload_content(page_size=None, page_token=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List webhook subscriptions

Retrieve a paginated list of webhook subscriptions for the authenticated project. Returns subscriptions for all CDP product events (onchain, onramp/offramp, wallet, etc.) in descending order by creation time. ### Use Cases - Monitor all active webhook subscriptions across CDP products - Audit webhook configurations - Manage subscription lifecycle

Parameters:
  • page_size (int) – The number of subscriptions to return per page.

  • page_token (str) – The token for the next page of subscriptions, if any.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async update_webhook_subscription(subscription_id, webhook_subscription_update_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update webhook subscription

Update an existing webhook subscription’s configuration including event types, target URL, filtering criteria, and enabled status. All required fields must be provided, even if they are not being changed. ### Common Updates - Change target URL or headers - Add/remove event type filters - Update multi-label filtering criteria - Enable/disable subscription

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • webhook_subscription_update_request (WebhookSubscriptionUpdateRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

WebhookSubscriptionResponse

Returns:

Returns the result object.

async update_webhook_subscription_with_http_info(subscription_id, webhook_subscription_update_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update webhook subscription

Update an existing webhook subscription’s configuration including event types, target URL, filtering criteria, and enabled status. All required fields must be provided, even if they are not being changed. ### Common Updates - Change target URL or headers - Add/remove event type filters - Update multi-label filtering criteria - Enable/disable subscription

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • webhook_subscription_update_request (WebhookSubscriptionUpdateRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[WebhookSubscriptionResponse]

Returns:

Returns the result object.

async update_webhook_subscription_without_preload_content(subscription_id, webhook_subscription_update_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Update webhook subscription

Update an existing webhook subscription’s configuration including event types, target URL, filtering criteria, and enabled status. All required fields must be provided, even if they are not being changed. ### Common Updates - Change target URL or headers - Add/remove event type filters - Update multi-label filtering criteria - Enable/disable subscription

Parameters:
  • subscription_id (str) – Unique identifier for the webhook subscription. (required)

  • webhook_subscription_update_request (WebhookSubscriptionUpdateRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

cdp.openapi_client.api.x402_facilitator_api module

Coinbase Developer Platform APIs

The Coinbase Developer Platform APIs - leading the world’s transition onchain.

The version of the OpenAPI document: 2.0.0 Contact: cdp@coinbase.com Generated by OpenAPI Generator (https://openapi-generator.tech)

Do not edit the class manually.

class cdp.openapi_client.api.x402_facilitator_api.X402FacilitatorApi(api_client=None)

Bases: object

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

async list_x402_discovery_merchant(pay_to, limit=None, offset=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List merchant discovery info

Gets x402 merchant discovery information for a given merchant payment address. This endpoint returns all active x402 resources associated with the specified payTo address, allowing clients to discover what payment-gated resources a merchant exposes and their corresponding payment requirements. If no active resources are found for the payTo address, the endpoint returns an empty resources list. The response is paginated, and by default, returns 20 items per page.

Parameters:
  • pay_to (str) – The merchant’s payment address to look up. This is the onchain address that payment requirements route funds to. (required)

  • limit (int) – The number of resources to return per page.

  • offset (int) – The offset of the first resource to return.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

X402DiscoveryMerchantResponse

Returns:

Returns the result object.

async list_x402_discovery_merchant_with_http_info(pay_to, limit=None, offset=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List merchant discovery info

Gets x402 merchant discovery information for a given merchant payment address. This endpoint returns all active x402 resources associated with the specified payTo address, allowing clients to discover what payment-gated resources a merchant exposes and their corresponding payment requirements. If no active resources are found for the payTo address, the endpoint returns an empty resources list. The response is paginated, and by default, returns 20 items per page.

Parameters:
  • pay_to (str) – The merchant’s payment address to look up. This is the onchain address that payment requirements route funds to. (required)

  • limit (int) – The number of resources to return per page.

  • offset (int) – The offset of the first resource to return.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[X402DiscoveryMerchantResponse]

Returns:

Returns the result object.

async list_x402_discovery_merchant_without_preload_content(pay_to, limit=None, offset=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List merchant discovery info

Gets x402 merchant discovery information for a given merchant payment address. This endpoint returns all active x402 resources associated with the specified payTo address, allowing clients to discover what payment-gated resources a merchant exposes and their corresponding payment requirements. If no active resources are found for the payTo address, the endpoint returns an empty resources list. The response is paginated, and by default, returns 20 items per page.

Parameters:
  • pay_to (str) – The merchant’s payment address to look up. This is the onchain address that payment requirements route funds to. (required)

  • limit (int) – The number of resources to return per page.

  • offset (int) – The offset of the first resource to return.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async list_x402_discovery_resources(type=None, limit=None, offset=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List x402 resources

Lists all active discovered x402 resources. This endpoint returns resources that have been discovered and cached by the x402 facilitator, including their payment requirements and metadata. The response is paginated, and by default, returns 100 items per page.

Parameters:
  • type (str) – Filter by protocol type (e.g., “http”, “mcp”). Currently, the only supported protocol type is “http”.

  • limit (int) – The number of discovered x402 resources to return per page.

  • offset (int) – The offset of the first discovered x402 resource to return.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

X402DiscoveryResourcesResponse

Returns:

Returns the result object.

async list_x402_discovery_resources_with_http_info(type=None, limit=None, offset=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List x402 resources

Lists all active discovered x402 resources. This endpoint returns resources that have been discovered and cached by the x402 facilitator, including their payment requirements and metadata. The response is paginated, and by default, returns 100 items per page.

Parameters:
  • type (str) – Filter by protocol type (e.g., “http”, “mcp”). Currently, the only supported protocol type is “http”.

  • limit (int) – The number of discovered x402 resources to return per page.

  • offset (int) – The offset of the first discovered x402 resource to return.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[X402DiscoveryResourcesResponse]

Returns:

Returns the result object.

async list_x402_discovery_resources_without_preload_content(type=None, limit=None, offset=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List x402 resources

Lists all active discovered x402 resources. This endpoint returns resources that have been discovered and cached by the x402 facilitator, including their payment requirements and metadata. The response is paginated, and by default, returns 100 items per page.

Parameters:
  • type (str) – Filter by protocol type (e.g., “http”, “mcp”). Currently, the only supported protocol type is “http”.

  • limit (int) – The number of discovered x402 resources to return per page.

  • offset (int) – The offset of the first discovered x402 resource to return.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async post_x402_discovery_mcp(x402_mcp_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Handle MCP JSON-RPC request

Handles JSON-RPC requests for the Model Context Protocol (MCP). Supports MCP methods for discovering x402 payment resources and tools.

Parameters:
  • x402_mcp_request (X402McpRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

X402McpResponse

Returns:

Returns the result object.

async post_x402_discovery_mcp_with_http_info(x402_mcp_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Handle MCP JSON-RPC request

Handles JSON-RPC requests for the Model Context Protocol (MCP). Supports MCP methods for discovering x402 payment resources and tools.

Parameters:
  • x402_mcp_request (X402McpRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[X402McpResponse]

Returns:

Returns the result object.

async post_x402_discovery_mcp_without_preload_content(x402_mcp_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Handle MCP JSON-RPC request

Handles JSON-RPC requests for the Model Context Protocol (MCP). Supports MCP methods for discovering x402 payment resources and tools.

Parameters:
  • x402_mcp_request (X402McpRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async search_x402_resources(query=None, network=None, asset=None, scheme=None, pay_to=None, url_substring=None, max_usd_price=None, extensions=None, limit=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Search x402 resources

Searches for active x402 resources using a text query and optional filters. Supports both text-based and vector-based search depending on availability. Results are sorted by relevance and quality score. Legacy network names (e.g., base, base-sepolia, solana) are automatically normalized to their CAIP-2 equivalents. The response is limited to 20 items per request. If more results exist, partialResults will be true.

Parameters:
  • query (str) – Full-text or semantic search query to find matching resources.

  • network (str) – Filter results by network in CAIP-2 format (e.g., eip155:8453) or legacy name (e.g., base, base-sepolia, solana). Legacy names are normalized to their CAIP-2 equivalents before filtering.

  • asset (str) – Filter results by asset address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address. Matching is case-insensitive.

  • scheme (str) – Filter results by payment scheme (e.g., exact).

  • pay_to (str) – Filter results by the merchant’s payment address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address.

  • url_substring (str) – Filter results to resources whose URL contains this value (case-insensitive substring match against the resource URL). Useful for narrowing results to a specific domain, subdomain, or path segment. Combine with query to perform semantic search restricted to a URL subset. Tip: include enough of the URL to disambiguate (e.g. api.example.com rather than example) — a short substring may also match resources whose path contains the same string.

  • max_usd_price (str) – Filter results to resources with a USD price at or below this value.

  • extensions (List[str]) – Filter results to resources that support the specified protocol extensions. Can be specified multiple times to filter by multiple extensions.

  • limit (int) – Maximum number of resources to return. Must be a positive integer no greater than 20. Defaults to 20.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

X402SearchResourcesResponse

Returns:

Returns the result object.

async search_x402_resources_with_http_info(query=None, network=None, asset=None, scheme=None, pay_to=None, url_substring=None, max_usd_price=None, extensions=None, limit=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Search x402 resources

Searches for active x402 resources using a text query and optional filters. Supports both text-based and vector-based search depending on availability. Results are sorted by relevance and quality score. Legacy network names (e.g., base, base-sepolia, solana) are automatically normalized to their CAIP-2 equivalents. The response is limited to 20 items per request. If more results exist, partialResults will be true.

Parameters:
  • query (str) – Full-text or semantic search query to find matching resources.

  • network (str) – Filter results by network in CAIP-2 format (e.g., eip155:8453) or legacy name (e.g., base, base-sepolia, solana). Legacy names are normalized to their CAIP-2 equivalents before filtering.

  • asset (str) – Filter results by asset address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address. Matching is case-insensitive.

  • scheme (str) – Filter results by payment scheme (e.g., exact).

  • pay_to (str) – Filter results by the merchant’s payment address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address.

  • url_substring (str) – Filter results to resources whose URL contains this value (case-insensitive substring match against the resource URL). Useful for narrowing results to a specific domain, subdomain, or path segment. Combine with query to perform semantic search restricted to a URL subset. Tip: include enough of the URL to disambiguate (e.g. api.example.com rather than example) — a short substring may also match resources whose path contains the same string.

  • max_usd_price (str) – Filter results to resources with a USD price at or below this value.

  • extensions (List[str]) – Filter results to resources that support the specified protocol extensions. Can be specified multiple times to filter by multiple extensions.

  • limit (int) – Maximum number of resources to return. Must be a positive integer no greater than 20. Defaults to 20.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[X402SearchResourcesResponse]

Returns:

Returns the result object.

async search_x402_resources_without_preload_content(query=None, network=None, asset=None, scheme=None, pay_to=None, url_substring=None, max_usd_price=None, extensions=None, limit=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Search x402 resources

Searches for active x402 resources using a text query and optional filters. Supports both text-based and vector-based search depending on availability. Results are sorted by relevance and quality score. Legacy network names (e.g., base, base-sepolia, solana) are automatically normalized to their CAIP-2 equivalents. The response is limited to 20 items per request. If more results exist, partialResults will be true.

Parameters:
  • query (str) – Full-text or semantic search query to find matching resources.

  • network (str) – Filter results by network in CAIP-2 format (e.g., eip155:8453) or legacy name (e.g., base, base-sepolia, solana). Legacy names are normalized to their CAIP-2 equivalents before filtering.

  • asset (str) – Filter results by asset address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address. Matching is case-insensitive.

  • scheme (str) – Filter results by payment scheme (e.g., exact).

  • pay_to (str) – Filter results by the merchant’s payment address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address.

  • url_substring (str) – Filter results to resources whose URL contains this value (case-insensitive substring match against the resource URL). Useful for narrowing results to a specific domain, subdomain, or path segment. Combine with query to perform semantic search restricted to a URL subset. Tip: include enough of the URL to disambiguate (e.g. api.example.com rather than example) — a short substring may also match resources whose path contains the same string.

  • max_usd_price (str) – Filter results to resources with a USD price at or below this value.

  • extensions (List[str]) – Filter results to resources that support the specified protocol extensions. Can be specified multiple times to filter by multiple extensions.

  • limit (int) – Maximum number of resources to return. Must be a positive integer no greater than 20. Defaults to 20.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async settle_x402_payment(verify_x402_payment_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Settle payment

Settle an x402 protocol payment with a specific scheme and network.

Parameters:
  • verify_x402_payment_request (VerifyX402PaymentRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

InlineObject1

Returns:

Returns the result object.

async settle_x402_payment_with_http_info(verify_x402_payment_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Settle payment

Settle an x402 protocol payment with a specific scheme and network.

Parameters:
  • verify_x402_payment_request (VerifyX402PaymentRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[InlineObject1]

Returns:

Returns the result object.

async settle_x402_payment_without_preload_content(verify_x402_payment_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Settle payment

Settle an x402 protocol payment with a specific scheme and network.

Parameters:
  • verify_x402_payment_request (VerifyX402PaymentRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async supported_x402_payment_kinds(_request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get supported payment schemes and networks

Get the supported x402 protocol payment schemes and networks that the facilitator is able to verify and settle payments for.

Parameters:
  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

InlineObject2

Returns:

Returns the result object.

async supported_x402_payment_kinds_with_http_info(_request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get supported payment schemes and networks

Get the supported x402 protocol payment schemes and networks that the facilitator is able to verify and settle payments for.

Parameters:
  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[InlineObject2]

Returns:

Returns the result object.

async supported_x402_payment_kinds_without_preload_content(_request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get supported payment schemes and networks

Get the supported x402 protocol payment schemes and networks that the facilitator is able to verify and settle payments for.

Parameters:
  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async validate_x402_resource(x402_validate_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Validate x402 endpoint

Validates an x402 endpoint’s bazaar-discovery configuration by probing the seller’s URL live. Returns a uniform array of preflight check results (reachable, returns402, hasBazaarExtension, parse) and a simulated facilitator accept/reject decision so sellers and agents can confirm their endpoint is ready to be discovered before going live. This operation is read-only: it performs no payment and does not index the resource.

Parameters:
  • x402_validate_request (X402ValidateRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

X402ValidateResponse

Returns:

Returns the result object.

async validate_x402_resource_with_http_info(x402_validate_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Validate x402 endpoint

Validates an x402 endpoint’s bazaar-discovery configuration by probing the seller’s URL live. Returns a uniform array of preflight check results (reachable, returns402, hasBazaarExtension, parse) and a simulated facilitator accept/reject decision so sellers and agents can confirm their endpoint is ready to be discovered before going live. This operation is read-only: it performs no payment and does not index the resource.

Parameters:
  • x402_validate_request (X402ValidateRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[X402ValidateResponse]

Returns:

Returns the result object.

async validate_x402_resource_without_preload_content(x402_validate_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Validate x402 endpoint

Validates an x402 endpoint’s bazaar-discovery configuration by probing the seller’s URL live. Returns a uniform array of preflight check results (reachable, returns402, hasBazaarExtension, parse) and a simulated facilitator accept/reject decision so sellers and agents can confirm their endpoint is ready to be discovered before going live. This operation is read-only: it performs no payment and does not index the resource.

Parameters:
  • x402_validate_request (X402ValidateRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

async verify_x402_payment(verify_x402_payment_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Verify payment

Verify an x402 protocol payment with a specific scheme and network.

Parameters:
  • verify_x402_payment_request (VerifyX402PaymentRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

InlineObject

Returns:

Returns the result object.

async verify_x402_payment_with_http_info(verify_x402_payment_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Verify payment

Verify an x402 protocol payment with a specific scheme and network.

Parameters:
  • verify_x402_payment_request (VerifyX402PaymentRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ApiResponse[InlineObject]

Returns:

Returns the result object.

async verify_x402_payment_without_preload_content(verify_x402_payment_request, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Verify payment

Verify an x402 protocol payment with a specific scheme and network.

Parameters:
  • verify_x402_payment_request (VerifyX402PaymentRequest) – (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ClientResponse

Returns:

Returns the result object.

Module contents