Wallet combo redemptions and reductions
Combos
Wallet Combo Redemptions
List full combo redemptions and partial combo reductions for one wallet.
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=fullfor terminal whole-combo redemptions. - Use
redemption_scope=partialfor 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=Extractedfor structural full/reduced/residual lineage. Extraction is marked as a reduction, but not as a redemption. - Use the default
allwhen 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.
Authorizations
Path Parameters
Wallet address
Pattern:
^0x[a-fA-F0-9]{40}$Query Parameters
One or more comma-separated combo condition IDs. Matches any condition in the lineage.
Combo condition ID. Matches any condition in the lineage.
Pattern:
^0x[a-fA-F0-9]{62}$Primary, source, destination, or underlying position ID
Pattern:
^[0-9]+$Available options:
PositionRedeemed, Compressed, ConvertedOnEvent, ConvertedToYesBasket, Extracted, Injected, MergedFromYesBasket, MergedOnCondition, MergedOnEvent, SplitOnCondition, SplitOnEvent, Unwrapped, Wrapped, all full = terminal redemption; partial = non-terminal post-resolution compression; transformation = non-redemption lifecycle lineage
Available options:
full, partial, transformation, all Available options:
FULL_COMBO, PARTIAL_COMBO, COMBO_TRANSFORMATION, all Exact Polygon transaction hash
Pattern:
^0x[a-fA-F0-9]{64}$Inclusive Unix timestamp in seconds
Required range:
x >= 0Inclusive Unix timestamp in seconds
Required range:
x >= 0Required range:
1 <= x <= 300Required range:
x >= 0
