Skip to main content
GET
/
v1
/
market
/
ai-recommended-assets
AI Recommended Assets (Mock)
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>",
        "neutral": 123,
        "opinion": "<string>",
        "overall_rank": 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 provides a data-driven ranking and evaluation of crypto assets listed in the Bithumb KRW market. It combines market data with multi-dimensional scoring and AI-generated interpretation.

This endpoint is labeled Mock in the spec. Treat outputs as informational snapshots.

​
Two core components

  • Recommendation List: ranked assets based on a composite Total Score (0–10), computed as the rounded average of five category scores.
  • Recommendation Details: in-depth evaluation for each asset, including score interpretation, category breakdown, price context, and social sentiment distribution.

​
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 both score_by_category and score_interpretation.

​
How to use

1

Provide asset candidates

Send an array of assets with ticker and current price (required per item). You may include change_rate when available.
2

Optional: attach timestamp

Include timestamp to annotate the snapshot timing (if your pipeline tracks it).
3

Read ranking + evaluation

Use ranking.overall_rank and score.total to sort, then display ai_evaluation.summary / ai_evaluation.opinion for the narrative layer.
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. If date is 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