Skip to main content
GET
/
v1
/
market
/
ai-recommended-assets
AI Recommended Assets
curl --request GET \
  --url https://api.asksurf.ai/surf-ai/v1/market/ai-recommended-assets \
  --header 'Authorization: <api-key>'
{
  "data": {
    "assets": [
      {
        "bearish": 123,
        "bullish": 123,
        "uid": "<string>",
        "image_url": "<string>",
        "interpretation": {
          "market_sentiment": "<string>",
          "price_resilience": "<string>",
          "price_stability": "<string>",
          "search_trend": "<string>",
          "trading_activity": "<string>",
          "upside_energy": "<string>"
        },
        "name": "<string>",
        "opinion": "<string>",
        "overall_rank": 123,
        "ranking_by_category": {
          "market_sentiment": 123,
          "price_resilience": 123,
          "price_stability": 123,
          "search_trend": 123,
          "trading_activity": 123,
          "upside_energy": 123
        },
        "score_by_category": {
          "market_sentiment": 123,
          "price_resilience": 123,
          "price_stability": 123,
          "search_trend": 123,
          "trading_activity": 123,
          "upside_energy": 123
        },
        "summary": "<string>",
        "symbol": "<string>",
        "title": "<string>",
        "total_score": 123,
        "sentiment_label": "<string>"
      }
    ],
    "generated_at": "<string>"
  },
  "error_code": "FORBIDDEN",
  "message": "success",
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://market-api-docs.asksurf.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The AI Asset Recommendation API delivers ranked insights for crypto assets listed in the Bithumb KRW market. It returns the top 200 tokens by market cap by default, combining multi-dimensional scoring with AI-generated interpretation. The response shape depends on the type you request.

This endpoint returns a point-in-time snapshot. If date is omitted, the most recent snapshot is returned.

​
Variants

Two additional endpoints return subsets of the same data:

  • /v1/market/ai-buy-recommendation — buy recommendation (rank 1–50, score ≥ 6.0, highest first)
  • /v1/market/ai-sell-recommendation — sell recommendation (rank 151–200, score < 6.0, lowest first)

​
Response modes (type)

  • score_ranking: asset info + total_score, score_by_category, overall_rank, ranking_by_category, opinion, and interpretation.
  • summary: asset info + total_score, score_by_category, title (concise Korean label, max 20 characters), and summary (detailed multi-line markdown analysis interpreting scores).
  • comprehensive_evaluation: asset info + total_score, score_by_category, overall_rank, opinion, and interpretation.
  • sentiment_trend: asset info + bullish, bearish (integer percentages, 0–100, sum = 100), and sentiment_label (Korean label derived from bullish ratio).

​
Scoring model

Total Score is provided together with six category scores (each 0-10):

  • Upside Energy
  • Trading Activity
  • Search Trend
  • Price Stability
  • Market Sentiment
  • Price Resilience

​
How to use

1

Call without tickers (default)

Omit tickers to receive data for all top-200 tokens sorted by score.
2

Or filter by specific tickers

Pass tickers as a comma-separated list (e.g. BTC,ETH,SOL). Only tokens within the market cap range of this endpoint are returned.
3

Choose a response type

Set type (required) to one of: score_ranking, summary, comprehensive_evaluation, sentiment_trend.
4

Optional: request a historical snapshot

Provide date (YYYY-MM-DD). The backend treats it as KST 00:00 for that day.
Unknown or out-of-range tickers are omitted. If certain data is unavailable, corresponding fields may be null or omitted.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
date
string

Date in YYYY-MM-DD format. Returns scores at KST 00:00 of the specified date. If not provided, returns the most recent data

​
type
enum<string>
required

Prompt type (template key)

Available options:
score_ranking,
summary,
comprehensive_evaluation,
sentiment_trend
​
tickers
string

Tickers (comma separated, optional. e.g BTC,ETH). If omitted, returns all top-200 tokens by market cap

Response

Returns AI recommended assets on success

​
data
object
​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true