# Cielo Public API > Programmatic access to the on-chain data that powers Cielo Finance — the wallet activity feed, wallet PnL and trading stats, token metadata, prices and safety checks, wallet tags and related wallets, portfolio tracking, and on-chain trading. Authenticate with an API key sent in the X-API-KEY header. Each endpoint notes its credit cost and the plans it is available on. - Base URL: `https://api.cielo.finance` - OpenAPI spec: `https://api.cielo.finance/swagger/openapi.json` - Swagger UI: https://api.cielo.finance/swagger - Developer guides: https://docs.cielo.finance/developer-api/getting-started - Product docs: https://docs.cielo.finance - Full single-file LLM docs: https://api.cielo.finance/llms-full.txt ## Authentication Every request must carry an API key in the `X-API-KEY` header. Manage keys from the Cielo app. --- # Endpoints ## Feed | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/feed` | Feed | ## Web Socket | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/ws` | WebSocket Connection | ## Wallet | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/wallet/positions` | Wallet Token Positions | | GET | `/api/v1/{wallet}/enhanced-stats/aggregated` | Enhanced Aggregated Stats | | GET | `/api/v1/{wallet}/enhanced-stats/profitability-performance` | Profitability & Performance Stats | | GET | `/api/v1/{wallet}/pnl/month` | Monthly PnL | | GET | `/api/v1/{wallet}/pnl/nfts` | NFT PNL | | GET | `/api/v1/{wallet}/pnl/tokens` | Token PNL | | GET | `/api/v1/{wallet}/pnl/tokens-chart` | PnL Tokens Chart | | GET | `/api/v1/{wallet}/pnl/total-stats` | Aggregated Token PNL | | GET | `/api/v1/{wallet}/portfolio` | Wallet Portfolio | | GET | `/api/v1/{wallet}/related-wallets` | Related Wallets | | GET | `/api/v1/{wallet}/token-balance` | Token Balance | | GET | `/api/v1/{wallet}/trading-stats` | Trading Stats | | GET | `/api/v2/enhanced-stats/aggregated` | Enhanced Aggregated Stats V2 | ## Tags | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/tags` | Wallets Tags | | GET | `/api/v1/tags/wallets` | Wallets by Tag | | GET | `/api/v1/{wallet}/tags` | Tags | ## Token | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/token/checklist` | Token checklist | | GET | `/api/v1/token/metadata` | Token metadata | | GET | `/api/v1/token/price` | Token price | | GET | `/api/v1/token/stats` | Token stats | | GET | `/api/v1/token/stats-liquidity` | Token liquidity slice | | GET | `/api/v1/trending-tokens` | Trending tokens | | GET | `/api/v2/new-token-flows` | New Token Flows | | GET | `/api/v2/token-flows` | Token Flows V2 | ## Chains | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/chains` | Supported Chains | ## Wallet Management | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/tracked-wallets` | Get Tracked Wallets | | POST | `/api/v1/tracked-wallets` | Add Tracked Wallet | | DELETE | `/api/v1/tracked-wallets` | Remove Tracked Wallets | | GET | `/api/v1/tracked-wallets/address/{wallet}` | Get Wallet By Address | | GET | `/api/v1/tracked-wallets/telegram-bots` | Get Available Telegram Bots | | PUT | `/api/v1/tracked-wallets/{wallet_id}` | Update Tracked Wallet | | PUT | `/api/v2/tracked-wallets/{wallet}` | Update Tracked Wallet v2 | ## Lists | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/v1/lists/` | Get all lists for a user | | POST | `/api/v1/lists/` | Add a list | | GET | `/api/v1/lists/all` | Get all wallets lists | | PUT | `/api/v1/lists/{list_id}` | Update a list | | DELETE | `/api/v1/lists/{list_id}` | Delete a list | | PUT | `/api/v1/lists/{list_id}/toggle-follow` | Toggle follow a list | ## Trading Wallets | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/trading/wallets` | Get Trading Wallets | | POST | `/api/trading/wallets` | Create Trading Wallet | | GET | `/api/trading/wallets/default` | Get Default Trading Wallet | | PUT | `/api/trading/wallets/{wallet_id}/default` | Set Default Trading Wallet | | PUT | `/api/trading/wallets/{wallet_id}/name` | Rename Trading Wallet | ## Solana Trading | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/trading/solana/v2/quote` | Get Solana Swap Quote (v2) | ## Base Trading | Method | Endpoint | Summary | |--------|----------|---------| | GET | `/api/trading/base/v2/quote` | Get Base Chain Swap Quote | | POST | `/api/trading/base/v2/swap` | Execute Base Chain Swap |