Overview - Coinbase Developer Documentation

The CDP Java SDK is generated from the CDP OpenAPI definition and exposed through the canonical com.coinbase.cdp package.

Installation

The Java SDK is distributed through GitHub Packages. Configure Gradle with a GitHub token that has the read:packages scope.

Add credentials to ~/.gradle/gradle.properties:

gpr.user=YOUR_GITHUB_USERNAME
gpr.token=YOUR_GITHUB_PERSONAL_ACCESS_TOKEN

Add the GitHub Packages repository and dependency to build.gradle.kts:

repositories {
    mavenCentral()
    maven {
        url = uri("https://maven.pkg.github.com/coinbase/cdp-sdk")
        credentials {
            username = project.findProperty("gpr.user") as String? ?: System.getenv("GITHUB_ACTOR")
            password = project.findProperty("gpr.token") as String? ?: System.getenv("GITHUB_TOKEN")
        }
    }
}

dependencies {
    implementation("com.coinbase:cdp-sdk:<version>")
}

Configure a client

import com.coinbase.cdp.CdpClient;

CdpClient client = CdpClient.builder()
    .credentials(System.getenv("CDP_API_KEY_ID"), System.getenv("CDP_API_KEY_SECRET"))
    .walletSecret(System.getenv("CDP_WALLET_SECRET"))
    .build();

CDP_WALLET_SECRET is required only for operations that require wallet authentication. API-key-authenticated flexible custody operations do not require it.

API resources

The client exposes API resources such as:

client.evmAccounts() and client.evmSmartAccounts()
client.solanaAccounts()
client.accounts(), client.paymentMethods(), client.depositDestinations(), and client.transfers()
client.policyEngine(), client.endUserAccountManagement(), and client.endUserAccounts()

End User Accounts operations that require end-user-only authentication are intentionally not included in this backend SDK. API reference documentation is available at CDP Java SDK API Reference. Runnable usage examples are available at https://github.com/coinbase/cdp-sdk/tree/main/examples/java.