Skip to main content
GET
cURL
Use Suspicious trades in new clients. This alias returns the same rows, rf_ IDs, cursors, and ETag. Each flag identifies a trade 0xinsider’s unusual-activity check flagged for review; it does not prove insider trading. Open a flag with Suspicious trade, or subscribe to insider_radar_flag_raised in Webhook events. This alias is removed on February 1, 2027. Responses include Deprecation: @1790121600 (September 23, 2026, at 00:00 UTC), Sunset: Mon, 01 Feb 2027 00:00:00 GMT and a Link to the replacement and versioning policy; from that date the route returns 410 with error.code endpoint_retired.

Parameters

Stable paging

Trades are rescored and the scores are republished, so paging in live mode can show you a row twice or skip one. mode=stable fixes that: the cursor it returns carries one published scoring run along with limit, min_suspicion, severity, from and to. Send mode=stable on the first request, then send each next_cursor back with the same mode and the same filters. If the scores are republished while you are paging, or you change a filter, you get 400 with error.reason cursor_expired. Request page 1 again with the same filters, because waiting does not revive the cursor.

Key response fields

Example

What it does not return

  • Proof of insider trading. A flag says one trade matched a heuristic worth a human look, and nothing more.
  • A row under 60. Even min_suspicion=0 returns only trades that crossed the flag floor.
  • A watch row. The filter is accepted for compatibility and always comes back empty.
  • The trade itself. size_usd, price, side, and the wallets on the other side are on Large trade. Both routes key on the same raw whale_alerts.id, so the integer inside an rf_ id opens the trade.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the list has not changed, the server returns 304 Not Modified with no body.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Scopes

read

Read markets, traders, large trades, positions, reports, search, the event stream and every MCP tool

Headers

X-Query-Validation
enum<string>

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, including when its percent escape is incomplete.

Available options:
strict
If-None-Match
string

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

Query Parameters

limit
integer
default:20

Maximum number of radar flags to return. Out-of-range values are clamped to 1..100.

Required range: 1 <= x <= 100
cursor
string

Pagination cursor from previous response.

min_suspicion
number
default:0

Minimum suspicion score (0-100). Every listed trade already meets the flag floor, so a lower value changes nothing.

severity
enum<string>

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

Available options:
flag,
watch
mode
enum<string>
default:live

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.

Available options:
live,
stable
sort
enum<string>
default:suspicion_score

List order. suspicion_score (default) lists the highest score first; recent lists the newest flagged trade (greatest created_at) first. Each sort, in each mode, issues its own cursor, and a cursor from another sort returns 400 bad_request. An unknown value returns 400 bad_request with param sort.

Available options:
suspicion_score,
recent
from
string<date-time>

Inclusive RFC3339 lower bound on traded_at, when the trade filled (created_at is the same instant). Applies in either sort and mode; a stable cursor is bound to it, so a changed window returns cursor_expired. A value that is not RFC3339 returns 400 bad_request with param from.

to
string<date-time>

Exclusive RFC3339 upper bound on traded_at. Must be after from when both are present; otherwise 400 bad_request with param to.

Response

Radar flags list

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required
meta
object
required
next_cursor
string
total
integer

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