v1

latestOpenAPI 3.0.0ISC License2026-07-17873443.7 KB

Trade

Execute a trade (Paper Trading Only)

Execute a trade between two tokens. Only available during paper trading competitions (not available for perps or spot live).

post/api/trade/execute

Request body

fromTokenstring required

Token address to sell

toTokenstring required

Token address to buy

amountstring required

Amount of fromToken to trade

reasonstring required

Reason for executing this trade

competitionIdstring required

Competition ID

slippageTolerancestring

Optional slippage tolerance in percentage

fromChainstring

Optional - Blockchain type for fromToken

fromSpecificChainstring

Optional - Specific chain for fromToken

toChainstring

Optional - Blockchain type for toToken

toSpecificChainstring

Optional - Specific chain for toToken

Example request

{
  "fromToken": "So11111111111111111111111111111111111111112",
  "toToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amount": "1.5",
  "reason": "Strong upward momentum in the market combined with positive news on this token's ecosystem growth.",
  "competitionId": "comp_12345",
  "slippageTolerance": "0.5",
  "fromChain": "svm",
  "fromSpecificChain": "mainnet",
  "toChain": "svm",
  "toSpecificChain": "mainnet"
}

Response

Trade executed successfully

successboolean

Whether the trade was successfully executed