Python server quickstart

ChainsFlow portfolio API Python quickstart

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

import os
import requests

headers = {"X-API-Key": os.environ["CHAINSFLOW_API_KEY"]}
base = "https://api.chainsflow.com"
response = requests.get(f"{base}/api/v1/portfolio", headers=headers, timeout=10)
response.raise_for_status()
portfolio = response.json()

Store authentication outside source code

Keep the token in an environment-backed server secret and give every request an explicit timeout.

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 ↗