Skip to main content
GET
/
v1
/
market
/
events
Major Events Tonight
curl --request GET \
  --url https://api.asksurf.ai/surf-ai/v1/market/events \
  --header 'Authorization: <api-key>'
{
  "data": {
    "datetime": "<string>",
    "major_events": [
      {
        "datetime": "<string>",
        "event_name": "<string>"
      }
    ],
    "publish_time": "<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 Major Events Tonight API returns a list of upcoming events that may impact the crypto market.

This endpoint returns a point-in-time snapshot. If date is omitted, the most recent snapshot is returned.

​
How to use

1

Optional: choose a date

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

Schedule alerts

Use the events list to schedule reminders/alerts and to annotate dashboards with “tonight’s key events”.
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

Response

Returns major events on success

​
data
object
​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true