AIXBT Docs

Get Market Grounding

Returns the current market grounding snapshot. Each section contains bullet points summarizing the current state. Sections vary by snapshot (e.g., crypto, macro, geopolitics, 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.

GET
/v2/grounding

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, macro, geopolitics, tradfi. Returns only the specified sections in the response.

Response Body

application/json

curl -X GET "https://api.aixbt.tech/v2/grounding?at=2026-03-25T12%3A00%3A00Z&sections=crypto%2Cmacro"
{
  "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