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). Newer snapshots may also include a one-paragraph market take.

Free tier: Returns the latest snapshot within the configured delay window. Includes meta with upgrade information.

Authenticated: Returns the latest snapshot, or a historical snapshot via ?at=.

GET
/v2/grounding/latest

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

Response Body

application/json

curl -X GET "https://api.aixbt.tech/v2/grounding/latest?at=2026-03-25T12%3A00%3A00Z"
{
  "status": 200,
  "meta": {
    "tier": "free",
    "dataDelayHours": 12,
    "dataAsOf": "2019-08-24T14:15:22Z",
    "upgrade": {
      "description": "string",
      "protocol": "x402",
      "payment": "USDC on Base",
      "options": [
        {
          "period": "1 day",
          "price": "$0.1",
          "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"
      }
    },
    "summary": {
      "title": "Market Take",
      "text": "The combined tape still reads risk-on, but only where liquidity, equities, and crypto leadership stay aligned.",
      "generatedAt": "2019-08-24T14:15:22Z"
    }
  }
}
Empty
Empty