Transacting
Buying an NFT that is listed across marketplaces
The createBuyTx api will try to create a buy buffer tx for an NFT that is listed on a marketplace that Hyperspace supports / aggregates.
For items that are listed on the Hyperspace contract, we introduce the concept of buyer broker fees. If an item is listed on the hyperspace contract but not through your platform, you can still show the item on your platform and collect a fee on the buyers who buy the item on your platform (basically incentivizing your platform for sourcing / discovery). It is on you to surface these fees to the user.
Buyer Broker Fee Example:
  • User A lists a degod on the hyperspace contract on platform A for 200 SOL.
    • Platform A charges a .5% seller fee (in addition to the Hyperspace .5% platform fee).
    • User A will have to pay a 1% fee if the degod sells.
  • Platform B can show this listed degods for 202 SOL and set a buyer broker fee for 1% that is paid for the buyer.
    • User B pays 202 SOL
    • Platform B captures 2 SOL at 1% buyer broker fee.
    • Platform A captures .5 SOL at .50% and Hyperspace captures .5 SOL at .50% for a total of 1 SOL
    • User A receives 199 SOL
Function: createBuyTx
Inputs:
  • [Required] buyerAddress
    • Type: string
    • Description: The address of the buyer of the NFT
  • [Required] price
    • Type: number
    • Description: The sol price of the NFT listed
  • [Required] tokenAddress
    • Type: string
    • Description: The token address of the NFT
  • [Required] buyerBroker
    • Type: string
    • Description: The wallet address of the buyer broker
    • Please use the treasury wallet address you provided to us in the API form, so we can identify that the call is coming from your platform. If your treasury wallet has changed reach out to us to let us know.
  • [Optional] buyerBrokerBasisPoints
    • Type: number
    • Description: The fee charged to the buyer
  • [Optional] unverified
    • Type: boolean
    • Description: Flag to try to create a buy tx for a token that is not indexed by Hyperspace
Response:
GetBuyTxQuery
​
Copy link