Creating trades

Creating trades

Creating a trade is also known as filling an order, or buying an asset. A user executes a trade by agreeing to purchase an asset at the terms specified in the order and then becomes the new owner of the asset.

📝GUIDES

• Core SDK

• Link SDK

Core SDK​

1. Initialize the Core SDK​

In order to use the Core SDK, you need to initialize it.

2. Generate signers​

Creating a trade for a user requires a user's signature, so your application will need to create signers. See the guide on how to generate signers.

3. Create the trade​

WHEN SETTING TAKER FEES IN THE TRADE PARAMS

• You cannot set more than 3 recipients

• You cannot set the same recipient more than once

• The combined fee percentage can’t exceed 100%

• Individual percentage fees can’t be <= 0%

• Typescript Core SDK

📚SDK REFERENCE

• createTrade

Creating a trade for the order with ID 7232:

const createTrade = async (wallet: WalletConnection, orderId: number) => {
  const ethAddress = await wallet.ethSigner.getAddress();
  const tradeData = {
    order_id: orderId,
    user: ethAddress
  } as GetSignableTradeRequest;

  const response = await client.createTrade(wallet, tradeData);
  return response;
}

createTrade(wallet, 7232)
  .then((result) => {
    console.log(result)
  })
  .catch((e) => {
    console.log(e)
  })

Example response:​

{ 
  trade_id: 226892, // ID of trade within XpansionChain 
  status: '' // Current status of trade
}

• Kotlin (JVM) Core SDK

📚SDK REFERENCE

• buy

• Swift Core SDK

📚SDK REFERENCE

• createTrade

• Golang Core SDK

📚SDK REFERENCE

• CreateTrade

💻EXAMPLE

• CreateTrade