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

​
Overview

The AI Report API generates a structured research report for a given crypto asset, combining real-time market snapshots, trend summaries, technical analysis, sector-optimized on-chain metrics, and community sentiment insights.

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

  • Realtime info: current snapshot & context for the asset
  • Summary: concise, beginner-friendly market read
  • Technical analysis: key chart / momentum interpretations
  • On-chain analysis: sector-aware on-chain metrics (common/shared/sector-specific)
  • Social data: community sentiment signals
  • Conclusion: neutral wrap-up (bullish & bearish factors)

​
How to use

1

Pick a ticker

Provide ticker (required). Example: BTC, ETH.
2

Select a report section

Use type to request a specific section (e.g. summary, technical_analysis).
3

Optional: backfill by date

Provide date (YYYY-MM-DD). If omitted, the latest snapshot is returned.
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

​
type
enum<string>
required

Report type (template key)

Available options:
realtime_info,
summary,
technical_analysis,
onchain_analysis,
social_data,
conclusion
​
ticker
enum<string>
required

Ticker (required)

Available options:
BTC,
ETH,
MON

Response

Returns AI report on success

​
data
object
​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true