> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trading quickstart

> Quickstart for PlayFab player-to-player trading using OpenTrade, AcceptTrade, and related APIs to exchange inventory items between two players.

<Note>
  This quickstart assumes you are already familiar with both catalogs and inventory items. The example player must already own the inventory items they wish to trade away.
</Note>

The first step is to call the `OpenTrade` API, to make a trade available to another player. You will need a `playfabId` to identify the gift recipient, and the `ItemInstanceID` for the player who currently has the item in their Inventory.

`secondPlayerId`: This is the unique string that identifies the gift recipient (`PlayFabId`).

`myItemInstanceId`: This is the unique string that identifies an item instance owned by the current player (`InstanceID`).

```csharp theme={null}
void GiveItemTo(string secondPlayerId, string myItemInstanceId) {
    PlayFabClientAPI.OpenTrade(new OpenTradeRequest {
        AllowedPlayerIds = new List<string> { secondPlayerId }, // PlayFab ID for the friend who will receive your gift
        OfferedInventoryInstanceIds = new List<string> { myItemInstanceId } // The item instanceId fetched from GetUserInventory()
    }, LogSuccess, LogFailure);
}
```

<Note>
  All trades are public information. Any player may look at the open trades of another player, as well as another player's trade history (If they know the `playFabId` of that player).
</Note>

In this snip the `LogSuccess` callback must also evaluate `result.Trade.TradeId`, and transfer both `firstPlayFabId` and the `tradeId` to the second player. If not saved, it will not be possible for the second player to evaluate or accept the trade.

<Note>
  In the current preview you need to ensure that your trades are thread-safe from concurrent actions. Thread-safe options include custom game servers and Webhook calls via CloudScript to an external database/system. Thread-Unsafe options can be built with CloudScript which directly modifies a Player Data Key. The latter option has concurrency issues where simultaneous trade-list-updates may not process correctly.
</Note>

Once the first player has created the trade, and transferred their `playFabId` and the `tradeId` to the second player, the second player can examine the trade requirements (verifying it is a gift) by making a `GetTradeStatus` request.

<Note>
  The most relevant **TradeStatus** values are **Open**, **Filled**, and **Canceled**. All other states are intermediate states. Trades may stay in those intermediate states for a noticeable period of time between calls. A recently-modified trade may not be available immediately.
</Note>

```csharp theme={null}
void ExamineTrade(string firstPlayFabId, string tradeId) {
    PlayFabClientAPI.GetTradeStatus(new GetTradeStatusRequest {
        OfferingPlayerId = firstPlayFabId,
        TradeId = tradeId
    }, LogSuccess, LogFailure);
}

If the requirements of that trade are acceptable, the gift can be accepted using AcceptTrade
C# snip
void AcceptGiftFrom(string firstPlayFabId, string tradeId) {
    PlayFabClientAPI.AcceptTrade(new AcceptTradeRequest {
        OfferingPlayerId = firstPlayFabId,
        TradeId = tradeId
    }, LogSuccess, LogFailure);
}
```

Once complete, the `AcceptGiftFrom` function above will transfer the gifted items from the first player's inventory to the second.


## Related topics

- [Trading](/services/playfab/economy-monetization/economy/trading/index.md)
- [Quickstart](/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Quickstart C++ for Linux](/services/playfab/sdks/playfab-cpp/quickstart-linux.md)
- [Matchmaking quickstart](/services/playfab/multiplayer/matchmaking/quickstart.md)
- [Photon Quickstart](/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)