Skip to main content
GET
Get Edge Hunter
Use the experimental Edge Hunter endpoint to read the ranked sports markets shown on the Edge Hunter page. Each row includes its game and market identity, the side backed by graded wallets, the measured backing, and current outcome quotes when available. This endpoint requires Max. A valid Pro credential returns 403 forbidden with error.reason: max_plan_required. It replaces the retired sports signals and observations endpoints; it is a different response contract.

Parameters

The board covers all sports with a fixed B grade floor, including S, A, and B wallets. It returns the first 30 ranked rows after the horizon filter. total counts the matching rows before that cap.

Key response fields

The response uses object: "edge_hunter". Read the board from data, and the request metadata from meta. signal.sharp_pct is a fraction, not a percentage: 0.81 means 81%. signal.s_count, a_count, and b_count count the backing wallets by grade; graded_holders is their combined count.

Ranking and quote clocks

A ranking snapshot and a current quote measure different things. as_of dates the ranking; each available current_price has its own price, basis, and ts. A kickoff can have passed by the time you receive a cached snapshot, so compare game_start_time with the current time before using the row. price is a decimal string. basis is midpoint or last_trade, and ts is an epoch-millisecond string for the observed quote state. validated_at, when present, is a separate epoch-millisecond string for the validation time. A missing quote is null. Do not substitute zero or treat the quote as the wallets’ entry price. Read ranking_source and directional_source before presenting a fallback as current evidence.

Example

Use a Max API key or an authorized OAuth token. See Authentication.

What it does not return

  • Observation cohorts, their funnel, or holder-arrival history.
  • Cursor pagination, a category filter, or a configurable grade floor.
  • Backed token IDs or category-skill evidence.
  • A guaranteed return, an executed entry price, or an order instruction.
The retired paths are /api/v1/sports-edge-signals, /api/v1/sports-edge-observations, /api/v1/sports/pre-game-sides, and /api/v1/sports/pre-game-side-observations. All 4 return 410 endpoint_retired. Update the response parser when migrating.

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>

Set to strict to reject unsupported query names. By default, unknown query names are ignored and reported in X-Query-Ignored.

Available options:
strict

Query Parameters

horizon_hours
integer
default:48

Kickoff window in hours from the snapshot anchor. Defaults to 48; integer values below 1 or above 48 are clamped to 1 or 48.

Response

The full Max-only Edge Hunter board. No ETag or pagination is provided.

object
string
required
Allowed value: "edge_hunter"
data
object
required

The full Edge Hunter board shown at https://0xinsider.com/sports/edge, for Max credentials. It covers all sports and esports with a fixed B grade floor and returns the first 30 ranked rows. No cursor or observation cohorts are exposed.

meta
object
required