Introducing the Advanced Trade Java SDK

Coinbase Advanced Trade is our most advanced trading platform, designed to support experienced traders and institutions alike. The Advanced Trade API provides the ability to create and manage orders, view products, perform conversions and more. To expand our existing coverage of Coinbase products with sample SDKs (Python, Typescript, Go), we have released the Advanced Trade Java SDK. This SDK equips Java developers with tools to seamlessly integrate with Coinbase Advanced Trade and take full advantage of its features.

As one of the world’s most popular programming languages, Java is particularly valuable in both financial institutions and among sophisticated retail developers. Its proven reliability and performance make it ideal for trading environments where even the smallest delays can have a huge impact. With Java’s ability to run across platforms without modification, developers—whether institutional or advanced retail traders—can count on versatility and efficiency. We’ve heard from our clients—both retail and institutional—about the need for a robust Java SDK, and we’re thrilled to meet that demand.

The Advanced Trade SDK offers a wide array of functionalities designed to simplify and enhance client interaction with Coinbase's trading platforms. Here are some key features:

The Advanced Trade SDK is vended through Maven. Simply include the following dependency in your pom.xml file:

<dependency>

    <groupId>com.coinbase.advanced</groupId>

    <artifactId>coinbase-advanced-sdk-java</artifactId>

    <version>x.y.z</version>

</dependency>

Before proceeding with the above, make sure to check for the latest version on Maven.

To use the Coinbase Advanced Java SDK, initialize the Credentials class and create a new client. The Credentials class is JSON-enabled, making it easy to securely store and manage API credentials. API credentials are created directly from the Coinbase web UI. Ensure that your API credentials are stored in a secure manner.

First, initialize the Credentials class and create a new client. See an example of this inside of the examples package.

String credsStringBlob = System.getenv("ADVANCED_TRADE_CREDENTIALS");

ObjectMapper mapper = new ObjectMapper();

CoinbaseAdvancedCredentials credentials = new CoinbaseAdvancedCredentials(credsStringBlob);

CoinbaseAdvancedClient client = new CoinbaseAdvancedClient(credentials);

To see a working example of the SDK, the repository contains an examples package that highlights how to construct the SDK Client, instantiate Credentials, and create an order.

public class Main {

    public static void main(String[] args) {

        try {

            String credsStringBlob = System.getenv("ADVANCED_TRADE_CREDENTIALS");

            if (credsStringBlob == null) {

                throw new RuntimeException("ADVANCED_TRADE_CREDENTIALS environment variable is not set");

            }

            ObjectMapper mapper = new ObjectMapper();

            CoinbaseAdvancedCredentials credentials = new CoinbaseAdvancedCredentials(credsStringBlob);

            CoinbaseAdvancedClient client = new CoinbaseAdvancedClient(credentials);

            PortfoliosService portfolioService = CoinbaseAdvancedServiceFactory.createPortfoliosService(client);

            ListPortfoliosRequest listReq = new ListPortfoliosRequest();

            ListPortfoliosResponse listResponse = portfolioService.listPortfolios(listReq);

            String prettyJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(listResponse);

            System.out.println("List Portfolios Response:");

            System.out.println(prettyJson);

            OrdersService ordersService = CoinbaseAdvancedServiceFactory.createOrdersService(client);

            CreateOrderRequest createOrderRequest = new CreateOrderRequest.Builder()

                    .clientOrderId(UUID.randomUUID().toString())

                    .productId("ADA-USD")

                    .retailPortfolioId(listResponse.getPortfolios().get(0).getUuid())

                    .side("BUY")

                    .orderConfiguration(

                            new OrderConfiguration.Builder()

                                    .marketMarketIoc(

                                            new MarketIoc.Builder()

                                                    .baseSize("1")

                                                    .build())

                                    .build()

                    )

                    .build();

            CreateOrderResponse createOrderResponse = ordersService.createOrder(createOrderRequest);

            prettyJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(createOrderResponse);

            System.out.println("Create Order Response");

            System.out.println(prettyJson);

        } catch (Throwable e) {

            throw new RuntimeException("Failed to retrieve the list portfolios response", e);

        }

    }

}

With the release of the Advanced Trade Java SDK, we’re making it easier for retail traders to integrate Coinbase’s advanced trading tools into their existing workflows. Whether you're building small-scale applications or large trading systems, this SDK gives you the flexibility and power to meet your trading needs efficiently and securely.

- -

Disclaimer: This application should never be used in any production environment, and any real funds used in this application may be lost. Additionally, this information is provided for informational purposes only and is not investment advice. This is not a recommendation to buy or sell digital assets or to employ a particular investment strategy, codes, or APIs. Coinbase makes no representation on the accuracy, suitability, or validity of any information provided herein.

This material is for informational purposes only and is not (i) an offer, or solicitation of an offer, to invest in, or to buy or sell, any interests or shares, or to participate in any investment or trading strategy, or (ii) intended to provide accounting, legal, or tax advice, or investment recommendations. No representation or warranty is made, expressed or implied, with respect to the accuracy or completeness of the information or to the future performance of any digital asset, financial instrument or other market or economic measure. The information is believed to be current as of the date indicated and may not be updated or otherwise revised to reflect information that subsequently became available or a change in circumstances after the date of publication. Investing in cryptocurrency comes with risk. Prior results do not guarantee future performance. Readers should consult their advisors before making any investment decision. Any references to third parties do not imply Coinbase's endorsement, or approval of any third-party websites or their content. This material is the property of Coinbase, Inc. Any use, review, retransmission, distribution, or reproduction of these materials, in whole or in part, is strictly prohibited in any form without the express written approval of Coinbase. Coinbase, Inc. is licensed to engage in virtual currency business activity by the New York State Department of Financial Services. © 2024 Coinbase, Inc. All Rights Reserved. COINBASE, the C Logo, and the Wallet Logo are all trademarks of Coinbase, Inc.