# Create Combo

<EndpointPage
  breadcrumbs={[
    { label: "REST APIs", href: "/rest-api/rest-api" },
    { label: "Prediction Markets", href: "/rest-api/rest-api#prediction-markets" },
    { label: "Combos", href: "/rest-api/prediction-markets/combos" },
    { label: "Create Combo" },
  ]}
  title="Create Combo"
  method="POST"
  url="https://api.gemini.com/v1/prediction-markets/combos"
  description="Create a canonical two-to-six-leg Prediction Markets combo, or retrieve the same combo when its complete leg set already exists."
  note={{
    title: "Production availability",
    children: <p style={{ margin: 0 }}>This Combo Prediction Markets endpoint is not currently enabled in production.</p>
  }}
  example={{
    request: {
      method: "POST",
      url: "https://api.gemini.com/v1/prediction-markets/combos",
      headers: [
        { name: "X-GEMINI-APIKEY", value: "<string>" },
        { name: "X-GEMINI-PAYLOAD", value: "<string>" },
        { name: "X-GEMINI-SIGNATURE", value: "<string>" },
      ],
      body: {
        legs: [
          { contractId: "101", requiredOutcome: "Yes" },
          { contractId: "202", requiredOutcome: "No" },
        ],
      },
    },
  }}
  sections={[
    {
      heading: "Access",
      children: (
        <p style={{ margin: 0 }}>This endpoint requires signed private REST authentication, the <code>PredictionsNewOrder</code> permission, and an unrestricted trading account. The account is derived from the authenticated API key; do not include an account ID in the request.</p>
      ),
    },
    {
      heading: "Canonicalization",
      children: (
        <p style={{ margin: 0 }}>The complete set of legs defines a combo. Reordering the same legs does not create another combo: a new canonical combo returns <code>201</code> with <code>alreadyExisted: false</code>, while an existing one returns <code>200</code> with <code>alreadyExisted: true</code>.</p>
      ),
    },
    {
      heading: "Headers",
      children: <PMSpecHeaders />,
    },
    {
      heading: "Request Body",
      children: <PMSpecParams operationId="createCombo" />,
    },
    {
      heading: "Responses",
      children: <PMSpecResponses operationId="createCombo" />,
    },
  ]}
/>

<PageNavigation
  prev={{ label: "Get Combo", href: "/rest-api/prediction-markets/combos/get-combo" }}
/>