Suspicious trades

Get suspicious trades

Stored trades whose recorded suspicion score meets the live flag threshold. Evidence contains the scorer's stored signals. Cursor-paginated by suspicion score. mode=live (default) uses fresh cached pages; mode=stable pins pagination to one published scoring generation and returns cursor_expired when scores or filters change. Canonical since 2026-09-23; GET /api/v1/insider-radar is its deprecated alias.

get/api/v1/suspicious-trades

Query parameters

limitinteger

Maximum number of suspicious trades to return.

cursorstring

Pagination cursor from previous response.

min_suspicionnumber

Minimum suspicion score (0-100). The live flag floor of 60 also applies.

severity'flag' | 'watch'

Compatible filter. flag selects live threshold crossings. watch returns no rows because no live watch policy exists.

mode'live' | 'stable'

Pagination mode. live (default) keeps the 120-second response cache; stable pins the walk to one published scoring generation and binds the cursor to the limit and filters.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs.

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Suspicious trades list

object'list' required

has_moreboolean required

next_cursorstring

totalinteger

Total matching rows when the read model exposes a count; the key is absent when it does not.

Changes

Changed in 3 of the 89 revisions of this API.169

Sep 23, 2026ece7a25b7a4488See the full diff
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 23, 20268462acf80f8c8See the full diff
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 23, 2026468b5769754e1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history