"type: docs"

docs/reference/buy.md

@@ -0,0 +1,50 @@
+---
+title: Buy NFT with Rarible Protocol
+description: How to buy NFT using Rarible Multichain Protocol
+---
+
+# Prerequisites
+
+To buy NFT with Rarible Protocol you should have order id for NFT you are interested in - you can get order id with [Rarible API](search-capabilities.md)
+
+You can buy NFTs with Rarible Multichain Protocol on different blockchains.
+
+--8<-- "docs/snippets/preparation-sdk.md"
+
+# Buy an NFT
+
+You can buy any NFTfor which sell order is created
+
+Use `buy` function:
+
+```typescript
+import { createRaribleSdk } from "@rarible/sdk"
+import { toOrderId} from "@rarible/types"
+
+async function buyNft(orderId: string) {
+ const sdk = createRaribleSdk(wallet, "dev")
+
+ // Get order info
+ const buy = await sdk.order.buy({
+ toOrderId(orderId),
+ })
+ // buy: {
+ // baseFee: number
+ // maxAmount: BigNumber
+ // multiple: boolean
+ // submit: Function
+ // supportsPartialFill: boolean
+ // } 
+
+ // Send transaction
+ const result = await buy.submit(
+ amount: 1, //amount of NFTs you want to buy
+ )
+ // result: IBlockchainTransaction
+}
+```
+
+* `orderId` — Id of NFT sale order, has format `${blockchain}:${orderId}`. For example, `ETHEREUM:0x19f487016770542dc6137b06499a4f7b42c9580f12d85d6347964b03b7682143`
+* `amount` — amount of NFT tokens you want to buy
+
+See more information about usage Protocol SDK on [https://github.com/rarible/sdk](https://github.com/rarible/sdk)

mkdocs.yml

@@ -133,6 +133,7 @@ nav:
  - "Mint": "reference/mint.md"
  - "Sell Order": "reference/order.md"
  - "Mint and Sell": "reference/mint-and-sell.md"
+ - "Buy NFT": "reference/buy.md"
  - "Create and Accept Bid": "reference/bid.md"
  - "Transfer": "reference/transfer.md"
  - "Burn": "reference/burn.md"