---
title: "GET /crescent/amm/v1beta1/positions"
method: GET
path: "/crescent/amm/v1beta1/positions"
tags: ["Query"]
---

# GET /crescent/amm/v1beta1/positions

`GET /crescent/amm/v1beta1/positions`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/docs/crescent/amm/v1beta1/positions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `pool_id` string, uint64
- `owner` string
- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- object
  - `positions` object[]
    - `id` string, uint64
    - `pool_id` string, uint64
    - `owner` string
    - `lower_price` string
    - `upper_price` string
    - `liquidity` string
    - `last_fee_growth_inside` object[]
      - `denom` string
      - `amount` string
    - `owed_fee` object[]
      - `denom` string
      - `amount` string
    - `last_farming_rewards_growth_inside` object[]
      - `denom` string
      - `amount` string
    - `owed_farming_rewards` object[]
      - `denom` string
      - `amount` string
  - `pagination` object: PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response

## Changes

- **2023-09-11** `0cb495f8c604`: 2 info
  - added the new optional `query` request parameter `owner`
  - added the new optional `query` request parameter `pool_id`
- **2023-09-11** `67493d042fce`: 1 info
  - endpoint added
- **2023-09-11** `65d4119fbf62`: 1 breaking
  - api path removed without deprecation
- **2023-07-10** `2c5e8a5ae418`: 2 info
  - added the new optional `query` request parameter `owner`
  - added the new optional `query` request parameter `pool_id`
- **2023-06-22** `445be7f5fce0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/changes/crescent/amm/v1beta1/positions/get.md)

---

[API](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/revisions/ddf5133cea9d?raw)