---
title: "RewardsAuctions returns all rewards auctions that correspond to the given pool id"
method: GET
path: "/crescent/liquidfarming/v1beta1/liquidfarms/{pool_id}/rewards_auctions"
tags: ["Query"]
---

# RewardsAuctions returns all rewards auctions that correspond to the given pool id

`GET /crescent/liquidfarming/v1beta1/liquidfarms/{pool_id}/rewards_auctions`

## 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/liquidfarming/v1beta1/liquidfarms/:pool_id/rewards_auctions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `pool_id` string, uint64, required

## Query parameters

- `status` 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: QueryRewardsAuctionsResponse is response type for the Query/RewardsAuctions RPC method.
  - `rewards_auctions` object[]
    - `id` string, uint64
    - `pool_id` string, uint64
    - `bidding_coin_denom` string
    - `paying_reserve_address` string
    - `start_time` string, date-time
    - `end_time` string, date-time
    - `status` 'AUCTION_STATUS_UNSPECIFIED' | 'AUCTION_STATUS_STARTED' | 'AUCTION_STATUS_FINISHED' | 'AUCTION_STATUS_SKIPPED': AuctionStatus enumerates the valid status of an auction. - AUCTION_STATUS_UNSPECIFIED: AUCTION_STATUS_UNSPECIFIED defines the default auction status - AUCTION_STATUS_STARTED: AUCTION_STATUS_STARTED defines the started auction status - AUCTION_STATUS_FINISHED: AUCTION_STATUS_FINISHED defines the finished auction status - AUCTION_STATUS_SKIPPED: AUCTION_STATUS_SKIPPED defines the skipped auction status
    - `winner` string
    - `winning_amount` object: Coin defines a token with a denomination and an amount. NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
      - `denom` string
      - `amount` string
    - `rewards` object[]
      - `denom` string
      - `amount` string
    - `fees` object[]
      - `denom` string
      - `amount` string
    - `fee_rate` 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** `65d4119fbf62`: 1 info
  - api operation id `LiquidFarmingRewardsAuctions` removed and replaced with `RewardsAuctions`
- **2023-08-07** `ba378738465c`: 1 info
  - api operation id `LiquidFarmingRewardsAuctions` removed and replaced with `RewardsAuctions`
- **2023-08-01** `be97fd4636c3`: 1 info
  - api operation id `LiquidFarmingRewardsAuctions` removed and replaced with `RewardsAuctions`
- **2023-08-01** `18b759dcb55b`: 1 info
  - endpoint added
- **2023-01-02** `7a6aea176d46`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/changes/crescent/liquidfarming/v1beta1/liquidfarms/:pool_id/rewards_auctions/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)