AIXBT Docs

Get Market Grounding

GET
/v2/grounding

Returns the current market grounding snapshot. Each section contains four bullet points summarizing the current state. Current sections are crypto and tradfi.

No authentication required. Returns real-time data for all requests. Unauthenticated responses include meta with upgrade information.

Authenticated: Supports historical snapshots via ?at=. Using ?at= without authentication returns 403.

Query Parameters

at?string

Historical timestamp (ISO 8601). Returns the snapshot that was active at this time. Only available for authenticated requests. Must be in the past.

Formatdate-time
sections?string

Comma-separated section filter. Valid sections: crypto, tradfi. Returns only the specified sections in the response.

Response Body

application/json

curl -X GET "https://example.com/v2/grounding?at=2026-03-25T12%3A00%3A00Z&sections=crypto%2Ctradfi"
{
  "status": 200,
  "meta": {
    "upgrade": {
      "description": "string",
      "protocol": "x402",
      "payment": "USDC on Base",
      "options": [
        {
          "period": "1 day",
          "price": "$10",
          "method": "POST",
          "url": "https://api.aixbt.tech/x402/v2/api-keys/1d"
        }
      ]
    }
  },
  "data": {
    "createdAt": "2019-08-24T14:15:22Z",
    "windowHours": 12,
    "sections": {
      "property1": {
        "title": "string",
        "items": [
          "string"
        ],
        "generatedAt": "2019-08-24T14:15:22Z"
      },
      "property2": {
        "title": "string",
        "items": [
          "string"
        ],
        "generatedAt": "2019-08-24T14:15:22Z"
      }
    }
  }
}
Empty
Empty
Empty