A unified API to create, manage, and invest in crypto baskets with Index, Custom and AI-generated recommendations across any CEX or DEX.
Overview
The Crypto Basket API lets your users invest in diversified, automatically rebalanced crypto portfolios in a single action. Instead of placing individual trades across tokens, a basket bundles multiple assets with weighted allocations and handles all exchange-level execution behind the scenes.
You can build full basket investment flows: browse baskets, invest, track positions, sell, and even let users create their own baskets manually or with AI assistance.
Full lifecycle coverage
Browse Baskets
List curated standard baskets or user-created custom baskets
Invest
Buy into a basket on a connected exchange with a single order
Manage Positions
View active subscriptions with live asset breakdowns
Sell
Partially or fully exit a basket position
Custom Baskets
Let users define their own weighted token portfolios
AI Baskets
Generate a basket recommendation from risk, sectors, and time horizon
Authentication
All requests require a Bearer token in the Authorization header.
Authorization: Bearer <token>
Base URL
Standard basket endpoints use the default API base URL. Trading balance calls (/trading/balance) route to an exchange-specific trading host.
Monetary Values
All monetary values are returned as decimal strings (e.g. "100.50"). Parse with a BigNumber-compatible library to avoid floating-point errors.
Supported Exchanges
coinbase
crypto_com
binance
bybit
Key Features
Works across Coinbase, Crypto.com, Binance, and Bybit from a single integration.
Configurable rebalancing frequency per subscription: daily, weekly, monthly, or none.
Optional downside protection on buy orders to limit user exposure.
Generate basket recommendations from risk appetite, sectors, and time horizon inputs.
Live USD value, 24h change, and per-asset price breakdowns on every basket.
Track pending buy/sell orders through every stage to completion.
Common Use Cases
| Use Case | What to call |
|---|---|
| Display available baskets | GET /baskets/ |
| Show a user's active positions | GET /subscriptions/with-assets |
| Invest in a basket | GET .../buy/params → POST /subscription-orders/buy |
| Sell out of a basket | GET .../sell/params → POST /subscription-orders/Sell or POST /subscriptions/:id/unsubscribe |
| Create a custom basket | POST /custom-baskets |
| AI-generate a basket | POST /custom-baskets/generate |
API Reference
Click any endpoint to expand full request and response documentation.
Basket Listing & Details
Invest Flow
Sell Flow
Custom Basket Flow
AI Basket Flow
Utilities
Reference
Valid string values for enum fields used across all endpoints.
| Field | Values |
|---|---|
| exchange | coinbase | crypto_com | binance | bybit |
| reconstitutionFrequency | DAILY | WEEKLY | FORTNIGHTLY | MONTHLY | QUARTERLY | NO_REBALANCE |
| rebalancingFrequency | 1DAY | 7DAYS | 14DAYS | 1MONTH | 6MONTHS |
| unavailableCoinAction | CANCEL_ORDER | REWEIGHT |
| subscriptionStatus | ACTIVE | CANCELED | DISCONNECTED |
| riskAppetite | CONSERVATIVE | MODERATE | AGGRESSIVE | FULL_DEGEN |
| timeHorizon | SHORT_TERM | MEDIUM_TERM | LONG_TERM | HOLD_FOREVER |
| basketDiversity | FOCUSED | BALANCED | BROAD |
"100.50"). Parse with a BigNumber-compatible library on the client side to avoid floating-point errors.Book a 15-minute strategy call and we'll map the integration to your stack.