Skip to main content
GET
cURL
Use Suspicious trade in new clients. This alias accepts the same IDs and returns the same data, while keeping object: "radar_flag" for existing clients. The flag identifies a trade for review and does not prove insider trading. For a list of flags, use Suspicious trades. This route remains available without a retirement date. Responses include Deprecation: @1790121600 (September 23, 2026, at 00:00 UTC) and a Link to the replacement and versioning policy; there is no Sunset header.

Parameters

Key response fields

Example

What it does not return

  • Proof of insider trading. The flag says one trade matched a heuristic worth a human look, and nothing more.
  • A freshly computed score. Every value here is the one stored when the trade was scored.
  • The trade itself. The same raw whale_alerts.id opens it on Large trade, with size_usd, price, side, and the wallets on the other side.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the flag 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).

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.

Path Parameters

id
string
required

Raw whale_alerts.id or rf_-prefixed radar flag id.

Response

Radar flag

object
string
required
Allowed value: "radar_flag"
data
object
required
meta
object
required