# placeBid

## Description

The `placeBid` function is used to place a bid on an NFT (non-fungible token) in a specific blockchain network's marketplace. It takes the required parameters and connects to the blockchain using the provided private key to interact with the smart contract.

## Parameters

| Parameter    | Type   | Description                                                       |
| ------------ | ------ | ----------------------------------------------------------------- |
| `blockchain` | string | The blockchain network where the NFT marketplace contract resides |
| `privateKey` | string | The private key of the user's wallet to connect to the blockchain |
| `tokenId`    | string | The unique identifier of the NFT in the marketplace               |
| `payment`    | string | The amount of cryptocurrency to bid for the NFT                   |
| `nftAddress` | string | The address of the NFT contract on the blockchain                 |

## Response

| Field     | Type   | Description                             |
| --------- | ------ | --------------------------------------- |
| `code`    | number | The status code of the transaction      |
| `receipt` | object | The transaction receipt object returned |

## Example Request and Response

### Prerequisites

Before making requests with NO.AI SDK, you must have it installed.

You can install NO.AI SDK using either **`npm`** or **`yarn`**. Use the following commands to install NO.AI SDK:

```jsx
npm install @nest25/evm-chains-lib
OR
yarn add @nest25/evm-chains-lib
```

### Request

Here is an example of how to make a `placeNFT` request using the NO.AI SDK:

```jsx

const {NftMarketPlace} = require('@nest25/evm-chains-lib')
// create instance of SOULBOUND
const nftMarketPlace = new NftMarketPlace();
const privateKey = "your private key here"

const main = async () => {
    // place bid
    const bidder = await nftMarketPlace.placeBid(
        'klay',
        privateKey,
        1,
        10,
    );
    // print result
    console.log(bidder);
}
main()
```

### Response

```jsx
```

## Use Cases

* **Crypto wallets:** The function can be used by crypto wallets to enable users to place bids on NFTs available in various blockchain networks.
* **NFT Marketplaces:** The function can be used by online NFT marketplaces to facilitate the bidding process for buyers and sellers.
* **Cryptocurrency Exchanges:** The function can be used by cryptocurrency exchanges to enable users to place bids on NFTs using their exchange wallets.

<br>