TypeScript server quickstart

ChainsFlow portfolio API TypeScript quickstart

Request an API-key-scoped normalized portfolio using TypeScript. 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

const headers = { "X-API-Key": process.env.CHAINSFLOW_API_KEY! };
const response = await fetch(
  "https://api.chainsflow.com/api/v1/portfolio",
  { headers }
);
if (!response.ok) throw await response.json();
const portfolio = await response.json();

Store authentication outside source code

Use native fetch in a trusted Node or server runtime. The browser must call your backend, not ChainsFlow with a secret token.

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 ↗