Skip to main content
GET
/
v1
/
market
/
ai-buy-recommendation
Buy Recommendation Ranking
curl --request GET \
  --url https://api.asksurf.ai/surf-ai/v1/market/ai-buy-recommendation \
  --header 'Authorization: <api-key>'
{
  "data": {
    "assets": [
      {
        "uid": "<string>",
        "image_url": "<string>",
        "name": "<string>",
        "rank": 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
      }
    ],
    "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

Returns AI-driven buy recommendations for tokens in the top 50 by market cap on Bithumb with overall score ≥ 6.0, ranked by score (highest first). Each item includes asset info, rank, overall score, 6 category scores, a Korean title (max 20 characters), and a detailed analytical summary.

Overall score = Round(Average(6 individual metric scores), 1).

Parameters

Only date (optional, YYYY-MM-DD). If omitted, returns the most recent data.

Authorizations

Authorization
string
header
required

Query Parameters

date
string

Date in YYYY-MM-DD format. If omitted, returns the most recent data

Response

Returns buy recommendations on success

data
object
error_code
string
Example:

"FORBIDDEN"

message
string
Example:

"success"

success
boolean
Example:

true