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
}

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.

Supported type values are defined in the OpenAPI enum and may expand over time. Clients should handle unknown values gracefully.

Available types

Below are the suggested questions for each type:

  • market_sentiment
    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

Ticker when needed

When type is asset_price_surge or asset_price_decline, provide ticker (required for that type).
3

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_sentiment
ticker
string

Ticker (required when type is asset_price_surge or asset_price_decline)

sector
string

Sector (required when type is undervalued_asset)

Response

Returns AI recommended prompt on success

error_code
string
Example:

"FORBIDDEN"

message
string
Example:

"success"

success
boolean
Example:

true