Skip to main content
GET
A wallet's position in one market

Path Parameters

conditionId
string
required

Polymarket condition id (bytes32 hex). 32-byte Polymarket condition id, hex.

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

"0xce9a5fa30fe74e323b4a8f15afbb0b7a41a537aa880779ddf7dee22223b2f34a"

Query Parameters

wallet
string
required

The user's resolved Robin staking wallet (DepositWallet or Safe proxy), not the EOA. 20-byte EVM address, lowercase hex.

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

"0xcb7444981296d08da7161b75378e3773dbf5d806"

Response

Position (possibly empty).

Single-market position. When hasPosition is false the descriptive market fields (question, slug, image, endDate, resolved, winningOutcome) are omitted and the rest are zeroed.

conditionId
string
required

32-byte Polymarket condition id, hex.

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

"0xce9a5fa30fe74e323b4a8f15afbb0b7a41a537aa880779ddf7dee22223b2f34a"

wallet
string
required

20-byte EVM address, lowercase hex.

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

"0xcb7444981296d08da7161b75378e3773dbf5d806"

hasPosition
boolean
required
shares
object
required
value
string
required

A non-negative integer in 6-decimal fixed-point micro-units (e.g. "1500000" = 1.5).

Pattern: ^[0-9]+$
Example:

"1500000"

yield
object
required

Accrued (not-yet-claimed) yield in 6-decimal USD, split by source.

positionApy
number<double>
required

APY in percent (6.0 = 6.00%).

Example:

6.4

question
string
slug
string
image
string | null
endDate
integer<int64> | null
resolved
boolean
winningOutcome
enum<string> | null
Available options:
yes,
no,
both,
null