Skip to main content
GET
Get user combo positions

Query Parameters

user
string
required

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

status
enum<string>[]

One or more statuses, comma-separated (e.g. status=RESOLVED_WIN,RESOLVED_PARTIAL,RESOLVED_LOSS). Values are case-insensitive; any invalid member is a 400. Omit for the default listing (open positions plus resolved positions with a recorded resolution).

Available options:
OPEN,
PARTIAL,
RESOLVED_PARTIAL,
RESOLVED_WIN,
RESOLVED_LOSS
sort
enum<string>
default:current_value_desc
Available options:
current_value_desc,
first_entry_desc,
entry_cost_desc,
resolved_at_desc,
updated_asc
market_id
string[]

Comma-separated combo_condition_id values to filter to specific combos. These equal the market_id of isCombo rows on /activity. Omit for all of the user's combos.

Combo condition ID (0x-prefixed, 62 hex chars / bytes31). Equals the market_id (unified) / conditionId (legacy) of isCombo rows on /activity.

Pattern: ^0x[a-fA-F0-9]{62}$
limit
integer
default:20
Required range: 0 <= x <= 1000
offset
integer
default:0
Required range: 0 <= x <= 100000
updatedAfter
integer

Incremental-sync watermark (epoch seconds, inclusive): only rows whose updated_at is at or after this time. Positions mutate on resolution and redemption, so this catches changes a creation-time filter cannot. In sync mode (updatedAfter/updatedBefore/sort=updated_asc) every live row is returned regardless of balance, and the effective upper bound is clamped ~90s behind now (commit-visibility safety lag) — very recent rows appear on the next poll. Rows at the boundary may re-deliver: upsert by (combo_condition_id, combo_position_id).

updatedBefore
integer

Optional upper bound (epoch seconds, inclusive) for updated_at; clamped to the safety lag. Must be >= updatedAfter.

cursor
string

Opaque continuation token from a previous response's pagination.next_cursor. When present it supersedes offset (which is ignored). Invalid, tampered, or cross-endpoint tokens return 400.

Response

Success

combos
object[]
pagination
object

Standard pagination metadata. No total count; has_more is derived from page fullness. next_cursor is opaque.