Skip to main content
GET
/
v1
/
market
/
ai-recommended-prompts
AI Recommended Prompts
curl --request GET \
  --url https://api.asksurf.ai/surf-ai/v1/market/ai-recommended-prompts \
  --header 'Authorization: <api-key>'
{
  "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 Recommended Prompts API returns structured AI analysis for the Bithumb KRW crypto market for a given type (signal type). Use it to quickly understand market conditions, asset movements, capital flows, and emerging narratives.

​
Available types

Below are the suggested questions for each type:

  • market_rise_fall_reason
    English: Why is the market rising or falling?
    Korean: 현재 시장의 상승/하락 이유는?
  • bullish_assets
    English: Which assets are on the rise?
    Korean: 상승추세를 보이는 자산은?
  • trending_issues
    English: What are the trending issues in the crypto market?
    Korean: 지금 시장에서 주목받는 이슈는?
  • asset_price_surge
    English: Why did the price of {Asset Name} go up?
    Korean: {가상자산명} 상승 이유는?
  • asset_price_decline
    English: Why did the price of {Asset Name} go down?
    Korean: {가상자산명} 하락 이유는?
  • kol_themes
    English: What themes are KOLs discussing recently?
    Korean: 최근 KOL들의 주요 관심 주제는?
  • kol_sectors
    English: Which sectors are KOLs paying attention to?
    Korean: 최근 KOL들이 주목하는 섹터는?
  • positive_news_top5
    English: What are the top 5 assets with positive news sentiment?
    Korean: 뉴스 긍정 Top5 자산은?
  • hottest_meme_coins
    English: What is the hottest meme coin today?
    Korean: 오늘 가장 핫한 ‘밈코인’ 은?
  • exchange_outflows
    English: Which assets are experiencing large exchange outflows?
    Korean: 거래소 대량 출금 자산은?
  • stablecoin_inflows
    English: What are the stablecoin inflow trends?
    Korean: 스테이블코인 유입량은?
  • sector_leaders
    English: What are the leading assets by sector today?
    Korean: 오늘 섹터별 대장 종목은?
  • btc_etf_flow
    English: What are the latest Bitcoin ETF inflows and outflows?
    Korean: 비트코인 ETF 유출입 현황은?
  • golden_cross
    English: Which assets are approaching a golden cross?
    Korean: 골든크로스 임박 자산은?
  • sentiment_divergence
    English: Which assets show sentiment divergence?
    Korean: 심리 괴리 현상이 나타나는 자산은?
  • top_active_chain
    English: Which blockchain has the highest active users?
    Korean: 활성 사용자 1위 체인은?
  • undervalued_asset
    English: Which asset appears undervalued in the {sector}?
    Korean: {sector}에서 저평가된 자산은?

​
How to use

1

Choose a type

Set type (required) as the signal type. Different types produce different structured outputs.
2

Optional: choose a date

Provide date (YYYY-MM-DD) to view historical context. Default is the latest available snapshot.
Outputs are for informational purposes only and should not be interpreted as financial advice.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
date
string

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

​
type
enum<string>
required

Signal type

Available options:
undervalued_asset,
sector_leaders,
bullish_assets,
stablecoin_inflows,
asset_price_surge,
kol_sectors,
asset_price_decline,
positive_news_top5,
sentiment_divergence,
kol_themes,
trending_issues,
golden_cross,
exchange_outflows,
top_active_chain,
hottest_meme_coins,
btc_etf_flow,
market_rise_fall_reason

Response

Returns AI recommended prompt on success

​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true