Phi Protocol

Phi Protocol API

Al native liquidity layer for Hyperliquid, Solana & more chains. Instantly deploy Al-powered onchain agents
that aggregate & route liquidity via our powerful API, specially made for the cracked developers who love to build awesome applications.

Bridge Quote API Market Data API Advanced Market Data DeFi Intelligence Real-time Analysis

Introduction to Phi

Welcome to the Phi API documentation. Phi is a comprehensive DeFi API suite that developers can integrate into their applications. Our API provides professional-grade Bridge Quotes, Market Data, Advanced Market Analytics, and DeFi Intelligence with institutional-quality analytics and real-time data feeds.

Bridge Quote API

Cross-chain bridge quotes with Wormhole and deBridge integration

Market Data API

Real-time prices, charts, and multi-chain portfolio tracking

Advanced Market Data API

Advanced analytics, liquidity analysis, arbitrage opportunities, and volatility metrics

DeFi Intelligence API

Comprehensive market analysis, risk assessment, and DeFi metrics

Base URL: https://api-live.phiprotocol.ai

Getting Started

Quick Start

Get started with the Phi API in just a few steps. All endpoints are RESTful and return JSON responses.

1. Base URL

https://api-live.phiprotocol.ai

2. Make your first request

fetch('https://api-live.phiprotocol.ai/api/defi-intelligence/analysis', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    messages: [
      {
        role: 'user',
        content: 'Hello, what can you help me with?'
      }
    ],
    model: 'OpenAI',
    modelName: 'GPT-4',
    userId: 'your-user-id',
    chatId: 'your-chat-id',
    plan: 'Startups'
  })
})
.then(response => response.json())
.then(data => console.log(data));

Rate Limiting: Chat API endpoints are rate limited. Please refer to the response headers for current limits.

Authentication

The Phi API uses API key authentication with a credit-based system. All endpoints require a valid API key and deduct credits based on the complexity of the request.

API Key Required

Every API request must include your API key in the X-API-Key header. Generate your API key from the user panel after purchasing a plan. 

fetch('https://api-live.phiprotocol.ai/api/bridge/quote/wormhole', {
  headers: {
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json'
  }
});

Credit System

Each API call consumes credits based on complexity:

  • Bridge Quote: 1 credit
  • Market Data: 1 credit
  • Advanced Market Data: 2 credits
  • DeFi Intelligence: 5 credits

Rate Limits

Request limits per minute by plan:

  • Free: 20 requests/min
  • Build: 60 requests/min
  • Accelerate: 150 requests/min
  • Business: 300 requests/min

API Key Format

All API keys follow the format: phi_live_[timestamp][random]

Keep your API keys secure and never share them publicly. If compromised, generate a new key immediately from the user panel.

Phi Tokenomics

Phi Protocol

Community-First Token Distribution

100% Supply: Community Fair Launch

No team allocation, no VC rounds, no private sales.

API Explorer

Try out the API directly from this documentation. Select an endpoint below to test it interactively.

API Endpoints

Bridge Quote API

GET /bridge/quote/wormhole

Get Wormhole bridge quote

Get cross-chain bridge quotes using Wormhole protocol.

Required Parameters:
  • amount - Amount to bridge (in wei/lamports)
  • fromChain - Source chain (solana, ethereum, bsc, polygon, avalanche)
  • toChain - Destination chain
  • token - Token to bridge (optional, default: native)
GET /api/bridge/quote/wormhole?amount=1000000&fromChain=solana&toChain=ethereum&token=native

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /bridge/quote/debridge

Get deBridge quote

Get optimized bridge quotes using deBridge protocol.

Required Parameters:
  • amount - Amount to bridge
  • fromChain - Source chain ID or name
  • toChain - Destination chain
  • fromToken - Source token address
  • toToken - Destination token address
GET /bridge/chains

Get supported chains

List all supported blockchain networks for bridging.

Market Data API

GET /market-data/prices

Get token prices

Get real-time prices for supported tokens with 24h change data.

Parameters:
  • tokens - Comma-separated token list (ethereum,solana,binancecoin)
  • currency - Price currency (default: usd)
GET /api/market-data/prices?tokens=ethereum,solana¤cy=usd

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /market-data/chart

Get price chart data

Get historical price data with customizable time periods.

Parameters:
  • token - Token symbol or ID
  • days - Time period (1, 7, 30, 90, 365)
  • interval - Data interval (hourly, daily)
GET /market-data/portfolio

Get portfolio data

Get multi-chain portfolio analysis for any wallet address.

Parameters:
  • address - Wallet address to analyze
  • chains - Chains to include (default: ethereum,bsc,polygon,avalanche,solana)
GET /api/market-data/portfolio?address=0x1234...&chains=ethereum,bsc

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /market-data/tokens

Get supported tokens

List all supported tokens with their metadata and current availability.

GET /api/market-data/tokens

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /market-data/trending

Get trending tokens

Get currently trending tokens with volume and price change data.

Optional Parameters:
  • limit - Number of tokens to return (default: 10, max: 50)
  • timeframe - Trending timeframe (1h, 24h, 7d)
GET /api/market-data/trending?limit=20&timeframe=24h

Headers:
X-API-Key: phi_live_1234567890abcdef

Advanced Market Data API

GET /advanced-market-data/liquidity

Get comprehensive liquidity analysis

Analyze liquidity depth across multiple chains and exchanges with detailed market impact calculations.

Required Parameters:
  • token - Token symbol or ID (ETH, SOL, BNB, etc.)
Optional Parameters:
  • chains - Comma-separated chains (default: ethereum,bsc,polygon,avalanche,solana)
  • depth_levels - Liquidity depth levels in millions USD (default: 1,5,10)
GET /api/advanced-market-data/liquidity?token=ethereum&chains=ethereum,solana

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /advanced-market-data/arbitrage

Get arbitrage opportunities

Find profitable arbitrage opportunities across exchanges with real-time pricing data.

Required Parameters:
  • token - Token symbol or ID
Optional Parameters:
  • min_profit - Minimum profit percentage (default: 0.5)
  • exchanges - Specific exchanges to analyze (default: all)
GET /advanced-market-data/volatility

Get advanced volatility analysis

Comprehensive volatility metrics including realized, implied, and historical volatility data.

Required Parameters:
  • token - Token symbol or ID
Optional Parameters:
  • timeframe - Analysis timeframe (1h, 4h, 24h, 7d, 30d)
  • type - Volatility type (realized, implied, historical)
GET /advanced-market-data/yield-opportunities

Get DeFi yield opportunities

Discover profitable DeFi yield farming and staking opportunities across multiple protocols and chains with comprehensive risk assessment.

Optional Parameters:
  • token - Token symbol (returns all tokens if not specified)
  • chains - Comma-separated chains (default: ethereum,bsc,polygon,avalanche,solana)
  • min_apy - Minimum APY percentage (default: 1)
  • risk_level - Risk level filter: low, medium, high, all (default: all)
GET /api/advanced-market-data/yield-opportunities?token=ethereum&min_apy=5&risk_level=medium

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /advanced-market-data/correlations

Get token correlation analysis

Analyze price correlations between tokens to optimize portfolio diversification and identify risk concentrations.

Required Parameters:
  • base_token - Base token for correlation analysis
Optional Parameters:
  • compare_tokens - Comma-separated tokens to compare (default: ethereum,solana,binancecoin)
  • timeframe - Analysis timeframe: 1d, 7d, 30d, 90d (default: 30d)
GET /api/advanced-market-data/correlations?base_token=ethereum&compare_tokens=solana,binancecoin&timeframe=30d

Headers:
X-API-Key: phi_live_1234567890abcdef
GET /advanced-market-data/fear-greed

Get Fear & Greed Index

Access comprehensive Fear & Greed Index data with component breakdown and historical analysis for market sentiment tracking.

Optional Parameters:
  • timeframe - Historical timeframe: 1d, 7d, 30d (default: 1d)
  • include_breakdown - Include component breakdown (default: true)
GET /api/advanced-market-data/fear-greed?timeframe=7d&include_breakdown=true

Headers:
X-API-Key: phi_live_1234567890abcdef

DeFi Intelligence API

GET /defi-intelligence/analysis

Get comprehensive market analysis

Get institutional-grade market analysis with technical, on-chain, and sentiment data.

Parameters:
  • token - Token symbol (ETH, SOL, BNB, HYPE)
  • include_technical - Include technical analysis (default: true)
  • include_onchain - Include on-chain metrics (default: true)
  • include_defi - Include DeFi ecosystem data (default: true)
GET /api/defi-intelligence/analysis?token=ethereum&include_technical=true

Headers:
X-API-Key: phi_live_1234567890abcdef
Note: This endpoint costs 5 credits per request
GET /defi-intelligence/risk

Get risk assessment

Get professional risk scoring and portfolio recommendations.

GET /defi-intelligence/metrics

Get DeFi ecosystem metrics

Get TVL, yield opportunities, and protocol analytics.

GET /defi-intelligence/derivatives

Get derivatives intelligence

Get funding rates, open interest, and options market data.

Parameters:
  • token - Token symbol (ETH, SOL, BNB, HYPE)
GET /api/defi-intelligence/derivatives?token=ethereum

Headers:
X-API-Key: phi_live_1234567890abcdef
Note: This endpoint costs 5 credits per request
GET /defi-intelligence/sentiment

Get market sentiment analysis

Get comprehensive market sentiment analysis including social media metrics, news sentiment, and community indicators.

Parameters:
  • token - Token symbol (optional, returns overall market sentiment if not provided)
Response includes:
  • Overall Sentiment Score: Bullish/Bearish with confidence percentage
  • Social Media Metrics: Twitter mentions, Reddit posts, Discord activity
  • News Sentiment: Positive/Neutral/Negative news analysis
  • Fear & Greed Index: Market psychology indicators
  • Influencer Sentiment: Key opinion leaders' sentiment
  • Community Metrics: Developer activity, partnership news
GET /api/defi-intelligence/sentiment?token=ethereum

Headers:
X-API-Key: phi_live_1234567890abcdef
Note: This endpoint costs 5 credits per request

# Example Response:
{
  "success": true,
  "data": {
    "overall_sentiment": "Bullish",
    "sentiment_score": 72,
    "social_metrics": {
      "twitter_mentions": "45K (24h)",
      "reddit_posts": "1.2K (24h)",
      "telegram_activity": "High"
    },
    "news_sentiment": {
      "positive": "68%",
      "neutral": "22%",
      "negative": "10%"
    },
    "market_indicators": {
      "fear_greed_index": 72,
      "volatility_sentiment": "Moderate concern"
    }
  }
}

Code Examples

Practical examples to get you started with the Phi API quickly. These examples show real-world usage patterns.

JavaScript Integration

Complete examples for web applications

View Examples

Python Integration

Server-side examples and automation

View Examples 
// Quick Start Example - Bridge Quote (1 credit)
const response = await fetch('https://api-live.phiprotocol.ai/api/bridge/quote/wormhole?amount=1000000&fromChain=solana&toChain=ethereum', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const data = await response.json();
console.log('Bridge Quote:', data);

// Advanced Market Data Example (2 credits)
const liquidityResponse = await fetch('https://api-live.phiprotocol.ai/api/advanced-market-data/liquidity?token=ethereum', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const liquidityData = await liquidityResponse.json();
console.log('Liquidity Analysis:', liquidityData);

// Arbitrage Opportunities Example (2 credits)
const arbitrageResponse = await fetch('https://api-live.phiprotocol.ai/api/advanced-market-data/arbitrage?token=ethereum&min_profit=0.5', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const arbitrageData = await arbitrageResponse.json();
console.log('Arbitrage Opportunities:', arbitrageData);

// Volatility Analysis Example (2 credits)
const volatilityResponse = await fetch('https://api-live.phiprotocol.ai/api/advanced-market-data/volatility?token=ethereum&timeframe=24h&type=realized', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const volatilityData = await volatilityResponse.json();
console.log('Volatility Analysis:', volatilityData);

// Yield Opportunities Example (2 credits)
const yieldResponse = await fetch('https://api-live.phiprotocol.ai/api/advanced-market-data/yield-opportunities?token=ethereum&min_apy=5&risk_level=medium', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const yieldData = await yieldResponse.json();
console.log('DeFi Yield Opportunities:', yieldData);

// Token Correlations Example (2 credits)
const correlationResponse = await fetch('https://api-live.phiprotocol.ai/api/advanced-market-data/correlations?base_token=ethereum&compare_tokens=solana,binancecoin&timeframe=30d', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const correlationData = await correlationResponse.json();
console.log('Token Correlations:', correlationData);

// Fear & Greed Index Example (2 credits)
const fearGreedResponse = await fetch('https://api-live.phiprotocol.ai/api/advanced-market-data/fear-greed?timeframe=7d&include_breakdown=true', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const fearGreedData = await fearGreedResponse.json();
console.log('Fear & Greed Index:', fearGreedData);

// DeFi Intelligence Example (5 credits)
const analysisResponse = await fetch('https://api-live.phiprotocol.ai/api/defi-intelligence/analysis?token=ethereum', {
  headers: { 
    'X-API-Key': 'phi_live_1234567890abcdef',
    'Content-Type': 'application/json' 
  }
});

const analysis = await analysisResponse.json();
console.log('Market Analysis:', analysis);

SDKs & Libraries

Official SDKs and community libraries to accelerate your development with the Phi API.

JavaScript SDK

Official SDK for web and Node.js

Coming Soon

Python SDK

Full-featured Python library

Coming Soon

REST API

Direct HTTP requests

Available Now

Community Contributions

We welcome community contributions! If you've built a library or SDK for the Phi API, let us know and we'll feature it here.