# Surf AI API Documentation

## Docs

- [Buy Recommendation](https://market-api-docs.asksurf.ai/ai-buy-recommendation.md): AI buy recommendation ranking for top 50 Bithumb tokens by market cap.
- [AI Recommended Assets](https://market-api-docs.asksurf.ai/ai-recommended-assets.md): Data-driven ranking + AI interpretation for top-200 Bithumb KRW market assets.
- [AI Recommended Prompts](https://market-api-docs.asksurf.ai/ai-recommended-prompts.md): Returns structured AI analysis for a given signal type in the Bithumb KRW market—useful for quickly understanding market conditions, flows, and narratives.
- [AI Report](https://market-api-docs.asksurf.ai/ai-report.md): Structured research report for crypto assets (snapshot, neutral, beginner-friendly). Returns top-200 Bithumb tokens by default.
- [Sell Recommendation](https://market-api-docs.asksurf.ai/ai-sell-recommendation.md): AI sell recommendation ranking for Bithumb tokens ranked 151–200 by market cap.
- [Today’s Falling Coin](https://market-api-docs.asksurf.ai/drop-tokens.md): Falling Coin news list for a given date (optional).
- [Major Events Tonight](https://market-api-docs.asksurf.ai/events.md): Major events list for a given date (optional).
- [AI-Highlighted News](https://market-api-docs.asksurf.ai/must-know-news.md): Must-know macro/market news list for a given date (optional).
- [Overview](https://market-api-docs.asksurf.ai/overview.md): Surf API - AI-powered crypto intelligence platform
- [Today’s Rising Coin](https://market-api-docs.asksurf.ai/rise-tokens.md): Rising coin news list for a given date (optional).
- [Market Sentiment](https://market-api-docs.asksurf.ai/sentiment.md): Market sentiment snapshot (date param reserved; currently ignored).
- [Token Metrics](https://market-api-docs.asksurf.ai/token-metrics.md): Returns one coalesced metric series for a symbol.
- [Key Trends](https://market-api-docs.asksurf.ai/trends.md): Key trends and analysis for a given date (optional).

## OpenAPI Specs

- [openapi](https://market-api-docs.asksurf.ai/openapi.json)