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>'
{
  "data": {
    "content": "<string>"
  },
  "error_code": "FORBIDDEN",
  "message": "success",
  "success": true
}

​
Overview

The AI Recommended Prompts API generates context-aware analytical questions and structured responses for the Bithumb KRW crypto market. It helps users quickly understand market conditions, asset movements, capital flows, and emerging narratives.

Prompts include both fixed core questions and dynamically selected questions from a pool that may change over time.

​
Prompt categories

  • Market sentiment: overall mood & breadth
  • Momentum: strongest movers and why
  • Trending issues: what the market is talking about
  • Directional picks: go_up / go_down (may require ticker)
  • Narratives: KOL discussions / sector rotations

​
How to use

1

Choose a type

Set type (required) as the prompt template key. 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.
3

Optional: provide ticker (only for some types)

When type is go_up or go_down, you should pass ticker.
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 date is not provided, returns the most recent data

​
type
enum<string>
required

Prompt type (template key)

Available options:
krw_market_sentiment,
strongest_momentum,
trending_issues,
go_up,
go_down,
kols_discuss,
kols_sectors
​
ticker
enum<string>

Ticker (required when type is go_up or go_down)

Available options:
BTC,
ETH,
MON

Response

Returns AI recommended prompt on success

​
data
object
​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true