Skip to main content
GET
/
v1
/
market
/
ai-report
AI Report
curl --request GET \
  --url https://api.asksurf.ai/surf-ai/v1/market/ai-report \
  --header 'Authorization: <api-key>'
{
  "data": {
    "reports": [
      {
        "bithumb_rank": 123,
        "community": {
          "key_topics": [
            "<string>"
          ],
          "overall_sentiment": {
            "label": "<string>",
            "score": 123
          }
        },
        "conclusion": {
          "cautionary_factors": [
            "<string>"
          ],
          "overall_opinion": "<string>",
          "positive_factors": [
            "<string>"
          ]
        },
        "onchain": {
          "comprehensive_data": {
            "development_ecosystem": "<string>",
            "infrastructure_stability": "<string>",
            "market_valuation": "<string>",
            "network_health": "<string>"
          },
          "outlook": "<string>",
          "precautions": [
            "<string>"
          ],
          "sector_group": {
            "description": "<string>",
            "name": "<string>"
          },
          "simple_summary": "<string>"
        },
        "summary": {
          "summary": "<string>"
        },
        "technical": {
          "indicators": [
            {
              "analysis": "<string>",
              "indicator_status": "<string>",
              "name": "<string>"
            }
          ],
          "simple_summary": "<string>"
        },
        "ticker": "<string>",
        "title": {
          "title": "<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

The AI Report API generates structured research reports for crypto assets, combining real-time market snapshots, trend summaries, technical analysis, sector-optimized on-chain metrics, and community sentiment insights. Only tokens in the top 200 by market cap on Bithumb are included.

This report is a point-in-time snapshot and is intended for informational purposes only. It does not provide financial advice.

What you’ll get

  • Title: report headline
  • Summary: concise, beginner-friendly market read
  • Technical analysis: key chart / momentum interpretations + summary
  • On-chain analysis: sector-aware on-chain metrics (common/shared/sector-specific) + summary
  • Community: community sentiment signals
  • Conclusion: neutral wrap-up (bullish & bearish factors)

How to use

1

Call without ticker (default)

Omit ticker to receive reports for all top-200 tokens by market cap. The response is a list with ticker and bithumb_rank per item.
2

Or pick a single ticker

Provide ticker (e.g. BTC) to receive a single report. The ticker must be in the top 200 by market cap; otherwise a 404 is returned.
3

Optional: backfill by date

Provide date (YYYY-MM-DD). If omitted, the latest snapshot is returned.

Response format

Without ticker: returns reports: [ ticker, bithumb_rank, title, summary, … ]

With ticker: returns a single report object directly (backward compatible).

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

ticker
string

Ticker (optional). If omitted, returns reports for all top-200 tokens by market cap

Response

Returns AI reports on success (all top-200)

data
object
error_code
string
Example:

"FORBIDDEN"

message
string
Example:

"success"

success
boolean
Example:

true