Finance

Visualization / heatmap data

post/api/v2/market/visualization

Request body

queryobject required

Screener/visualization query DSL: a nested {operator, operands} tree forwarded to the upstream screener.

sizeinteger nullable

Maximum number of results to return.

offsetinteger nullable

Result offset for pagination.

sortFieldstring nullable

Field to sort results by.

sortTypestring nullable

Sort direction, e.g. ASC or DESC.

quoteTypestring nullable

Instrument-type filter, e.g. EQUITY or ETF.

Example request

{
  "query": {
    "operands": [
      {
        "operands": [
          "intradaymarketcap",
          1000000000
        ],
        "operator": "gt"
      },
      {
        "operands": [
          "region",
          "us"
        ],
        "operator": "eq"
      }
    ],
    "operator": "and"
  }
}

Response

Visualization / heatmap payload.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}

Changes

Changed in 4 of the 21 revisions of this API.215

Aug 28, 2026560e8847c7b31See the full diff
- ▲
  response property data/tables/anyOf[subschema #1]/items/records/anyOf[subschema #1]/items/indices/anyOf[subschema #1]/items/ list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 24, 202664715a22734d2See the full diff
- ○
  added the optional property data/tables to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/total to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 11, 2026d9a732d8e6be11See the full diff
- ▲
  added required request body
  request-body-added-required
- ○
  added the non-success response with the status 422
  response-non-success-status-added
Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history