Skip to main content
GET
Wallet combo redemptions and reductions
Returns the canonical combo redemption and reduction history for one wallet. This is the wallet-scoped form of GET /v3/combos/redemptions.

Request

Query parameters

Example

Choosing this endpoint

  • Use redemption_scope=full for terminal whole-combo redemptions.
  • Use redemption_scope=partial for post-resolution compression into a smaller combo, including a three-leg combo becoming a two-leg combo when Polymarket emits that transition.
  • Use event_kind=Extracted for structural full/reduced/residual lineage. Extraction is marked as a reduction, but not as a redemption.
  • Use the default all when reconstructing the wallet’s complete combo redemption and transformation history.
  • Use the global endpoint when the wallet is unknown or when correlating one condition, position, or transaction across wallets.
Existing standard and combo position endpoints are unchanged.

Authorizations

x-api-key
string
header
required

Path Parameters

address
string
required

Wallet address

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

Query Parameters

market_id
string

One or more comma-separated combo condition IDs. Matches any condition in the lineage.

condition_id
string

Combo condition ID. Matches any condition in the lineage.

Pattern: ^0x[a-fA-F0-9]{62}$
position_id
string

Primary, source, destination, or underlying position ID

Pattern: ^[0-9]+$
event_kind
enum<string>
Available options:
PositionRedeemed,
Compressed,
ConvertedOnEvent,
ConvertedToYesBasket,
Extracted,
Injected,
MergedFromYesBasket,
MergedOnCondition,
MergedOnEvent,
SplitOnCondition,
SplitOnEvent,
Unwrapped,
Wrapped,
all
redemption_scope
enum<string>
default:all

full = terminal redemption; partial = non-terminal post-resolution compression; transformation = non-redemption lifecycle lineage

Available options:
full,
partial,
transformation,
all
redemption_type
enum<string>
default:all
Available options:
FULL_COMBO,
PARTIAL_COMBO,
COMBO_TRANSFORMATION,
all
tx_hash
string

Exact Polygon transaction hash

Pattern: ^0x[a-fA-F0-9]{64}$
after
integer<int64>

Inclusive Unix timestamp in seconds

Required range: x >= 0
before
integer<int64>

Inclusive Unix timestamp in seconds

Required range: x >= 0
limit
integer
default:100
Required range: 1 <= x <= 300
offset
integer
default:0
Required range: x >= 0

Response

Wallet combo redemptions and reductions

address
string
redemptions
object[]
rows_returned
integer
has_more
boolean
offset
integer
limit
integer
position_type
string
Allowed value: "combo"
source
string
Allowed value: "v3.wallet_combos.redemptions"