> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xinsider.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Markdown of an API reference page leaves out the OpenAPI schema.
> Every object an endpoint returns or a webhook carries, with each field's type, presence and meaning, is on https://docs.0xinsider.com/api-reference/objects.md.
> The full OpenAPI 3.1 spec names each operation's and each webhook's exact parameters, request body and response schema: https://docs.0xinsider.com/api-reference/openapi.json.

# Combo fills

> List recorded Polymarket combo fills with their wallets, legs, execution amounts, and results.

A combo combines several market outcomes into one position. Use this route to read recorded taker fills, then open [Combo](https://docs.0xinsider.com/api-reference/endpoint/get-combo.md) for one combo's totals and lifecycle activity.

These routes require an API key or OAuth token with paid API access. The fill list returns full rows without the website's free delay or worked example.

## Parameters

| Parameter | Description |
| - | - |
| `result` | A comma-separated list of `pending`, `won`, and `lost`. Omit it or send `all` to include every result, including `unknown`. |
| `legs` | A comma-separated list of `2`, `3`, `4`, and `5+`. `5+` includes every combo with at least 5 legs. Omit it or send `all` for any leg count. |
| `min_stake` | The minimum fill collateral in whole USDC, from `0` to `1000000000`. The default is `0`. |
| `min_multiplier` | The minimum shares per USDC of collateral. Send `0` for no filter, or a whole number from `2` to `1000000`. |
| `grades` | A comma-separated list of wallet grades, such as `S,A,B`. Omit it or send `all` for every wallet, including ungraded wallets. See [Grades](https://docs.0xinsider.com/concepts/grades.md). |
| `sports` | A comma-separated list of sport slugs. A combo matches when any of its legs belongs to a selected sport. Omit it or send `all` for every sport. |
| `sort` | `recent` returns the newest fills first. `largest` orders by collateral. `payout` orders buy fills by shares, the amount a winning share position can redeem. The default is `recent`. |
| `window` | `24h`, `7d`, or `all`. The default is `all` for `recent`, and `24h` for `largest` and `payout`. |
| `limit` | The number of fills in a page, from `1` to `200`. The default is `50`. A value outside that range is clamped to the nearest bound. |
| `cursor` | The `next_cursor` from a `recent` page, in `block_number:log_index` form. Keep the same filters for the next page. |
| `offset` | The position for a `largest` or `payout` page, from `0` to `5000`. The default is `0`. Use `next_offset` to continue. |

The accepted `sports` slugs are `nfl`, `ncaaf`, `nba`, `wnba`, `baseball`, `hockey`, `soccer`, `tennis`, `table-tennis`, `esports`, `mma`, `boxing`, `golf`, `cricket`, `f1`, and `pickleball`.

Invalid filter values return `400` with `error.param` naming the parameter. A `cursor` with `largest` or `payout` also returns `400`.

## Key response fields

| Field | Meaning |
| - | - |
| `data[]` | The recorded fills on this page. Each row includes its combo's legs. |
| `data[].legs[].market.game_start_time` | The kickoff stored on that market, in UTC. Null when the leg has no local market or the market has no kickoff. |
| `data[].legs[].market.kickoff_date_passed` | True only when that kickoff's calendar date is before today (UTC). False on the kickoff's own date and false when there is no kickoff. True does not mean the game is over: a late kickoff is still in play after midnight UTC. The date in the question can be older after a postponement. |
| `data[].legs[].market.game_ended` | True when the market's game has ended, false while it is scheduled, in play or postponed, and null when no game state is stored for it. Null means unknown, not in play. A pending leg with this or `market_closed` true is waiting on its result. |
| `id` | The stored fill identifier. Use it to deduplicate rows. |
| `condition_id` | The combo identifier accepted by [Combo](https://docs.0xinsider.com/api-reference/endpoint/get-combo.md). |
| `action`, `outcome_index` | The wallet's `buy` or `sell` action and the outcome it traded. These describe the fill separately from the combo's result. |
| `shares`, `collateral_usdc`, `fee_usdc` | Exact decimal strings for the shares, USDC collateral, and fee. Preserve their precision when parsing them. |
| `price`, `price_yes` | The fill's execution price and its price expressed for the YES outcome. These are nullable decimal strings, not current quotes. |
| `payout_multiplier` | Shares divided by collateral, as a decimal string. It is `null` for zero collateral, and it does not include fees. |
| `status`, `status_reason`, `won_legs` | The result of the combo's YES conjunction, any reason its result is unavailable, and the number of winning legs. The result is not the wallet's realized P\&L. |
| `trader`, `trader_name`, `trader_grade` | The wallet address, its stored public name, and its latest grade. A missing name or grade is `null`. |
| `last_traded_at` | The wallet's recorded last trade time across markets. It is `null` when unavailable. |
| `coverage` | The recorded data's freshness and completeness, including `state`, block lag, and `computed_at`. Read it before treating a page as current. |
| `has_more`, `next_cursor`, `next_offset` | A full page returns a continuation for the chosen order, so its next page can be empty. Continuation fields are omitted when unavailable. |

## Example

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/combos/fills?result=pending,won&legs=3,5%2B&min_stake=50&min_multiplier=10&sports=soccer&limit=50"
```

## What it does not return

* Fills with an execution price above `0.95`. This ceiling applies to every list order.
* Fills whose combo legs have not all been indexed and described. One combo's [detail route](https://docs.0xinsider.com/api-reference/endpoint/get-combo.md) can still show its own recorded fills.
* Maker fills, an order book, or a price you can trade at now.
* A wallet's realized P\&L. `status` describes the YES conjunction, including on a NO fill or a sale.
* A total live-combo count. Use [Combos summary](https://docs.0xinsider.com/api-reference/endpoint/get-combos-summary.md).

## Caching

Save the response's `ETag` and send it in `If-None-Match` on your next request. If the representation has not changed, the server returns `304 Not Modified` with no body.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.0xinsider.com/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.