# Auctions

**URL:** https://heroiclabs.com/docs/hiro/python/auctions/
**Summary:** Auctions allow players to bid and purchase in-game items from other players in your game
**Keywords:** auctions, marketplace
**Categories:** hiro, python, auctions

---


# Auctions

_Auctions enable players to interact within a player-driven economy by bidding on or directly purchasing items._ Learn more in the [Auctions concept guide](../../concepts/auctions/_index.md).

## Overview

Auctions provide a dynamic system for players to trade items by:

- Allowing players to list items for auction.
- Facilitating competitive bidding processes.
- Managing transactions securely and transparently.

## Prerequisites

- Unity project set up with Hiro SDK
- Nakama System integrated ([guide](../getting-started/_index.md))

## Working with Auctions

### Creating an Auction

Create a new auctions for players:

```py
request = AuctionCreateRequest()
request.template_id = "template_auction_001"
request.condition_id = "condition_001"

auction = await hiro_client.auctions_create(request)
```

### Placing a Bid on an Auction

Submit a bid on an active auction:

```py
request = AuctionBidRequest()
request.id = "auction_instance_123"
request.version = "1.0"
request.instanceIds = {
    "gold": "1000"
}

auctions = await hiro_client.auctions_bid(request)
```

### Cancelling an Auction

Cancel an ongoing action:

```py
request = AuctionCancelRequest()
request.id = "auction_instance_123"

auctions = await hiro_client.auctions_cancel(request)
```

### Claiming a Winning Bid

Claim the item the player won:

```py
request = AuctionClaimBidRequest()
request.id = "auction_instance_123"

auctions = await hiro_client.auctions_claim_bid(request)
```

### List Available Auctions

View current active auctions:

```py
request = AuctionListRequest()

auctions = await hiro_client.auctions_list(request)
```