# Cambrian API Documentation This is a comprehensive API for blockchain and DeFi data, providing real-time and historical information across multiple chains including Solana, Base, and other EVM networks. ## OpenAPI Specifications Machine-readable API specs for client generation, AI tooling, and integration: - **DeFi Data API**: https://opabinia.cambrian.network/openapi.json Prices, pools, tokens, portfolios for Solana & EVM chains - **Risk Analysis API**: https://risk.cambrian.network/openapi.json Protocol risk metrics and security assessments Interactive spec browser: https://docs.cambrian.org/specs ## Documentation Access **For LLMs**: All documentation links below end with `/llms.txt` - this provides machine-readable markdown format. **For Humans**: Remove the `/llms.txt` suffix from any link below to view the interactive documentation with a user-friendly interface and ability to test endpoints without providing an API key, which is otherwise required for making requests. **Example**: - LLM format: https://docs.cambrian.org/api/v1/solana/pool-transactions/llms.txt - Human format: https://docs.cambrian.org/api/v1/solana/pool-transactions ## API Key Required **IMPORTANT**: You need a Cambrian API key to use this API. Please obtain your API key from the Cambrian team before making requests to any endpoints. Signup for an API key here: https://form.typeform.com/to/FlAoEzva?typeform-source=www.docs.cambrian.org/llms.txt ## Available Endpoints ### Solana #### Ohlcv ##### Base quote - **Cambrian API** GET /api/v1/solana/ohlcv/base-quote - Retrieve granular OHLCV data with separate base and quote token volumes for detailed trading analysis between any two SPL tokens. Provides the most detailed view of trading relationships with individual token flow tracking for advanced analytics. - Docs: https://docs.cambrian.org/api/v1/solana/ohlcv/base-quote/llms.txt ##### Pool - **Cambrian API** GET /api/v1/solana/ohlcv/pool - Retrieve OHLCV data for individual pool contracts enabling pair-specific price analysis and liquidity venue performance tracking. Essential for liquidity providers analyzing their specific pool performance and traders focusing on particular trading venues. - Docs: https://docs.cambrian.org/api/v1/solana/ohlcv/pool/llms.txt ##### Token - **Cambrian API** GET /api/v1/solana/ohlcv/token - Retrieve Open, High, Low, Close, and Volume data for any SPL token. - Docs: https://docs.cambrian.org/api/v1/solana/ohlcv/token/llms.txt #### Orca ##### Pools - **Cambrian API** GET /api/v1/solana/orca/pools - Retrieves a list of all Orca pools registered in the backend database (orca_pool_registry_target). It provides essential static information about each pool. - Docs: https://docs.cambrian.org/api/v1/solana/orca/pools/llms.txt ###### Fee metrics - **Cambrian API** GET /api/v1/solana/orca/pools/fee-metrics - Retrieves core metrics like fees (total, token0, token1, USD), volume (token0, token1, USD), Total Value Locked (TVL) in USD, and calculated Fee APR for a specific Orca Whirlpool over a given timeframe. - Docs: https://docs.cambrian.org/api/v1/solana/orca/pools/fee-metrics/llms.txt ###### Fee ranges - **Cambrian API** GET /api/v1/solana/orca/pools/fee-ranges - Retrieves fee APR and swap utilization data categorized by price ranges relative to the current price for a specific Orca Whirlpool. - Docs: https://docs.cambrian.org/api/v1/solana/orca/pools/fee-ranges/llms.txt ###### Historical data - **Cambrian API** GET /api/v1/solana/orca/pools/historical-data - Retrieves historical daily fee and volume data (in USD) for a specific Orca Whirlpool over a specified timeframe. - Docs: https://docs.cambrian.org/api/v1/solana/orca/pools/historical-data/llms.txt ###### Liquidity map - **Cambrian API** GET /api/v1/solana/orca/pools/liquidity-map - Retrieves the distribution of net liquidity across price ticks for a specific Orca Whirlpool. Returns liquidity values at representative tick intervals based on the specified resolution. Pool Must be created after 2025-02-27 - Docs: https://docs.cambrian.org/api/v1/solana/orca/pools/liquidity-map/llms.txt ##### Pool - **Cambrian API** GET /api/v1/solana/orca/pool - Retrieves detailed metrics and information for a specific Solana pool (identified by its program ID/address) using the pre-calculated orca_pool_details_view. - Docs: https://docs.cambrian.org/api/v1/solana/orca/pool/llms.txt ##### Pool multi - **Cambrian API** GET /api/v1/solana/orca/pool-multi - Get comprehensive overview metrics for multiple pools/pairs simultaneously within the same DEX. Returns pool details including price, volume, trades, and token information. - Docs: https://docs.cambrian.org/api/v1/solana/orca/pool-multi/llms.txt #### Meteora dlmm ##### Pool - **Cambrian API** GET /api/v1/solana/meteora-dlmm/pool - This endpoint returns basic pool information for a meteora pool. - Docs: https://docs.cambrian.org/api/v1/solana/meteora-dlmm/pool/llms.txt ##### Pool multi - **Cambrian API** GET /api/v1/solana/meteora-dlmm/pool-multi - Get comprehensive overview metrics for multiple pools/pairs simultaneously within the same DEX. Returns pool details including price, volume, trades, and token information. - Docs: https://docs.cambrian.org/api/v1/solana/meteora-dlmm/pool-multi/llms.txt ##### Pools - **Cambrian API** GET /api/v1/solana/meteora-dlmm/pools - This endpoint lists meteora pools - Docs: https://docs.cambrian.org/api/v1/solana/meteora-dlmm/pools/llms.txt #### Raydium clmm ##### Pool - **Cambrian API** GET /api/v1/solana/raydium-clmm/pool - This endpoint returns pool info for a specific raydium clmm pool. Among metrics returned are, tvl, apr24h, volume24h - Docs: https://docs.cambrian.org/api/v1/solana/raydium-clmm/pool/llms.txt ##### Pool multi - **Cambrian API** GET /api/v1/solana/raydium-clmm/pool-multi - Get comprehensive overview metrics for multiple pools/pairs simultaneously within the same DEX. Returns pool details including price, volume, trades, and token information. - Docs: https://docs.cambrian.org/api/v1/solana/raydium-clmm/pool-multi/llms.txt ##### Pools - **Cambrian API** GET /api/v1/solana/raydium-clmm/pools - This endpoint lists basic pool information for Raydium CLMM - Docs: https://docs.cambrian.org/api/v1/solana/raydium-clmm/pools/llms.txt #### Tokens - **Cambrian API** GET /api/v1/solana/tokens - Returns a paginated list of known tokens for the Solana chain. - Docs: https://docs.cambrian.org/api/v1/solana/tokens/llms.txt ##### Holder distribution over time - **Cambrian API** GET /api/v1/solana/tokens/holder-distribution-over-time - This endpoint returns the distribution of token holders over a certain block range, at a certain interval, grouped by USD value tiers. - Docs: https://docs.cambrian.org/api/v1/solana/tokens/holder-distribution-over-time/llms.txt ##### Holders - **Cambrian API** GET /api/v1/solana/tokens/holders - Returns a list of accounts currently holding a specific Solana token (identified by its program ID/mint address), sorted by their current balance (descending). This endpoint leverages pre-aggregated data for performance. - Docs: https://docs.cambrian.org/api/v1/solana/tokens/holders/llms.txt ##### Holders over time - **Cambrian API** GET /api/v1/solana/tokens/holders-over-time - Returns a list of accounts holding a specific token (identified by its program ID/mint address) on Solana, providing snapshots at specified block intervals within a given range. First block gives full list of holders while subsequent blocks only provide holders that had balance changes in that interval. Results are sorted by block number (ascending) and then balance (descending) within each block. - Docs: https://docs.cambrian.org/api/v1/solana/tokens/holders-over-time/llms.txt ##### Security - **Cambrian API** GET /api/v1/solana/tokens/security - Provides comprehensive security analysis for a token on Solana, including ownership concentration, holder distribution, and transaction metrics. - Docs: https://docs.cambrian.org/api/v1/solana/tokens/security/llms.txt #### Price volume ##### Multi - **Cambrian API** GET /api/v1/solana/price-volume/multi - Retrieve current USD price, timeframe volume, and percentage changes for any SPL token. Combines price and volume data in a single request to reduce API calls and improve application performance. Data aggregated across major Solana DEXs. - Docs: https://docs.cambrian.org/api/v1/solana/price-volume/multi/llms.txt ##### Single - **Cambrian API** GET /api/v1/solana/price-volume/single - Retrieve current USD price, timeframe volume, and percentage changes for any SPL token. Combines price and volume data in a single request to reduce API calls and improve application performance. Data aggregated across major Solana DEXs. - Docs: https://docs.cambrian.org/api/v1/solana/price-volume/single/llms.txt #### Traders ##### Leaderboard - **Cambrian API** GET /api/v1/solana/traders/leaderboard - Leaderboard of the top traders by trade count, buy/sell/total volume for any SPL token across major Solana DEXs, for a specified recent interval. Supports front-end sorting of columns. Available columns for sorting are: total_volume, buy_volume, sell_volume, trade_count. - Docs: https://docs.cambrian.org/api/v1/solana/traders/leaderboard/llms.txt #### Holder token balances - **Cambrian API** GET /api/v1/solana/holder-token-balances - This endpoint returns token balances in usd for a specific user wallet, sorted by balance descending - Docs: https://docs.cambrian.org/api/v1/solana/holder-token-balances/llms.txt #### Latest block - **Cambrian API** GET /api/v1/solana/latest-block - This endpoint returns latest block and block time - Docs: https://docs.cambrian.org/api/v1/solana/latest-block/llms.txt #### Pool transactions - **Cambrian API** GET /api/v1/solana/pool-transactions - Retrieve a paginated list of trades/transactions for a specified Solana pool address including swaps, add liquidity, and remove liquidity events - Docs: https://docs.cambrian.org/api/v1/solana/pool-transactions/llms.txt #### Pool transactions time bounded - **Cambrian API** GET /api/v1/solana/pool-transactions-time-bounded - Get detailed transaction data for any SPL token across major Solana DEXs with precise Unix timestamp filtering for historical analysis and event-driven research. - Docs: https://docs.cambrian.org/api/v1/solana/pool-transactions-time-bounded/llms.txt #### Price current - **Cambrian API** GET /api/v1/solana/price-current - Retrieves the latest available USD price for a given Solana token program address - Docs: https://docs.cambrian.org/api/v1/solana/price-current/llms.txt #### Price hour - **Cambrian API** GET /api/v1/solana/price-hour - Aggregated USD price of a Solana token by program address, grouped by the specified interval (e.g., 1H, 1D, 1W, etc). Returns the average price for each interval. - Docs: https://docs.cambrian.org/api/v1/solana/price-hour/llms.txt #### Price multi - **Cambrian API** GET /api/v1/solana/price-multi - Retrieves the latest available USD prices for multiple Solana token program addresses (comma-separated) - Docs: https://docs.cambrian.org/api/v1/solana/price-multi/llms.txt #### Price unix - **Cambrian API** GET /api/v1/solana/price-unix - Retrieve historical price data for a specified Solana token at the nearest hour to a specific Unix timestamp. Returns the price, actual update time, and 24-hour price change. Essential for time-specific price analysis, backtesting, and historical data queries. - Docs: https://docs.cambrian.org/api/v1/solana/price-unix/llms.txt #### Token details - **Cambrian API** GET /api/v1/solana/token-details - Retrieves comprehensive details about a Solana token, including price history, trade statistics, holder information, and other key metrics - Docs: https://docs.cambrian.org/api/v1/solana/token-details/llms.txt #### Token details multi - **Cambrian API** GET /api/v1/solana/token-details-multi - Retrieve comprehensive details for multiple Solana tokens simultaneously. Returns the same data structure as the single token_details endpoint but for multiple tokens in a single API call. Maximum 50 tokens per request. - Docs: https://docs.cambrian.org/api/v1/solana/token-details-multi/llms.txt #### Token mint burn transactions - **Cambrian API** GET /api/v1/solana/token-mint-burn-transactions - Returns paginated list of mint and burn transactions for a specified Solana token, providing complete supply change audit trail with transaction details, amounts, and timing information. Essential for tracking token supply dynamics and compliance monitoring. - Docs: https://docs.cambrian.org/api/v1/solana/token-mint-burn-transactions/llms.txt #### Token pool search - **Cambrian API** GET /api/v1/solana/token-pool-search - Find pools containing a specific token and retrieve comprehensive trading statistics including 24h volume, trade counts, and buy/sell ratios. Essential for token analysis, liquidity discovery, and identifying the most active trading venues for any token. - Docs: https://docs.cambrian.org/api/v1/solana/token-pool-search/llms.txt #### Token transactions - **Cambrian API** GET /api/v1/solana/token-transactions - Retrieve a paginated list of trades/transactions for a specified Solana token address across all DEXes - Docs: https://docs.cambrian.org/api/v1/solana/token-transactions/llms.txt #### Token transactions time bounded - **Cambrian API** GET /api/v1/solana/token-transactions-time-bounded - Get detailed transaction data for any SPL token with precise Unix timestamp filtering for historical analysis and event-driven research. - Docs: https://docs.cambrian.org/api/v1/solana/token-transactions-time-bounded/llms.txt #### Trade statistics - **Cambrian API** GET /api/v1/solana/trade-statistics - Get instant trade analytics and performance metrics for any SPL tokens. View buy/sell volume breakdowns, trade counts, and USD values across customizable timeframes (1h to 30d). Perfect for portfolio tracking, performance dashboards, and quick market analysis. Query single tokens or multiple tokens at once using comma-separated addresses. Includes buy-to-sell ratios for comprehensive market insights. - Docs: https://docs.cambrian.org/api/v1/solana/trade-statistics/llms.txt #### Trending tokens - **Cambrian API** GET /api/v1/solana/trending-tokens - Retrieves a list of trending Solana tokens, ordered by price change in 24hs, trade volume in 24hs or current price. - Docs: https://docs.cambrian.org/api/v1/solana/trending-tokens/llms.txt #### Wallet balance history - **Cambrian API** GET /api/v1/solana/wallet-balance-history - Returns paginated list of balance changes for a specified wallet address, providing complete audit trail of portfolio changes with transaction details, pre/post balances, and timing information. Essential for portfolio tracking and compliance monitoring. - Docs: https://docs.cambrian.org/api/v1/solana/wallet-balance-history/llms.txt ### Evm #### Aero ##### V2 ###### Fee metrics - **Cambrian API** GET /api/v1/evm/aero/v2/fee-metrics - Shows daily historical data to understand the fees over time on a pool. - Docs: https://docs.cambrian.org/api/v1/evm/aero/v2/fee-metrics/llms.txt ###### Pool - **Cambrian API** GET /api/v1/evm/aero/v2/pool - Get information for a specific Aerodorme V2 pool address - Docs: https://docs.cambrian.org/api/v1/evm/aero/v2/pool/llms.txt ###### Pool volume - **Cambrian API** GET /api/v1/evm/aero/v2/pool-volume - Helpful for aggregate statistics over a particular timeframe, with hourly data to understand distribution of recent activity. - Docs: https://docs.cambrian.org/api/v1/evm/aero/v2/pool-volume/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/aero/v2/pools - This endpoint returns a paginated list of liquidity pools with summary metrics. - Docs: https://docs.cambrian.org/api/v1/evm/aero/v2/pools/llms.txt ###### Provider summary - **Cambrian API** GET /api/v1/evm/aero/v2/provider-summary - Provides a comprehensive overview of a liquidity provider's activity on a specific DEX and chain. Includes current summary statistics, portfolio diversity analysis (top pools, token exposure, concentration), position size distribution, historical performance metrics (fees, APR, IL over various periods), and a breakdown of fees and APR per pool. - Docs: https://docs.cambrian.org/api/v1/evm/aero/v2/provider-summary/llms.txt ##### V3 ###### Pool - **Cambrian API** GET /api/v1/evm/aero/v3/pool - Returns current pool TVL(Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps and Unique users for recent time range (5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year). - Docs: https://docs.cambrian.org/api/v1/evm/aero/v3/pool/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/aero/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps. - Docs: https://docs.cambrian.org/api/v1/evm/aero/v3/pools/llms.txt #### Alien ##### V3 ###### Pool - **Cambrian API** GET /api/v1/evm/alien/v3/pool - Returns current pool TVL (Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps and Unique users for recent time range (5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year). - Docs: https://docs.cambrian.org/api/v1/evm/alien/v3/pool/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/alien/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps. - Docs: https://docs.cambrian.org/api/v1/evm/alien/v3/pools/llms.txt #### Clones ##### V3 ###### Pool - **Cambrian API** GET /api/v1/evm/clones/v3/pool - Returns current pool TVL (Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps and Unique users for recent time range (5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year). - Docs: https://docs.cambrian.org/api/v1/evm/clones/v3/pool/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/clones/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps. - Docs: https://docs.cambrian.org/api/v1/evm/clones/v3/pools/llms.txt #### Pancake ##### V3 ###### Pool - **Cambrian API** GET /api/v1/evm/pancake/v3/pool - Returns current pool TVL (Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps and Unique users for recent time range (5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year). - Docs: https://docs.cambrian.org/api/v1/evm/pancake/v3/pool/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/pancake/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps. - Docs: https://docs.cambrian.org/api/v1/evm/pancake/v3/pools/llms.txt #### Sushi ##### V3 ###### Pool - **Cambrian API** GET /api/v1/evm/sushi/v3/pool - Returns current pool TVL (Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps and Unique users for recent time range (5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year). - Docs: https://docs.cambrian.org/api/v1/evm/sushi/v3/pool/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/sushi/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps. - Docs: https://docs.cambrian.org/api/v1/evm/sushi/v3/pools/llms.txt #### Tvl ##### Status - **Cambrian API** GET /api/v1/evm/tvl/status - Retuns the tokens hold by an address - Docs: https://docs.cambrian.org/api/v1/evm/tvl/status/llms.txt ##### Top owners - **Cambrian API** GET /api/v1/evm/tvl/top-owners - Returns top token holders for a given token address. - Docs: https://docs.cambrian.org/api/v1/evm/tvl/top-owners/llms.txt #### Uniswap ##### V3 ###### Pool - **Cambrian API** GET /api/v1/evm/uniswap/v3/pool - Returns current pool TVL (Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps and Unique users for recent time range (5 minutes, 1 hour, 1 day, 1 week, 1 month and 1 year). - Docs: https://docs.cambrian.org/api/v1/evm/uniswap/v3/pool/llms.txt ###### Pools - **Cambrian API** GET /api/v1/evm/uniswap/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps. - Docs: https://docs.cambrian.org/api/v1/evm/uniswap/v3/pools/llms.txt #### Dexes - **Cambrian API** GET /api/v1/evm/dexes - List of DEXes on EVM compatible chains - Docs: https://docs.cambrian.org/api/v1/evm/dexes/llms.txt #### Price current - **Cambrian API** GET /api/v1/evm/price-current - Returns current price of a token calculated based on uniswap v3 and clones liquidity pools. - Docs: https://docs.cambrian.org/api/v1/evm/price-current/llms.txt #### Price hour - **Cambrian API** GET /api/v1/evm/price-hour - Returns historical hourly price data for a specified EVM token. Limitations: Maximum 1000 hours of historical data, timestamps are in UTC format. Use /evm/tokens endpoint to get list of valid token addresses. - Docs: https://docs.cambrian.org/api/v1/evm/price-hour/llms.txt #### Tokens - **Cambrian API** GET /api/v1/evm/tokens - Returns a list of all whitelisted tokens for the specified EVM chain, including their contract addresses, symbols, names, and decimal places. - Docs: https://docs.cambrian.org/api/v1/evm/tokens/llms.txt ### Deep42 #### Social data ##### Alpha tweet detection - **Cambrian API** GET /api/v1/deep42/social-data/alpha-tweet-detection - Feed of tweets detected as having high alpha potential for cryptocurrency investments. Each tweet is scored across four dimensions: sentiment (bullish/bearish direction), alpha (investment insight quality), legitimacy (source reliability), and technical accuracy (correctness of crypto/DeFi claims). AI-generated reasoning explains each score. Version 2 (default) includes author track records with directional prediction accuracy measured at hourly price resolution - Docs: https://docs.cambrian.org/api/v1/deep42/social-data/alpha-tweet-detection/llms.txt ##### Influencer credibility - **Cambrian API** GET /api/v1/deep42/social-data/influencer-credibility - Returns cryptocurrency influencers ranked by credibility score, track record, accuracy, and engagement metrics. Analyzes high-quality tweets to identify the most reliable voices in crypto. Track record accuracy is measured using directional price predictions at hourly resolution: a bullish signal is correct if the token price increased, bearish if it decreased - Docs: https://docs.cambrian.org/api/v1/deep42/social-data/influencer-credibility/llms.txt ##### Sentiment shifts - **Cambrian API** GET /api/v1/deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes that could signal market movements and trading opportunities. Compares average AI-assigned sentiment scores (0-10 per tweet) between a current period and a previous period of equal length. Only includes tokens with sufficient tweet volume in both periods for statistical relevance - Docs: https://docs.cambrian.org/api/v1/deep42/social-data/sentiment-shifts/llms.txt ### Perp risk engine - **Cambrian API** GET /api/v1/perp-risk-engine - Calculates liquidation risk probability for leveraged cryptocurrency positions using Monte Carlo simulations with historical price data. Supports both long and short positions with configurable risk horizons (1h, 1d, 1w, 1mo). Lookback period and simulation parameters are automatically determined based on risk horizon. Returns detailed risk metrics including liquidation price, volatility analysis, and visualization data for the probability assessment. - Docs: https://docs.cambrian.org/api/v1/perp-risk-engine/llms.txt ## Key Resources - Full API documentation: https://docs.cambrian.org - OpenAPI specifications: https://docs.cambrian.org/specs - LLMs.txt (this file): https://docs.cambrian.org/llms.txt ## Contact For questions or support, visit: https://discord.com/channels/1375182661202481172/1376641098516271155