AIXBT Docs
API v3Reference

Get a published Report

GET
/v3/reports/{id}

Full report artifact: body, typed sources, and the publication-time evidence block. Requires the topic-reports entitlement. The evidence block quotes market figures with source attribution as part of the published research.

Authorization

ApiKeyAuth
x-api-key<token>

API key. The Authorization header is accepted as an equivalent carrier. Responses echo the credential class in X-API-Key-Type.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v3/reports/string"
{
  "data": {
    "id": "tr_9f2b6c41d8a35e07b1c4f6a2d5e8091c3b7a4f60d2e5c8b1a4f7092c5d8e3b6a",
    "title": "Restaking Yield Compression",
    "publishedAt": "2026-08-04T18:00:00Z",
    "revisedAt": null,
    "primarySubject": {
      "type": "topic",
      "topic": {
        "id": "topic_a1b2c3d4e5f601234567",
        "name": "Restaking yield compression"
      }
    },
    "relatedSubjects": [
      {
        "type": "project",
        "project": {
          "id": "665f0a2b1c9d440000a1b2c3",
          "slug": "examplechain",
          "name": "ExampleChain"
        }
      }
    ],
    "summary": "Yields across restaking protocols compress as new AVS demand stalls.",
    "body": "## Thesis\n\nYields compress because...",
    "sources": [
      {
        "title": "AVS demand dashboard",
        "url": "https://dune.com/example/avs",
        "publishedAt": "2026-08-03T00:00:00Z"
      }
    ],
    "evidence": {
      "snapshotAt": "2026-08-04T18:00:00Z",
      "entities": [
        {
          "project": {
            "id": "665f0a2b1c9d440000a1b2c3",
            "slug": "examplechain",
            "name": "ExampleChain"
          },
          "observations": [
            {
              "key": "avs_count",
              "value": 41,
              "unit": "count",
              "provider": "aixbt",
              "observedAt": "2026-08-04T17:58:00Z",
              "freshness": "fresh"
            }
          ]
        }
      ]
    }
  },
  "meta": {}
}
{
  "code": "invalid_request",
  "message": "minTrend must be numeric",
  "details": {
    "fields": [
      "minTrend"
    ]
  }
}

{
  "code": "credential_required",
  "message": "Provide an API key via the x-api-key header."
}

{
  "code": "entitlement_required",
  "message": "This resource requires the topic-reports entitlement.",
  "details": {
    "entitlement": "topic-reports"
  }
}

{
  "code": "not_found",
  "message": "No Project matches that locator.",
  "details": {
    "subject": {
      "type": "project",
      "locator": "examplechain"
    }
  }
}

{
  "code": "rate_limited",
  "message": "Minute limit reached.",
  "details": {
    "limit": 30,
    "window": "minute"
  }
}
{
  "code": "internal_error",
  "message": "Unexpected error."
}

List published Reports GET

Top-level read-only collection of published research artifacts, newest first, with relationship filters. List items are bounded previews; the full body requires the `topic-reports` entitlement on the detail route.

List Clusters GET

Audience/source archetypes used as an analysis dimension across Topics and Intel.