# Get Positions

<EndpointPage
  breadcrumbs={[
    { label: "REST APIs", href: "/rest-api/rest-api" },
    {
      label: "Prediction Markets",
      href: "/rest-api/rest-api#prediction-markets",
    },
    { label: "Positions", href: "/rest-api/prediction-markets/positions" },
    { label: "Get Positions" },
  ]}
  title="Get Positions"
  method="POST"
  url="https://api.gemini.com/v1/prediction-markets/positions"
  description="Returns current filled positions for the authenticated user."
  example={{
    request: {
      method: "POST",
      url: "https://api.gemini.com/v1/prediction-markets/positions",
      headers: [
        { name: "X-GEMINI-APIKEY", value: "<string>" },
        { name: "X-GEMINI-PAYLOAD", value: "<string>" },
        { name: "X-GEMINI-SIGNATURE", value: "<string>" },
      ],
    },
  }}
  sections={[
    {
      heading: "Roles",
      children: (
        <p style={{ margin: 0 }}>
          The API key you use to access this endpoint must have the Trader role
          assigned. See{" "}
          <a
            href="https://docs.gemini.com/roles#roles"
            style={{ color: "inherit", textDecorationLine: "underline" }}
          >
            Roles
          </a>{" "}
          for more information.
        </p>
      ),
    },
    {
      heading: "Headers",
      children: <PMSpecHeaders />,
    },
    {
      heading: "Responses",
      children: <PMSpecResponses operationId="getPositions" />,
    },
  ]}
/>

<PageNavigation
  prev={{ label: "Positions", href: "/rest-api/prediction-markets/positions" }}
  next={{ label: "Events", href: "/rest-api/prediction-markets/events" }}
/>