{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "beta-vaultlayer-xyz-api-x402-reports-polymarket",
  "title": "VaultLayer \u00b7 Polymarket Prediction Market Data",
  "url": "https://beta.vaultlayer.xyz/api/x402/reports/polymarket",
  "category": "finance",
  "summary": "Fetch aggregated prediction market data from Polymarket including live odds, market liquidity, whale wallet activity, and recent trade flows.",
  "seo": {
    "title": "Polymarket Data API | Prediction Markets | x402 | VaultLayer",
    "description": "Access Polymarket prediction market data via x402 micropayments. Fetch active markets, real-time odds, liquidity metrics, whale activity, and user positions. Aggregated from Gamma API and subgraphs. Base network, 0.05 USDC."
  },
  "use_cases": [
    "Build automated trading strategies based on prediction market sentiment",
    "Create dashboards tracking political and event-based market movements",
    "Alert systems for significant whale position changes in key markets"
  ],
  "ideal_buyer": "Quantitative traders, prediction market analysts, and DeFi strategists requiring real-time Polymarket intelligence for automated decision-making.",
  "example_prompt": "Get the current odds and recent whale activity for the 2024 US presidential election winner market",
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "normal",
    "ratio": 1.667,
    "median_category_atomic": 30000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0x2190a1dba3e0a9f7216efc929e6faead44ad6131",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "50000",
      "max_timeout_seconds": 300,
      "mime_type": "application/json",
      "description": "Fetches prediction market data from Polymarket including active markets, odds, liquidity, whale activity, and user positions. Aggregates data from Polymarket's Gamma API and subgraphs.",
      "verified": false,
      "hints": {
        "input": {
          "type": "http",
          "method": "POST",
          "queryParams": {
            "limit": {
              "type": "Maximum number of markets to return (1-100). Default: 50."
            },
            "sort_by": {
              "type": "Sort field. Options: odds, liquidity, volume, id. Default: odds."
            },
            "category": {
              "type": "Comma-separated category filters (e.g., politics,crypto)."
            },
            "max_odds": {
              "type": "Maximum odds threshold (0-1). Filters markets where YES price \u2264 max_odds. Default: 0.25."
            },
            "market_id": {
              "type": "Fetch specific market by ID. When provided, returns market details and optionally recent trades."
            },
            "whale_limit": {
              "type": "Number of whale activities to return (1-50). Default: 10."
            },
            "trades_limit": {
              "type": "Number of recent trades to return when market_id is provided (1-100). Default: 20."
            },
            "min_liquidity": {
              "type": "Minimum liquidity in USD to filter markets. Default: 1000."
            },
            "include_recent_trades": {
              "type": "Include recent YES trades (requires market_id). Default: true."
            },
            "include_whale_activity": {
              "type": "Include whale redemption data in response. Default: true."
            }
          }
        },
        "output": {
          "type": "object",
          "required": [
            "status",
            "timestamp",
            "data",
            "meta"
          ],
          "properties": {
            "data": {
              "type": "object",
              "properties": {
                "markets": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "id",
                      "question",
                      "outcomePrices"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Market ID."
                      },
                      "volume": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Trading volume in USD."
                      },
                      "eventId": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Associated event ID."
                      },
                      "category": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Market category."
                      },
                      "question": {
                        "type": "string",
                        "description": "Market question/title."
                      },
                      "eventSlug": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Event URL slug."
                      },
                      "liquidity": {
                        "type": "string",
                        "description": "Total liquidity in USD."
                      },
                      "eventTitle": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Event title."
                      },
                      "outcomePrices": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Array of outcome prices [YES_price, NO_price] as strings."
                      }
                    }
                  },
                  "description": "List of prediction markets matching the query criteria."
                },
                "recent_trades": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "trader",
                      "amount",
                      "outcome",
                      "timestamp"
                    ],
                    "properties": {
                      "amount": {
                        "type": "string",
                        "description": "Trade amount (in smallest unit)."
                      },
                      "trader": {
                        "type": "string",
                        "description": "Wallet address of the trader."
                      },
                      "outcome": {
                        "type": "string",
                        "description": "Outcome index (0 for YES, 1 for NO)."
                      },
                      "timestamp": {
                        "type": "string",
                        "description": "Unix timestamp of the trade."
                      }
                    }
                  },
                  "description": "Recent YES trades for the specified market (when market_id is provided)."
                },
                "market_details": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "question": {
                      "type": "string"
                    },
                    "liquidity": {
                      "type": "string"
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "outcomePrices": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "description": "Detailed information about a specific market (when market_id is provided)."
                },
                "whale_activity": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "id",
                      "redeemer",
                      "amountRedeemed",
                      "market",
                      "timestamp"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Redemption transaction ID."
                      },
                      "market": {
                        "type": "object",
                        "required": [
                          "id",
                          "question"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Market condition ID."
                          },
                          "question": {
                            "type": "string",
                            "description": "Market question."
                          }
                        }
                      },
                      "redeemer": {
                        "type": "string",
                        "description": "Wallet address of the whale."
                      },
                      "timestamp": {
                        "type": "string",
                        "description": "Unix timestamp of redemption."
                      },
                      "amountRedeemed": {
                        "type": "string",
                        "description": "Payout amount (in smallest unit, typically wei)."
                      }
                    }
                  },
                  "description": "Large redemptions (payouts) on resolved markets."
                }
              },
              "description": "Market data, whale activity, recent trades, and market details."
            },
            "meta": {
              "type": "object",
              "description": "Echoed query params, source information, and total market count."
            },
            "status": {
              "type": "string",
              "description": "Request outcome indicator (success/error)."
            },
            "timestamp": {
              "type": "string",
              "format": "date-time",
              "description": "ISO timestamp for when the data was fetched."
            },
            "cache_info": {
              "type": "object",
              "description": "Edge and in-memory cache policies for default/custom queries.",
              "additionalProperties": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  ],
  "duplicate_cluster_id": "finance-cl-6ea1cd5585b5",
  "origin": {
    "slug": "beta-vaultlayer-xyz",
    "host": "beta.vaultlayer.xyz",
    "title": "VaultLayer Beta",
    "description": "Beta environment for VaultLayer. Currently unavailable due to SSL configuration error between Cloudflare and the origin server.",
    "url": "https://beta.vaultlayer.xyz",
    "favicon": "https://beta.vaultlayer.xyz/favicon.png"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/beta-vaultlayer-xyz-api-x402-reports-polymarket",
    "url": "https://x402all.com/resource/beta-vaultlayer-xyz-api-x402-reports-polymarket",
    "name": "VaultLayer \u00b7 Polymarket Prediction Market Data",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/beta-vaultlayer-xyz-api-x402-reports-polymarket",
      "@type": "Offer",
      "price": "0.05",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0.050000",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "paymentNetwork",
          "value": "base"
        },
        {
          "@type": "PropertyValue",
          "name": "paymentAsset",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    "sameAs": "https://beta.vaultlayer.xyz/api/x402/reports/polymarket",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/beta-vaultlayer-xyz",
      "url": "https://beta.vaultlayer.xyz",
      "name": "VaultLayer Beta",
      "@type": "Organization"
    },
    "identifier": "beta-vaultlayer-xyz-api-x402-reports-polymarket",
    "description": "Access Polymarket prediction market data via x402 micropayments. Fetch active markets, real-time odds, liquidity metrics, whale activity, and user positions. Aggregated from Gamma API and subgraphs. Base network, 0.05 USDC.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=beta-vaultlayer-xyz-api-x402-reports-polymarket",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=beta-vaultlayer-xyz-api-x402-reports-polymarket"
}