## Use Cases

### Natural Language Price Lookup

When user asks "what's the price of bitcoin" or "how much is ETH":

1. Use `/agent/resolve` for natural language → canonical asset
2. Use `/crypto/price/{symbol}` or `/stocks/{symbol}/quote` for price
3. Return formatted response

### Token Security Check

When user asks "is this token safe" or "check 0x1234...":

1. Use `/analyze/{symbol}` for general analysis
2. Use `/analyze/copycat/{symbol}` for scam detection
3. Use `/analytics/holders/{contract}` for whale concentration
4. Return risk assessment

### Market Overview

When user asks "how's the market" or "what's trending":

1. Use `/market/overview` for full picture
2. Use `/market/fear-greed` for sentiment
3. Use `/crypto/trending` for hot coins
4. Use `/stocks/gainers` + `/losers` for stock movers

### Cross-Market Correlation

When user asks "what correlates with bitcoin":

1. Use `/market/overview` for cross-market data
2. Compare crypto vs stocks/commodities/forex
3. PRISM's 120+ endpoints enable true cross-market analysis

## Endpoint Speed Reference

| Endpoint | Speed | Use Case |
|----------|-------|----------|
| `/resolve/{symbol}` | 140-200ms | Symbol resolution |
| `/crypto/price/{symbol}` | 1.9-2.1s | Single price |
| `/market/fear-greed` | 229ms | Sentiment |
| `/crypto/trending` | 242ms | Hot coins |
| `/analyze/copycat/{symbol}` | 160ms | Scam detection |
| `/stocks/{symbol}/quote` | 214ms | Stock price |
| `/agent/resolve` | 3.4s | NL queries |

## Unique Data (Nobody Else Has)

- `/crypto/trending/solana/bonding` — Pump.fun launches
- `/analyze/copycat` — Scam/copycat detection
- `/analyze/rebrand` — Token migrations (MATIC→POL)
- `/dex/{symbol}/funding/all` — Cross-venue funding rates

## Example Responses

### Price Lookup

# Resolve symbol (handles BTC, BTCUSD, XBT, bitcoin, etc.)
curl "$PRISM_URL/resolve/BTC"
curl "$PRISM_URL/resolve/BTCUSDT"
curl "$PRISM_URL/resolve/bitcoin"

# Natural language resolution (for agents)
curl -X POST "$PRISM_URL/agent/resolve" \
  -H "Content-Type: application/json" \
  -d '{"query": "price of ethereum"}'

# Batch resolve
curl -X POST "$PRISM_URL/resolve/batch" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["BTC", "ETH", "AAPL", "GOLD"]}'

# Find trading venues for asset
curl "$PRISM_URL/resolve/venues/BTC"

# Crypto price
curl "$PRISM_URL/crypto/price/BTC"
curl "$PRISM_URL/crypto/price/ETH"

# Batch crypto prices
curl -X POST "$PRISM_URL/batch/crypto/prices" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["BTC", "ETH", "SOL"]}'

# Stock quote
curl "$PRISM_URL/stocks/AAPL/quote"

# Batch stock quotes
curl -X POST "$PRISM_URL/stocks/batch/quotes" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["AAPL", "MSFT", "GOOGL"]}'

# Full market overview (crypto + tradfi)
curl "$PRISM_URL/market/overview"

# Crypto global stats
curl "$PRISM_URL/crypto/global"

# Fear & Greed Index
curl "$PRISM_URL/market/fear-greed"

# Trending crypto
curl "$PRISM_URL/crypto/trending"

# Stock movers
curl "$PRISM_URL/stocks/gainers"
curl "$PRISM_URL/stocks/losers"
curl "$PRISM_URL/stocks/active"

# Analyze token for risks
curl "$PRISM_URL/analyze/BTC"

# Copycat/scam detection
curl "$PRISM_URL/analyze/copycat/PEPE"

# Check for rebrands (MATIC → POL)
curl "$PRISM_URL/analyze/rebrand/MATIC"

# Fork detection
curl "$PRISM_URL/analyze/fork/ETH"

# Holder analytics (whale concentration)
curl "$PRISM_URL/analytics/holders/0x1234..."

# Trending crypto overall
curl "$PRISM_URL/crypto/trending"

# Solana Pump.fun bonding tokens (UNIQUE!)
curl "$PRISM_URL/crypto/trending/solana/bonding"

# Graduated from bonding curve
curl "$PRISM_URL/crypto/trending/solana/graduated"

# Trending DEX pools
curl "$PRISM_URL/crypto/trending/pools"

# EVM trending
curl "$PRISM_URL/crypto/trending/evm"

# Multi-day stock movers
curl "$PRISM_URL/stocks/multi-day-movers"

# DEX pairs
curl "$PRISM_URL/dex/pairs"

# Hyperliquid perps
curl "$PRISM_URL/dex/hyperliquid/pairs"
curl "$PRISM_URL/dex/hyperliquid/BTC/funding"
curl "$PRISM_URL/dex/hyperliquid/BTC/oi"

# Cross-venue funding rates
curl "$PRISM_URL/dex/BTC/funding/all"

# Cross-venue open interest
curl "$PRISM_URL/dex/BTC/oi/all"

# Wallet balances (multi-chain)
curl "$PRISM_URL/wallets/0xYourAddress/balances"

# Native balance only
curl "$PRISM_URL/wallets/0xYourAddress/native"

# Supported chains
curl "$PRISM_URL/chains"

# On-chain price
curl "$PRISM_URL/analytics/price/onchain/0xContractAddress"

# Forex rates
curl "$PRISM_URL/forex"
curl "$PRISM_URL/forex/USD/tradeable"

# Commodities
curl "$PRISM_URL/commodities"
curl "$PRISM_URL/commodities/GOLD/tradeable"

# ETFs
curl "$PRISM_URL/etfs/popular"

# Indexes
curl "$PRISM_URL/indexes"
curl "$PRISM_URL/indexes/sp500"
curl "$PRISM_URL/indexes/nasdaq100"

# Sectors
curl "$PRISM_URL/sectors"

# API health
curl "$PRISM_URL/health"

# Data source status
curl "$PRISM_URL/crypto/sources/status"

# Registry health
curl "$PRISM_URL/registry/health"