placeBid

This action is used to place a bid or multiple bids on an ERC-1155 or ERC-721 token. You can also use this action to bid on multiple exchanges/marketplaces.

You can supply an object of parameters listed below:

ParameterDescriptionRequiredExample
bidsAn array of objects representing bids, mapping directly to the params property from the execute bid api. See API for options besides token bids.true[{ weiPrice: 10000000000000000, orderbook: 'reservoir', orderKind: 'seaport-v1.5', token: "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d:0" }]
walletA valid WalletClient from viem or a ReservoirWallet generated from an adapter. Learn more about adapters.trueRefer to viem's documentation on WalletClients_
onProgressCallback to update UI state as execution progresses. Can also be used to get the transaction hash for a given step item.true(steps) => { console.log(steps) }
chainIdOverride the current active chainfalse1

Example

import { getClient, Execute } from "@reservoir0x/reservoir-sdk";
import { createWalletClient, http } from 'viem'

...

address = "0x8ba1f109551bD432803012645Ac136ddd6000000"
wallet = createWalletClient({
  account: address,
  transport: http()
})

getClient()?.actions.placeBid({
  bids: [{  
      weiPrice: 10000000000000000,  
      orderbook: 'reservoir',  
      orderKind: 'seaport-v1.5',  
      token: "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d:0",
   		expirationTime: "1775066025"
  }],
  wallet,
  onProgress: (steps: Execute['steps']) => {
    console.log(steps)
  }
})