{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    },
    "schemas": {
      "Provider65D835437A58_Address": {
        "type": "string",
        "description": "User Profile Address (0x-prefixed, 40 hex chars)",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
      },
      "Provider65D835437A58_Hash64": {
        "type": "string",
        "description": "0x-prefixed 64-hex string",
        "pattern": "^0x[a-fA-F0-9]{64}$",
        "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
      },
      "Response65D835437A58_Activity": {
        "type": "object",
        "properties": {
          "proxyWallet": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64"
          },
          "conditionId": {
            "$ref": "#/components/schemas/Response65D835437A58_Hash64"
          },
          "type": {
            "type": "string",
            "enum": [
              "TRADE",
              "SPLIT",
              "MERGE",
              "REDEEM",
              "REWARD",
              "CONVERSION",
              "DEPOSIT",
              "WITHDRAWAL",
              "YIELD",
              "MAKER_REBATE",
              "TAKER_REBATE",
              "REFERRAL_REWARD"
            ]
          },
          "size": {
            "type": "number",
            "description": "Token amount for this row. On `REDEEM` rows it is the number of tokens burned for this row's outcome, so redeeming both sides of a market returns one row per outcome instead of a single combined row."
          },
          "usdcSize": {
            "type": "number",
            "description": "USDC amount for this row. On `REDEEM` rows it is the payout for this row's outcome and is `0` for a losing outcome; the rows of one redemption sum to the total payout."
          },
          "transactionHash": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "asset": {
            "type": "string",
            "description": "Token ID this row refers to. Populated on `REDEEM` rows with the token that row settles. Empty when the row is not token-specific."
          },
          "side": {
            "type": "string",
            "enum": [
              "BUY",
              "SELL"
            ]
          },
          "outcomeIndex": {
            "type": "integer",
            "description": "Zero-based index of this row's outcome in the market's `outcomes` array, so `outcome` always equals `outcomes[outcomeIndex]`. On `REDEEM` rows it identifies the outcome the row settles, not the market's winning outcome. `999` means the outcome could not be determined, in which case `outcome` is empty."
          },
          "title": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "icon": {
            "type": "string",
            "description": "Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own. Empty on `CONVERSION` rows."
          },
          "eventSlug": {
            "type": "string"
          },
          "outcome": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "pseudonym": {
            "type": "string"
          },
          "bio": {
            "type": "string"
          },
          "profileImage": {
            "type": "string"
          },
          "profileImageOptimized": {
            "type": "string"
          },
          "isCombo": {
            "type": "boolean",
            "description": "True when this row is part of a combinatorial (multi-market) position. Flag only — combo detail is not embedded here. The row's conditionId equals the combo's combo_condition_id; pass it to /v1/activity/combos or /v1/positions/combos via market_id to fetch legs and detail. Omitted on non-combo rows."
          }
        }
      },
      "Response65D835437A58_Address": {
        "type": "string",
        "description": "User Profile Address (0x-prefixed, 40 hex chars)",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
      },
      "Response65D835437A58_Hash64": {
        "type": "string",
        "description": "0x-prefixed 64-hex string",
        "pattern": "^0x[a-fA-F0-9]{64}$",
        "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
      },
      "Response65D835437A58_ClosedPosition": {
        "type": "object",
        "properties": {
          "proxyWallet": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "asset": {
            "type": "string"
          },
          "conditionId": {
            "$ref": "#/components/schemas/Response65D835437A58_Hash64"
          },
          "avgPrice": {
            "type": "number"
          },
          "totalBought": {
            "type": "number"
          },
          "realizedPnl": {
            "type": "number"
          },
          "curPrice": {
            "type": "number"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64"
          },
          "title": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "eventSlug": {
            "type": "string"
          },
          "outcome": {
            "type": "string"
          },
          "outcomeIndex": {
            "type": "integer"
          },
          "oppositeOutcome": {
            "type": "string"
          },
          "oppositeAsset": {
            "type": "string"
          },
          "endDate": {
            "type": "string"
          }
        }
      },
      "Response65D835437A58_MetaHolder": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "holders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Response65D835437A58_Holder"
            }
          }
        }
      },
      "Response65D835437A58_Holder": {
        "type": "object",
        "properties": {
          "proxyWallet": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "bio": {
            "type": "string"
          },
          "asset": {
            "type": "string"
          },
          "pseudonym": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "displayUsernamePublic": {
            "type": "boolean"
          },
          "outcomeIndex": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "profileImage": {
            "type": "string"
          },
          "profileImageOptimized": {
            "type": "string"
          }
        }
      },
      "Response65D835437A58_LiveVolume": {
        "type": "object",
        "properties": {
          "total": {
            "type": "number"
          },
          "markets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Response65D835437A58_MarketVolume"
            }
          }
        }
      },
      "Response65D835437A58_MarketVolume": {
        "type": "object",
        "properties": {
          "market": {
            "$ref": "#/components/schemas/Response65D835437A58_Hash64"
          },
          "value": {
            "type": "number"
          }
        }
      },
      "Response65D835437A58_OpenInterest": {
        "type": "object",
        "properties": {
          "market": {
            "$ref": "#/components/schemas/Response65D835437A58_Hash64"
          },
          "value": {
            "type": "number"
          }
        }
      },
      "Response65D835437A58_Position": {
        "type": "object",
        "properties": {
          "proxyWallet": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "asset": {
            "type": "string"
          },
          "conditionId": {
            "$ref": "#/components/schemas/Response65D835437A58_Hash64"
          },
          "size": {
            "type": "number"
          },
          "avgPrice": {
            "type": "number"
          },
          "initialValue": {
            "type": "number"
          },
          "grossInitialValue": {
            "type": "number",
            "description": "Remaining entry basis including attributed BUY fees, at six-decimal source precision. `initialValue` and `avgPrice` keep their fee-exclusive semantics, so the fee-exclusive basis is `grossInitialValue - entryFeesUsdc`. Optional: treat an omitted field as unavailable rather than as zero."
          },
          "entryFeesUsdc": {
            "type": "number",
            "description": "Attributed BUY-fee component of `grossInitialValue`, at six-decimal source precision. SELL fees are exit costs and are never included. Returned as an explicit `0` when the fee component is zero. Optional: treat an omitted field as unavailable rather than as zero."
          },
          "currentValue": {
            "type": "number"
          },
          "cashPnl": {
            "type": "number"
          },
          "percentPnl": {
            "type": "number"
          },
          "totalBought": {
            "type": "number"
          },
          "realizedPnl": {
            "type": "number"
          },
          "percentRealizedPnl": {
            "type": "number"
          },
          "curPrice": {
            "type": "number"
          },
          "redeemable": {
            "type": "boolean"
          },
          "mergeable": {
            "type": "boolean"
          },
          "title": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "eventSlug": {
            "type": "string"
          },
          "outcome": {
            "type": "string"
          },
          "outcomeIndex": {
            "type": "integer"
          },
          "oppositeOutcome": {
            "type": "string"
          },
          "oppositeAsset": {
            "type": "string"
          },
          "endDate": {
            "type": "string"
          },
          "negativeRisk": {
            "type": "boolean"
          }
        }
      },
      "Response65D835437A58_Traded": {
        "type": "object",
        "properties": {
          "user": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "traded": {
            "type": "integer"
          }
        }
      },
      "Response65D835437A58_LeaderboardEntry": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "string",
            "description": "The rank position of the builder"
          },
          "builder": {
            "type": "string",
            "description": "The builder name or identifier"
          },
          "builderCode": {
            "type": "string",
            "description": "The builder's onchain attribution code as attached to orders via `builderCode` (see CLOB V2). Empty string for legacy builders without a registered code."
          },
          "volume": {
            "type": "number",
            "description": "Total trading volume attributed to this builder"
          },
          "activeUsers": {
            "type": "integer",
            "description": "Number of active users for this builder"
          },
          "verified": {
            "type": "boolean",
            "description": "Whether the builder is verified"
          },
          "builderLogo": {
            "type": "string",
            "description": "URL to the builder's logo image"
          }
        }
      },
      "Response65D835437A58_BuilderVolumeEntry": {
        "type": "object",
        "properties": {
          "dt": {
            "type": "string",
            "format": "date-time",
            "description": "The timestamp for this volume entry in ISO 8601 format",
            "example": "2025-11-15T00:00:00Z"
          },
          "builder": {
            "type": "string",
            "description": "The builder name or identifier"
          },
          "builderCode": {
            "type": "string",
            "description": "The builder's onchain attribution code as attached to orders via `builderCode` (see CLOB V2). Empty string for legacy builders without a registered code."
          },
          "builderLogo": {
            "type": "string",
            "description": "URL to the builder's logo image"
          },
          "verified": {
            "type": "boolean",
            "description": "Whether the builder is verified"
          },
          "volume": {
            "type": "number",
            "description": "Trading volume for this builder on this date"
          },
          "activeUsers": {
            "type": "integer",
            "description": "Number of active users for this builder on this date"
          },
          "rank": {
            "type": "string",
            "description": "The rank position of the builder on this date"
          }
        }
      },
      "Response65D835437A58_TraderLeaderboardEntry": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "string",
            "description": "The rank position of the trader"
          },
          "proxyWallet": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "userName": {
            "type": "string",
            "description": "The trader's username"
          },
          "vol": {
            "type": "number",
            "description": "Trading volume for this trader"
          },
          "pnl": {
            "type": "number",
            "description": "Profit and loss for this trader"
          },
          "profileImage": {
            "type": "string",
            "description": "URL to the trader's profile image"
          },
          "xUsername": {
            "type": "string",
            "description": "The trader's X (Twitter) username"
          },
          "verifiedBadge": {
            "type": "boolean",
            "description": "Whether the trader has a verified badge"
          }
        }
      },
      "Response65D835437A58_MetaMarketPositionV1": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string",
            "description": "The outcome token asset ID"
          },
          "positions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Response65D835437A58_MarketPositionV1"
            }
          }
        }
      },
      "Response65D835437A58_MarketPositionV1": {
        "type": "object",
        "properties": {
          "proxyWallet": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "name": {
            "type": "string"
          },
          "profileImage": {
            "type": "string"
          },
          "verified": {
            "type": "boolean"
          },
          "asset": {
            "type": "string"
          },
          "conditionId": {
            "$ref": "#/components/schemas/Response65D835437A58_Hash64"
          },
          "avgPrice": {
            "type": "number"
          },
          "size": {
            "type": "number"
          },
          "currPrice": {
            "type": "number"
          },
          "currentValue": {
            "type": "number"
          },
          "cashPnl": {
            "type": "number"
          },
          "totalBought": {
            "type": "number"
          },
          "realizedPnl": {
            "type": "number"
          },
          "totalPnl": {
            "type": "number"
          },
          "outcome": {
            "type": "string"
          },
          "outcomeIndex": {
            "type": "integer"
          }
        }
      },
      "Response65D835437A58_Value": {
        "type": "object",
        "properties": {
          "user": {
            "$ref": "#/components/schemas/Response65D835437A58_Address"
          },
          "value": {
            "type": "number"
          }
        }
      }
    },
    "responses": {},
    "parameters": {},
    "examples": {},
    "requestBodies": {},
    "headers": {},
    "links": {},
    "callbacks": {},
    "pathItems": {}
  },
  "info": {
    "description": "",
    "title": "Polymarket Data",
    "version": "1",
    "x-aisa-capabilities": {
      "idempotency": "Idempotency-Key",
      "max_price": "X-AISA-Max-Price-USD",
      "quote": {
        "header": "X-AISA-Cost-Mode",
        "value": "quote"
      }
    },
    "x-aisa-configured-paths": [
      "/apis/v1/polymarket/activity",
      "/apis/v1/polymarket/closed-positions",
      "/apis/v1/polymarket/holders",
      "/apis/v1/polymarket/live-volume",
      "/apis/v1/polymarket/oi",
      "/apis/v1/polymarket/positions",
      "/apis/v1/polymarket/traded",
      "/apis/v1/polymarket/v1/accounting/snapshot",
      "/apis/v1/polymarket/v1/builders/leaderboard",
      "/apis/v1/polymarket/v1/builders/volume",
      "/apis/v1/polymarket/v1/leaderboard",
      "/apis/v1/polymarket/v1/market-positions",
      "/apis/v1/polymarket/value"
    ],
    "x-aisa-document": {
      "facts_hash": "e5ff56471e62e340c326a9cf8efdb405dd827483c23e3fee435eec7999b7a85a",
      "generator_version": "3",
      "protocol_version": "1",
      "schema_version": "1",
      "composer_version": "20",
      "response_pending": [],
      "document_hash": "sha256:febc033b2736c178811cf84a971dde09747a88874590e394794cb4f436ec6333"
    },
    "x-aisa-plans": {
      "builder": 1.0,
      "display_plan": "payg",
      "payg": 1.0,
      "similarweb_payg": 1.0,
      "team": 1.0,
      "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
    },
    "x-aisa-provider": "polymarket-data",
    "x-aisa-catalogs": {
      "polymarket-data": {
        "title": "Polymarket Data",
        "description": "",
        "x-aisa-document": {
          "facts_hash": "e5ff56471e62e340c326a9cf8efdb405dd827483c23e3fee435eec7999b7a85a",
          "generator_version": "3",
          "protocol_version": "1",
          "schema_version": "1"
        },
        "x-aisa-plans": {
          "builder": 1.0,
          "display_plan": "payg",
          "payg": 1.0,
          "similarweb_payg": 1.0,
          "team": 1.0,
          "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
        },
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          }
        }
      }
    }
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "openapi": "3.1.0",
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "paths": {
    "/apis/v1/polymarket/activity": {
      "get": {
        "description": "Returns user activity with pagination and filtering.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "get_polymarket_activity",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_Activity"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get user activity",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "011dae9597ce"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/activity",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "get_polymarket_activity",
          "method": "ANY",
          "path": "/apis/v1/polymarket/activity"
        },
        "parameters": [
          {
            "in": "query",
            "name": "end",
            "schema": {
              "type": "integer",
              "minimum": 0
            },
            "description": "Upper-bound timestamp (epoch seconds) for the activity window. Omit for the default (current time); rows newer than `end` are excluded."
          },
          {
            "in": "query",
            "name": "eventId",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 1
              }
            },
            "description": "Comma-separated list of event IDs. Mutually exclusive with market."
          },
          {
            "in": "query",
            "name": "excludeDepositsWithdrawals",
            "schema": {
              "type": "boolean",
              "default": true
            },
            "description": "Excludes deposit and withdrawal records. The default `true` applies even when `type` requests those records, so to get deposits and withdrawals you must pass `false`."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 100,
              "minimum": 0,
              "maximum": 500
            },
            "description": "Page size. Values above the maximum are clamped to 500."
          },
          {
            "in": "query",
            "name": "market",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "0x-prefixed 64-hex string",
                "pattern": "^0x[a-fA-F0-9]{64}$",
                "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
              }
            },
            "description": "Comma-separated list of condition IDs. Mutually exclusive with eventId."
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 5000
            },
            "description": "Starting index for pagination. Requests past the cap are rejected with a 400 (never silently clamped). To read history deeper than offset 5000, page inside `start`/`end` windows — each window has its own offset budget."
          },
          {
            "in": "query",
            "name": "side",
            "schema": {
              "type": "string",
              "enum": [
                "BUY",
                "SELL"
              ]
            }
          },
          {
            "in": "query",
            "name": "sortBy",
            "schema": {
              "type": "string",
              "enum": [
                "TIMESTAMP",
                "TOKENS",
                "CASH"
              ],
              "default": "TIMESTAMP"
            }
          },
          {
            "in": "query",
            "name": "sortDirection",
            "schema": {
              "type": "string",
              "enum": [
                "ASC",
                "DESC"
              ],
              "default": "DESC"
            },
            "description": "`DESC` (default) returns the newest rows first; `ASC` the oldest first. Both orders are stable — the same query returns the same rows at any `limit`/`offset`, so pages compose without gaps or repeats."
          },
          {
            "in": "query",
            "name": "start",
            "schema": {
              "type": "integer",
              "minimum": 0
            },
            "description": "Lower-bound timestamp (epoch seconds) for the activity window. Omit or pass `0` for the default window (most recent ~3 years); pass a positive epoch (e.g. `1`) to retrieve full history. With `sortDirection=ASC`, omitting `start` already reads from the beginning of the account's history (no default window)."
          },
          {
            "in": "query",
            "name": "type",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "TRADE",
                  "SPLIT",
                  "MERGE",
                  "REDEEM",
                  "REWARD",
                  "CONVERSION",
                  "DEPOSIT",
                  "WITHDRAWAL",
                  "YIELD",
                  "MAKER_REBATE",
                  "TAKER_REBATE",
                  "REFERRAL_REWARD"
                ]
              }
            },
            "description": "Comma-separated list of activity types to include. DEPOSIT and WITHDRAWAL records also require `excludeDepositsWithdrawals=false`."
          },
          {
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            }
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:4de245b4ddb84416172ae209c0ec254a28dfe8d106337d3b4577f249bee68ae1"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/prediction-market/get_polymarket-activity"
      }
    },
    "/apis/v1/polymarket/closed-positions": {
      "get": {
        "description": "Returns closed positions for a user.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_closed_positions",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_ClosedPosition"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get closed positions for a user",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "c90bb49317a5"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/closed-positions",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_closed_positions",
          "method": "ANY",
          "path": "/apis/v1/polymarket/closed-positions"
        },
        "parameters": [
          {
            "in": "query",
            "name": "eventId",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 1
              }
            },
            "description": "The event id of the event in question. Supports multiple csv separated values. Returns positions for all markets for those event ids. Cannot be used with the market param."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 10,
              "minimum": 0,
              "maximum": 50
            },
            "description": "The max number of positions to return"
          },
          {
            "in": "query",
            "name": "market",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "0x-prefixed 64-hex string",
                "pattern": "^0x[a-fA-F0-9]{64}$",
                "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
              }
            },
            "description": "The conditionId of the market in question. Supports multiple csv separated values. Cannot be used with the eventId param."
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 100000
            },
            "description": "The starting index for pagination"
          },
          {
            "in": "query",
            "name": "sortBy",
            "schema": {
              "type": "string",
              "enum": [
                "REALIZEDPNL",
                "TITLE",
                "PRICE",
                "AVGPRICE",
                "TIMESTAMP"
              ],
              "default": "REALIZEDPNL"
            },
            "description": "The sort criteria"
          },
          {
            "in": "query",
            "name": "sortDirection",
            "schema": {
              "type": "string",
              "enum": [
                "ASC",
                "DESC"
              ],
              "default": "DESC"
            },
            "description": "The sort direction"
          },
          {
            "in": "query",
            "name": "title",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "Filter by market title"
          },
          {
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            },
            "description": "The address of the user in question"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:f90e610db5a9e49baf904708f4c20aac79ce2f8b1cd24e7fba93121eb084108e"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/closed-positions?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_closed_positions"
      }
    },
    "/apis/v1/polymarket/holders": {
      "get": {
        "description": "Get top holders for one or more markets.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.00044 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_holders",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_MetaHolder"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get top holders for markets",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.00044,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "6eaa0bf5df0d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "edb2528f0a7f"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/holders",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_holders",
          "method": "ANY",
          "path": "/apis/v1/polymarket/holders"
        },
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 20,
              "minimum": 0,
              "maximum": 20
            },
            "description": "Maximum number of holders to return per token. Capped at 20."
          },
          {
            "in": "query",
            "name": "market",
            "required": true,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "0x-prefixed 64-hex string",
                "pattern": "^0x[a-fA-F0-9]{64}$",
                "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
              }
            },
            "description": "Comma-separated list of condition IDs."
          },
          {
            "in": "query",
            "name": "minBalance",
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 0,
              "maximum": 999999
            }
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:7aedcdea6daee98f92928da7abd597b5b8a9fe47daa48f7c10c0094d4336a262"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_holders"
      }
    },
    "/apis/v1/polymarket/live-volume": {
      "get": {
        "description": "Get live volume for an event.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.00044 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_live_volume",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_LiveVolume"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get live volume for an event",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.00044,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "6eaa0bf5df0d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "2a8d85653ee1"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/live-volume",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_live_volume",
          "method": "ANY",
          "path": "/apis/v1/polymarket/live-volume"
        },
        "parameters": [
          {
            "in": "query",
            "name": "id",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:6d43cf56a505049ff38c371efab0ec33df319cdcfbc8e2a1a01ed92683cc1d01"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_live_volume"
      }
    },
    "/apis/v1/polymarket/oi": {
      "get": {
        "description": "Get open interest for one or more markets.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.00044 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_oi",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_OpenInterest"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get open interest",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.00044,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "6eaa0bf5df0d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "2ee5971e381a"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/oi",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_oi",
          "method": "ANY",
          "path": "/apis/v1/polymarket/oi"
        },
        "parameters": [
          {
            "in": "query",
            "name": "market",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "0x-prefixed 64-hex string",
                "pattern": "^0x[a-fA-F0-9]{64}$",
                "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
              }
            }
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:07082c28f74fc2fbd817d5dedde875aa3a04e99a4a5ce2c41539d4fe4a344403"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_oi"
      }
    },
    "/apis/v1/polymarket/positions": {
      "get": {
        "description": "Returns current positions for a user.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_positions",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_Position"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get current positions for a user",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "16074065cbdd"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/positions",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_positions",
          "method": "ANY",
          "path": "/apis/v1/polymarket/positions"
        },
        "parameters": [
          {
            "in": "query",
            "name": "eventId",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 1
              }
            },
            "description": "Comma-separated list of event IDs. Mutually exclusive with market."
          },
          {
            "in": "query",
            "name": "includeArchived",
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Include positions in archived markets that are still active. Archived positions are excluded by default."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 100,
              "minimum": 0,
              "maximum": 500
            }
          },
          {
            "in": "query",
            "name": "market",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "0x-prefixed 64-hex string",
                "pattern": "^0x[a-fA-F0-9]{64}$",
                "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
              }
            },
            "description": "Comma-separated list of condition IDs. Mutually exclusive with eventId."
          },
          {
            "in": "query",
            "name": "mergeable",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 10000
            }
          },
          {
            "in": "query",
            "name": "redeemable",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "in": "query",
            "name": "sizeThreshold",
            "schema": {
              "type": "number",
              "default": 1.0,
              "minimum": 0
            }
          },
          {
            "in": "query",
            "name": "sortBy",
            "schema": {
              "type": "string",
              "enum": [
                "CURRENT",
                "INITIAL",
                "TOKENS",
                "CASHPNL",
                "PERCENTPNL",
                "TITLE",
                "RESOLVING",
                "PRICE",
                "AVGPRICE"
              ],
              "default": "TOKENS"
            }
          },
          {
            "in": "query",
            "name": "sortDirection",
            "schema": {
              "type": "string",
              "enum": [
                "ASC",
                "DESC"
              ],
              "default": "DESC"
            }
          },
          {
            "in": "query",
            "name": "title",
            "schema": {
              "type": "string",
              "maxLength": 100
            }
          },
          {
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            },
            "description": "User address (required)"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:fbcecd86323bdd5c6b9e15e49f507331ed94f607f14ccb9128c1f64dc1c89572"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/positions?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_positions"
      }
    },
    "/apis/v1/polymarket/traded": {
      "get": {
        "description": "Returns the total number of markets a user has traded.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_traded",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response65D835437A58_Traded"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get total markets a user has traded",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "719ff17bd068"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/traded",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_traded",
          "method": "ANY",
          "path": "/apis/v1/polymarket/traded"
        },
        "parameters": [
          {
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            }
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:79fe128dc4bd7aa59747d855909e1c7769cc4bd5795dc97ab48797f5f756dbbe"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/traded?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_traded"
      }
    },
    "/apis/v1/polymarket/v1/accounting/snapshot": {
      "get": {
        "description": "Downloads an accounting snapshot as a ZIP archive of CSV files.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_v1_account_dd2c9c",
        "responses": {
          "200": {
            "description": "ZIP file containing `positions.csv` and `equity.csv`.",
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Download an accounting snapshot (ZIP of CSVs)",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET",
            "POST",
            "PUT",
            "PATCH",
            "DELETE",
            "HEAD",
            "OPTIONS",
            "TRACE"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "dba292916004"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/v1/accounting/snapshot",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_v1_account_dd2c9c",
          "method": "ANY",
          "path": "/apis/v1/polymarket/v1/accounting/snapshot"
        },
        "parameters": [
          {
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            },
            "description": "User address (0x-prefixed)"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:398a9bf828063ec808eee908ec4da4499fcc2936a5a8c996c6d8fddf503c2abc"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/v1/accounting/snapshot?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_v1_account_dd2c9c"
      }
    },
    "/apis/v1/polymarket/v1/builders/leaderboard": {
      "get": {
        "description": "Returns aggregated builder leaderboard rankings.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_v1_builder_e3d670",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_LeaderboardEntry"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get aggregated builder leaderboard",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "2f7ea0db82bb"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/v1/builders/leaderboard",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_v1_builder_e3d670",
          "method": "ANY",
          "path": "/apis/v1/polymarket/v1/builders/leaderboard"
        },
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 25,
              "minimum": 0,
              "maximum": 50
            },
            "description": "Maximum number of builders to return"
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 1000
            },
            "description": "Starting index for pagination"
          },
          {
            "in": "query",
            "name": "timePeriod",
            "schema": {
              "type": "string",
              "enum": [
                "DAY",
                "WEEK",
                "MONTH",
                "ALL"
              ],
              "default": "DAY"
            },
            "description": "The time period to aggregate results over.\n"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:17bf0348bbadf0119dce923080d28e486499c77f16ab346d5c9c5b974ad06954"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_v1_builder_e3d670"
      }
    },
    "/apis/v1/polymarket/v1/builders/volume": {
      "get": {
        "description": "Returns daily builder volume time-series data.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_v1_builder_c3f154",
        "responses": {
          "200": {
            "description": "Success - Returns array of daily volume records",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_BuilderVolumeEntry"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get daily builder volume time-series",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "c715afc7c4da"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/v1/builders/volume",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_v1_builder_c3f154",
          "method": "ANY",
          "path": "/apis/v1/polymarket/v1/builders/volume"
        },
        "parameters": [
          {
            "in": "query",
            "name": "timePeriod",
            "schema": {
              "type": "string",
              "enum": [
                "DAY",
                "WEEK",
                "MONTH",
                "ALL"
              ],
              "default": "DAY"
            },
            "description": "The time period to fetch daily records for.\n"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:a5a5a86c65418eac55efae7f11235b2921e3af0afebbe1798259d3c053d1cf46"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_v1_builder_c3f154"
      }
    },
    "/apis/v1/polymarket/v1/leaderboard": {
      "get": {
        "description": "Returns trader leaderboard rankings for a selected category and time period.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_v1_leaderboard",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_TraderLeaderboardEntry"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get trader leaderboard rankings",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "76a52811a497"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/v1/leaderboard",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_v1_leaderboard",
          "method": "ANY",
          "path": "/apis/v1/polymarket/v1/leaderboard"
        },
        "parameters": [
          {
            "in": "query",
            "name": "category",
            "schema": {
              "type": "string",
              "enum": [
                "OVERALL",
                "POLITICS",
                "SPORTS",
                "ESPORTS",
                "CRYPTO",
                "CULTURE",
                "MENTIONS",
                "WEATHER",
                "ECONOMICS",
                "TECH",
                "FINANCE"
              ],
              "default": "OVERALL"
            },
            "description": "Market category for the leaderboard"
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 25,
              "minimum": 1,
              "maximum": 50
            },
            "description": "Max number of leaderboard traders to return"
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 1000
            },
            "description": "Starting index for pagination"
          },
          {
            "in": "query",
            "name": "orderBy",
            "schema": {
              "type": "string",
              "enum": [
                "PNL",
                "VOL"
              ],
              "default": "PNL"
            },
            "description": "Leaderboard ordering criteria"
          },
          {
            "in": "query",
            "name": "timePeriod",
            "schema": {
              "type": "string",
              "enum": [
                "DAY",
                "WEEK",
                "MONTH",
                "ALL"
              ],
              "default": "DAY"
            },
            "description": "Time period for leaderboard results"
          },
          {
            "in": "query",
            "name": "user",
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            },
            "description": "Limit leaderboard to a single user by address"
          },
          {
            "in": "query",
            "name": "userName",
            "schema": {
              "type": "string"
            },
            "description": "Limit leaderboard to a single username"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:cbade5189ebcf8d48b276ec344ee783297f5cd9d406b8d8b635b560595a6db70"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_v1_leaderboard"
      }
    },
    "/apis/v1/polymarket/v1/market-positions": {
      "get": {
        "description": "Returns positions for a market, optionally filtered to a single user.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_v1_market__d8f158",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_MetaMarketPositionV1"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get positions for a market",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "316cc59f9053"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/v1/market-positions",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_v1_market__d8f158",
          "method": "ANY",
          "path": "/apis/v1/polymarket/v1/market-positions"
        },
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 50,
              "minimum": 0,
              "maximum": 500
            },
            "description": "Max number of positions to return per outcome token"
          },
          {
            "in": "query",
            "name": "market",
            "required": true,
            "schema": {
              "type": "string",
              "description": "0x-prefixed 64-hex string",
              "pattern": "^0x[a-fA-F0-9]{64}$",
              "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
            },
            "description": "The condition ID of the market to query positions for"
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 10000
            },
            "description": "Pagination offset per outcome token"
          },
          {
            "in": "query",
            "name": "sortBy",
            "schema": {
              "type": "string",
              "enum": [
                "TOKENS",
                "CASH_PNL",
                "REALIZED_PNL",
                "TOTAL_PNL"
              ],
              "default": "TOTAL_PNL"
            },
            "description": "Sort positions by:\n- `TOKENS` — Position size (number of tokens)\n- `CASH_PNL` — Unrealized cash PnL\n- `REALIZED_PNL` — Realized PnL\n- `TOTAL_PNL` — Total PnL (cash_pnl + realized_pnl)\n"
          },
          {
            "in": "query",
            "name": "sortDirection",
            "schema": {
              "type": "string",
              "enum": [
                "ASC",
                "DESC"
              ],
              "default": "DESC"
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "type": "string",
              "enum": [
                "OPEN",
                "CLOSED",
                "ALL"
              ],
              "default": "ALL"
            },
            "description": "Filter positions by status.\n- `OPEN` — Only positions with size > 0.01\n- `CLOSED` — Only positions with size <= 0.01\n- `ALL` — All positions regardless of size\n"
          },
          {
            "in": "query",
            "name": "user",
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            },
            "description": "Filter to a single user by proxy wallet address"
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:d7e5ea4de11483b5104413f944d3d068369ee25d8ce4475be0a117a2b66d3a21"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/v1/market-positions?market=0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_v1_market__d8f158"
      }
    },
    "/apis/v1/polymarket/value": {
      "get": {
        "description": "Returns the total value of a user's positions.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->",
        "operationId": "any_polymarket_data_apis_v1_polymarket_value",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Response65D835437A58_Value"
                  }
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get total value of a user's positions",
        "tags": [
          "default"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": true,
          "mpp_methods": [
            "GET"
          ],
          "x402": false
        },
        "x-aisa-category": "9",
        "x-aisa-passthrough": true,
        "x-aisa-pricing": {
          "cost_contract": "fixed_success",
          "customer_pricing": "fixed_success",
          "default_request_estimate_usd": 0.012,
          "estimate_source": "profile_seed",
          "evidence_source": "request_snapshot"
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": true
        },
        "x-aisa-revision": {
          "customer_pricing_ref": "4ac6db68e88d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "a5aa229fee4a"
        },
        "x-aisa-status": "enabled",
        "x-aisa-upstream-path": "/value",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "polymarket-data",
        "x-aisa-runtime-operation": {
          "operation_id": "any_polymarket_data_apis_v1_polymarket_value",
          "method": "ANY",
          "path": "/apis/v1/polymarket/value"
        },
        "parameters": [
          {
            "in": "query",
            "name": "market",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "0x-prefixed 64-hex string",
                "pattern": "^0x[a-fA-F0-9]{64}$",
                "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
              }
            }
          },
          {
            "in": "query",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string",
              "description": "User Profile Address (0x-prefixed, 40 hex chars)",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            }
          }
        ],
        "x-aisa-source": {
          "kind": "provider_openapi",
          "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
          "fetched_at": "2026-09-29T15:09:49.813764+00:00",
          "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
          "converter": "scripts/import_upstream.py@1",
          "owner": "AIsa-team/docs",
          "refresh_policy": "automatic",
          "review_period_days": 30,
          "refresh_interval_hours": 24,
          "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "provider_openapi",
            "url": "https://docs.polymarket.com/api-spec/data-openapi.yaml",
            "fetched_at": "2026-09-29T15:09:49.813764+00:00",
            "content_hash": "sha256:ccf7169b646fe10a98f06abdf69bee2202036b9ee2d22940897f5077693fe946",
            "converter": "scripts/import_upstream.py@1",
            "owner": "AIsa-team/docs",
            "refresh_policy": "automatic",
            "review_period_days": 30,
            "refresh_interval_hours": 24,
            "policy_revision": "sha256:e0b6ada9e20c7417087f5cfdaee97897cfcf71ad64b81defc14e702efee833c7"
          },
          "content_hash": "sha256:645fde155f7e0b8ee4151fde139b8977644cbd6516f46c00758459d088fc4a29"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/polymarket/value?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/polymarket-data/any_polymarket_data_apis_v1_polymarket_value"
      }
    }
  }
}
