Java server quickstart

ChainsFlow portfolio API Java quickstart

Request an API-key-scoped normalized portfolio using Java. The example shows the smallest safe server-side flow; exchange credentials are added through the portfolio endpoint.

Personal token stays on the server
Portfolio IDs are opaque resources
Credit headers make usage observable

Copyable server example

Request example

var client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(5))
    .build();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.chainsflow.com/api/v1/portfolio"))
    .header("X-API-Key", System.getenv("CHAINSFLOW_API_KEY"))
    .timeout(Duration.ofSeconds(10))
    .GET()
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());

Store authentication outside source code

Java HttpClient keeps the dependency surface small; wrap it in one typed infrastructure adapter rather than calling it from controllers.

Use resource IDs returned by the API

Create portfolios with POST /api/v1/portfolios and persist the returned portfolioId in your backend. The API key defines the ownership boundary.

Handle the response contract

Check the HTTP status before decoding success data. Errors use application/problem+json; metered success responses include credit cost and remaining balance headers.

Contract and official references

ChainsFlow public OpenAPI specification ↗