---
title: "Get public-market absorption observations"
method: GET
path: "/agent/microstructure-proxy"
---

# Get public-market absorption observations

`GET /agent/microstructure-proxy`

## Request

- Base URL: `https://app.fahaliai.com`
- URL: `https://app.fahaliai.com/agent/microstructure-proxy`
- Auth: none declared

Returns active hidden-liquidity observations derived from public aggregate trades and order-book snapshots. The interpretation is a proxy: Fahali does not observe dark-pool prints, identify participants, measure hidden volume, or attach a calibrated outcome probability.

## Query parameters

- `symbol` string
- `symbols` string
- `limit` integer
- `since` string, date-time

## Response `200`

Public-market microstructure observations

- MicrostructureProxyResponse
  - `status` 'ok', required
  - `dataState` 'measured' | 'partial' | 'no_data' | 'error', required
  - `headline` string, required
  - `claim` object
  - `scope` object
  - `resolutions` object[]
  - `data` object[], required
    - `sourceAlertId` number, nullable
    - `symbol` string
    - `canonicalInstrumentId` string, nullable
    - `assetClass` string
    - `venue` string, nullable
    - `quoteCurrency` string, nullable
    - `observedAt` string, date-time, nullable
    - `ageMinutes` number, nullable
    - `freshness` 'current' | 'recent' | 'historical' | 'unknown'
    - `direction` 'buy_side' | 'sell_side' | 'withheld'
    - `severity` string
    - `detectionScore` number, nullable: Uncalibrated composite observation score, not a probability.
    - `isProbability` false
    - `outcomeProbability` number, nullable: Null until a calibrated outcome model exists.
    - `observation` string
    - `evidence` object
    - `evidencePlain` object
  - `notReturned` object[]
  - `conflicts` object[]
  - `summary` object, required
  - `limitations` object, required
  - `disclaimer` string, required
  - `evidence` object
  - `provenance` object, required
  - `asOf` string, date-time, required

## Other responses

- `400`: Invalid time bound
- `500`: Source query failed; never interpreted as no activity

---

[API](https://skmtc.dev/fahaliai/apis/fahali-intelligence-api.md) · [All operations](https://skmtc.dev/fahaliai/apis/fahali-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fahaliai/apis/fahali-intelligence-api/revisions/d8115da5453f?raw)