0xinsider · Schema

ComboResponse

SportsEsportsAnalyticsFinance

Properties

Name Type Description
object string
data object
meta object
View JSON Schema on GitHub

JSON Schema

0xinsider-com-combo-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-combo-response-schema.json",
  "title": "ComboResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-combos-api-openapi.yml#/components/schemas/ComboResponse",
  "type": "object",
  "required": [
    "object",
    "data",
    "meta"
  ],
  "properties": {
    "object": {
      "type": "string",
      "const": "combo"
    },
    "data": {
      "$ref": "#/$defs/ComboDetail"
    },
    "meta": {
      "$ref": "#/$defs/ResponseMeta"
    }
  },
  "$defs": {
    "Combo": {
      "type": "object",
      "required": [
        "condition_id",
        "leg_count",
        "prepared_at",
        "legs_known",
        "legs",
        "window",
        "totals",
        "status",
        "status_reason"
      ],
      "properties": {
        "condition_id": {
          "type": "string",
          "description": "Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID.",
          "pattern": "^0x[0-9a-f]{62}$"
        },
        "leg_count": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64"
        },
        "prepared_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "legs_known": {
          "type": "boolean",
          "description": "Whether the preparation event has been indexed."
        },
        "legs": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ComboLeg"
          }
        },
        "window": {
          "anyOf": [
            {
              "$ref": "#/$defs/ComboWindowStats"
            },
            {
              "type": "null"
            }
          ]
        },
        "totals": {
          "anyOf": [
            {
              "$ref": "#/$defs/ComboTotals"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string",
          "description": "Result of the YES conjunction, independent of the wallet side or its P&L.",
          "enum": [
            "pending",
            "won",
            "lost",
            "unknown"
          ]
        },
        "status_reason": {
          "type": [
            "string",
            "null"
          ],
          "description": "Reason the conjunction result cannot be verified, when unknown."
        }
      }
    },
    "ComboCoverage": {
      "type": "object",
      "required": [
        "state",
        "ingest_enabled",
        "cursors",
        "max_lag_blocks",
        "oldest_cursor_update",
        "lifecycle_lag_blocks",
        "lifecycle_backfilling",
        "computed_at"
      ],
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "paused",
            "uninitialized",
            "stale",
            "backfilling",
            "live"
          ]
        },
        "ingest_enabled": {
          "type": "boolean"
        },
        "cursors": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ComboCoverageCursor"
          }
        },
        "max_lag_blocks": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64"
        },
        "oldest_cursor_update": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "lifecycle_lag_blocks": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64"
        },
        "lifecycle_backfilling": {
          "type": "boolean"
        },
        "computed_at": {
          "type": "string",
          "description": "Time the coverage state was evaluated; not a market-price timestamp.",
          "format": "date-time"
        }
      }
    },
    "ComboCoverageCursor": {
      "type": "object",
      "required": [
        "contract",
        "last_block",
        "seed_block",
        "seed_origin",
        "chain_finalized_block",
        "lag_blocks",
        "updated_at"
      ],
      "properties": {
        "contract": {
          "type": "string",
          "description": "Indexed contract."
        },
        "last_block": {
          "type": "integer",
          "format": "int64"
        },
        "seed_block": {
          "type": "integer",
          "format": "int64"
        },
        "seed_origin": {
          "type": "string"
        },
        "chain_finalized_block": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64"
        },
        "lag_blocks": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "ComboDetail": {
      "type": "object",
      "required": [
        "access",
        "combo",
        "fills",
        "lifecycle",
        "coverage"
      ],
      "properties": {
        "access": {
          "type": "string",
          "enum": [
            "full"
          ]
        },
        "combo": {
          "$ref": "#/$defs/Combo"
        },
        "fills": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "$ref": "#/$defs/ComboFill"
          }
        },
        "lifecycle": {
          "anyOf": [
            {
              "$ref": "#/$defs/ComboLifecycleStats"
            },
            {
              "type": "null"
            }
          ]
        },
        "coverage": {
          "$ref": "#/$defs/ComboCoverage"
        }
      },
      "description": "One combo with its newest 100 fills and all-time lifecycle totals. Paid API callers receive full access."
    },
    "ComboFill": {
      "type": "object",
      "required": [
        "id",
        "block_number",
        "log_index",
        "block_timestamp",
        "tx_hash",
        "trader",
        "trader_name",
        "trader_grade",
        "last_traded_at",
        "action",
        "condition_id",
        "outcome_index",
        "shares",
        "collateral_usdc",
        "price",
        "price_yes",
        "fee_usdc",
        "leg_count",
        "status",
        "status_reason",
        "won_legs",
        "payout_multiplier",
        "legs"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable fill identity."
        },
        "block_number": {
          "type": "integer",
          "format": "int64"
        },
        "log_index": {
          "type": "integer",
          "format": "int64"
        },
        "block_timestamp": {
          "type": "string",
          "format": "date-time"
        },
        "tx_hash": {
          "type": "string"
        },
        "trader": {
          "type": [
            "string",
            "null"
          ],
          "description": "Taker wallet address."
        },
        "trader_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "trader_grade": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "S",
            "A",
            "B",
            "C",
            "D",
            "F",
            null
          ]
        },
        "last_traded_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "Recorded wallet-wide trade time.",
          "format": "date-time"
        },
        "action": {
          "type": "string",
          "enum": [
            "buy",
            "sell"
          ]
        },
        "condition_id": {
          "type": "string",
          "description": "Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID.",
          "pattern": "^0x[0-9a-f]{62}$"
        },
        "outcome_index": {
          "type": "integer",
          "format": "int64",
          "description": "0 is YES, 1 is NO."
        },
        "shares": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "collateral_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "price": {
          "type": [
            "string",
            "null"
          ],
          "description": "Execution price for the traded outcome; null for a zero-share event."
        },
        "price_yes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Execution price normalized to YES."
        },
        "fee_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "leg_count": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64"
        },
        "status": {
          "type": "string",
          "description": "Result of the YES conjunction, independent of the wallet side or its P&L.",
          "enum": [
            "pending",
            "won",
            "lost",
            "unknown"
          ]
        },
        "status_reason": {
          "type": [
            "string",
            "null"
          ]
        },
        "won_legs": {
          "type": "integer",
          "format": "int64"
        },
        "payout_multiplier": {
          "type": [
            "string",
            "null"
          ],
          "description": "Shares per dollar at execution; not a forecast or guaranteed return."
        },
        "legs": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ComboLeg"
          }
        }
      }
    },
    "ComboLeg": {
      "type": "object",
      "required": [
        "leg_index",
        "outcome_index",
        "module_id",
        "state",
        "market"
      ],
      "properties": {
        "leg_index": {
          "type": "integer",
          "format": "int64"
        },
        "outcome_index": {
          "type": "integer",
          "format": "int64"
        },
        "module_id": {
          "type": "integer",
          "format": "int64"
        },
        "state": {
          "type": "string",
          "enum": [
            "pending",
            "won",
            "lost",
            "void",
            "unknown"
          ]
        },
        "market": {
          "anyOf": [
            {
              "$ref": "#/$defs/ComboLegMarket"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "ComboLegMarket": {
      "type": "object",
      "required": [
        "source",
        "condition_id",
        "title",
        "slug",
        "event_slug",
        "outcome_label",
        "image",
        "category",
        "winning_outcome",
        "resolved_at",
        "market_closed",
        "pick_price_daily",
        "pick_price_as_of",
        "pick_price_age_days",
        "provider_leg_status"
      ],
      "properties": {
        "source": {
          "type": "string",
          "description": "Source of the leg facts.",
          "enum": [
            "markets",
            "provider"
          ]
        },
        "condition_id": {
          "type": "string",
          "description": "Full binary CTF condition ID for this leg."
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "slug": {
          "type": [
            "string",
            "null"
          ]
        },
        "event_slug": {
          "type": [
            "string",
            "null"
          ]
        },
        "polymarket_url": {
          "type": "string",
          "description": "Provider-resolved URL including the referral tag.",
          "format": "uri"
        },
        "outcome_label": {
          "type": [
            "string",
            "null"
          ]
        },
        "image": {
          "type": [
            "string",
            "null"
          ]
        },
        "category": {
          "type": [
            "string",
            "null"
          ]
        },
        "winning_outcome": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "description": "Provider outcome index; negative sentinels describe void or unresolved states."
        },
        "resolved_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "market_closed": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "A closed market may still have no terminal outcome."
        },
        "pick_price_daily": {
          "type": [
            "number",
            "null"
          ],
          "description": "Stored daily price for this leg outcome token; not a live quote."
        },
        "pick_price_as_of": {
          "type": [
            "string",
            "null"
          ],
          "description": "Observation time of the stored daily price.",
          "format": "date-time"
        },
        "pick_price_age_days": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "description": "Whole days since the stored daily bucket."
        },
        "provider_leg_status": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unmodified provider leg status when available."
        }
      }
    },
    "ComboLifecycleStats": {
      "type": "object",
      "required": [
        "splits",
        "merges",
        "redeems",
        "compresses",
        "split_usdc",
        "merge_usdc",
        "redeemed_shares",
        "redeemed_usdc",
        "compressed_usdc",
        "last_event_at"
      ],
      "properties": {
        "splits": {
          "type": "integer",
          "format": "int64"
        },
        "merges": {
          "type": "integer",
          "format": "int64"
        },
        "redeems": {
          "type": "integer",
          "format": "int64"
        },
        "compresses": {
          "type": "integer",
          "format": "int64"
        },
        "split_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "merge_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "redeemed_shares": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "redeemed_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "compressed_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "last_event_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "ComboTotals": {
      "type": "object",
      "required": [
        "fills",
        "volume_usdc",
        "largest_fill_usdc",
        "first_fill_at",
        "last_fill_at",
        "last_fill_price_yes",
        "last_fill_outcome_index",
        "last_fill_action"
      ],
      "properties": {
        "fills": {
          "type": "integer",
          "format": "int64"
        },
        "volume_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "largest_fill_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "first_fill_at": {
          "type": "string",
          "format": "date-time"
        },
        "last_fill_at": {
          "type": "string",
          "format": "date-time"
        },
        "last_fill_price_yes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last taker execution normalized to YES; not a current quote."
        },
        "last_fill_outcome_index": {
          "type": "integer",
          "format": "int64"
        },
        "last_fill_action": {
          "type": "string",
          "enum": [
            "buy",
            "sell"
          ]
        }
      }
    },
    "ComboWindowStats": {
      "type": "object",
      "required": [
        "fills",
        "volume_usdc",
        "distinct_traders",
        "largest_fill_usdc"
      ],
      "properties": {
        "fills": {
          "type": "integer",
          "format": "int64"
        },
        "volume_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        },
        "distinct_traders": {
          "type": "integer",
          "format": "int64"
        },
        "largest_fill_usdc": {
          "type": "string",
          "description": "Exact decimal string from the stored chain or SQL value; preserve precision until display."
        }
      }
    },
    "ResponseMeta": {
      "type": "object",
      "required": [
        "request_id",
        "cached",
        "cost"
      ],
      "properties": {
        "request_id": {
          "type": "string",
          "description": "Unique request ID (req_ prefix). The same value as the X-Request-Id response header, the request's usage accounting row and its log lines."
        },
        "cached": {
          "type": "boolean"
        },
        "cache_age_s": {
          "type": "integer",
          "description": "Cache age in seconds. Omitted when the response was not cached, and also when it was cached but its age cannot be established (an entry stored before its cache carried a computed instant). Never a placeholder: an unknown age is reported as no value rather than as the cache TTL."
        },
        "cost": {
          "type": "integer",
          "description": "Advisory request weight (relative compute cost). 1 for simple reads; higher for heavier endpoints. Not a credit/price."
        },
        "ranking_generation": {
          "type": "integer",
          "description": "Committed PostgreSQL-owned leaderboard generation for the returned rows and cursor. Present on GET /api/v1/leaderboard; omitted on endpoints that do not read this ranking."
        },
        "ranking_as_of": {
          "type": "string",
          "format": "date-time",
          "description": "Authoritative RFC3339 timestamp from cache_generations.updated_at for ranking_generation. It is read in the same repeatable-read snapshot as the leaderboard rows and is not request time, cache write time, or row insertion order."
        },
        "directional_source": {
          "type": "string",
          "enum": [
            "live",
            "degraded"
          ],
          "description": "Directional evidence provenance for Edge Hunter signals collections. The default board carries this provenance in data.directional_source and omits this optional meta field."
        },
        "ranking_source": {
          "type": "string",
          "enum": [
            "live",
            "db_only"
          ],
          "description": "Ranking evidence provenance for Edge Hunter signals collections. The default board carries this clock/provenance in data.ranking_source and omits this optional meta field."
        },
        "category_skill_source": {
          "type": "string",
          "enum": [
            "live",
            "partial",
            "degraded",
            "unavailable"
          ],
          "description": "Whole filtered snapshot category-evidence status before pagination. Operational live always remains partial source coverage."
        },
        "category_skill_model_version": {
          "type": "string"
        },
        "category_skill_taxonomy_version": {
          "type": "string"
        },
        "category_skill_platform": {
          "type": "string",
          "const": "polymarket"
        },
        "category_skill_scope": {
          "type": "string",
          "const": "observed_goldsky_primary_taker_fill"
        },
        "category_skill_source_coverage": {
          "type": "string",
          "enum": [
            "partial_whale_threshold_fills",
            "graded_wallet_fills"
          ]
        },
        "category_skill_observation_started_at": {
          "type": "string",
          "format": "date-time"
        },
        "category_skill_model_operationally_degraded": {
          "type": "boolean",
          "description": "Whole-model operational readiness captured with the category model snapshot. Present on category-enriched responses even when the filtered signal list is empty. When true, category_skill_source is degraded and Edge Hunter signals uses the shorter degraded cache TTL."
        },
        "category_skill_status_counts": {
          "type": "object",
          "required": [
            "live",
            "insufficient",
            "stale",
            "unknown",
            "degraded"
          ],
          "properties": {
            "live": {
              "type": "integer",
              "minimum": 0
            },
            "insufficient": {
              "type": "integer",
              "minimum": 0
            },
            "stale": {
              "type": "integer",
              "minimum": 0
            },
            "unknown": {
              "type": "integer",
              "minimum": 0
            },
            "degraded": {
              "type": "integer",
              "minimum": 0
            }
          }
        },
        "category_skill_base_payload_hash": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$",
          "description": "SHA-256 of the funded signal membership/order/rank/cursor vector immediately before category-skill enrichment. Edge Hunter signals view only."
        },
        "category_skill_enriched_base_payload_hash": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$",
          "description": "Independent SHA-256 recomputation over the same base fields immediately after category-skill enrichment. Equality with category_skill_base_payload_hash proves category-skill enrichment did not change funded inputs. Edge Hunter signals view only."
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/0xinsider-com-combo-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.