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,
        "id": "<string>",
        "image_url": "<string>",
        "interpretation": {
          "market_sentiment": "<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_stability": 123,
          "search_trend": 123,
          "trading_activity": 123,
          "upside_energy": 123
        },
        "score_by_category": {
          "market_sentiment": 123,
          "price_stability": 123,
          "search_trend": 123,
          "trading_activity": 123,
          "upside_energy": 123
        },
        "summary": "<string>",
        "symbol": "<string>",
        "total_score": 123
      }
    ],
    "generated_at": "<string>"
  },
  "error_code": "FORBIDDEN",
  "message": "success",
  "success": true
}

​
Overview

The AI Asset Recommendation API delivers ranked insights for crypto assets listed in the Bithumb KRW market. It combines 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.

​
Response modes (type)

  • score_ranking: asset info + total_score, score_by_category, overall_rank, and ranking_by_category.
  • summary: asset info + summary (AI-generated one-liner).
  • comprehensive_evaluation: asset info + total_score, score_by_category, overall_rank, opinion, and interpretation.
  • sentiment_trend: asset info + bullish and bearish (numeric sentiment distribution).

Each asset item always includes id and asset fields: symbol, name, image_url.

​
Scoring model

Total Score is derived from five categories (each 0-10):

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

The response includes score_by_category and, for comprehensive evaluations, interpretation labels per category.

​
How to use

1

Provide tickers

Pass tickers as a comma-separated list (required). Example: BTC,ETH,SOL.
2

Choose a response type

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

Optional: request a historical snapshot

Provide date (YYYY-MM-DD). The backend treats it as KST 00:00 for that day and returns the most recent data if omitted.
4

Read the snapshot

The response includes generated_at (KST) and an assets list for the tickers that exist in the backend dataset.
Unknown tickers are omitted. If certain data is unavailable or not applicable, 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
required

Tickers (comma separated, required. support BTC,ETH,SOL. e.g BTC,ETH)

Response

Returns AI recommended assets on success

​
data
object
​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true