Input Schema
{
"bodyFields": {
"action": {
"description": "Trade direction: 'long' (bullish/buy) or 'short' (bearish/sell)",
"enum": [
"long",
"short"
],
"example": "long",
"required": true,
"type": "string"
},
"collateralAmount": {
"description": "Collateral amount in USDC (this is also the payment amount). Min: 5 USDC, Max: 10000 USDC",
"example": 100,
"maximum": 10000,
"minimum": 5,
"required": true,
"type": "number"
},
"leverage": {
"description": "Leverage multiplier for the position (e.g., 10 for 10x leverage). Range: 1.1 to 200x",
"example": 10,
"maximum": 200,
"minimum": 1.1,
"required": true,
"type": "number"
},
"stopLossPercentage": {
"description": "Optional: Stop loss as percentage from entry (e.g., 5 for 5%). Alternative to stopLossPrice",
"example": 5,
"maximum": 100,
"minimum": 0.1,
"required": false,
"type": "number"
},
"stopLossPrice": {
"description": "Optional: Absolute stop loss price (e.g., 50000 for BTC at $50k). Mutually exclusive with stopLossPercentage",
"example": 50000,
"required": false,
"type": "number"
},
"symbol": {
"description": "Trading pair symbol (e.g., 'BTC', 'ETH', 'SOL', 'DOGE', 'PEPE')",
"example": "BTC",
"required": true,
"type": "string"
},
"takeProfitPercentage": {
"description": "Optional: Take profit as percentage from entry (e.g., 10 for 10%). Alternative to takeProfitPrice",
"example": 20,
"maximum": 1000,
"minimum": 0.1,
"required": false,
"type": "number"
},
"takeProfitPrice": {
"description": "Optional: Absolute take profit price (e.g., 70000 for BTC at $70k). Mutually exclusive with takeProfitPercentage",
"example": 70000,
"required": false,
"type": "number"
},
"tradeOptions": {
"description": "Optional: Advanced trading options for protocol and chain selection",
"properties": {
"chainId": {
"description": "Preferred chain ID (e.g., 8453 for Base, 42161 for Arbitrum)",
"example": 8453,
"type": "number"
},
"protocol": {
"description": "Preferred DEX protocol (e.g., 'hyperliquid', 'gmx', 'gains network')",
"example": "hyperliquid",
"type": "string"
}
},
"required": false,
"type": "object"
},
"walletAddress": {
"description": "Your EVM wallet address (EOA) - it is REQUIRED that this is the same wallet address as the one you are paying from. Otherwise the trade will fail.",
"pattern": "^0x[a-fA-F0-9]{40}$",
"required": true,
"type": "string"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
}
Output Schema
{
"properties": {
"amount": {
"description": "Collateral amount in USDC",
"type": "number"
},
"direction": {
"description": "Trade direction (long/short)",
"type": "string"
},
"dstChainId": {
"description": "Destination chain ID",
"type": "number"
},
"executeExplorerUrl": {
"description": "Explorer URL for the execute transaction",
"type": "string"
},
"executeTxHash": {
"description": "Transaction hash for the execute transaction",
"type": "string"
},
"leverage": {
"description": "Leverage multiplier used",
"type": "number"
},
"positionId": {
"description": "Unique identifier for the opened position (calculated from protocolPositionHash + symphonyPositionHash)",
"type": "string"
},
"srcChainId": {
"description": "Source chain ID",
"type": "number"
},
"submitExplorerUrl": {
"description": "Explorer URL for the submit transaction",
"type": "string"
},
"submitTxHash": {
"description": "Transaction hash for the submit transaction",
"type": "string"
},
"success": {
"description": "Whether the trade was opened successfully",
"type": "boolean"
},
"symbol": {
"description": "Trading pair symbol",
"type": "string"
},
"timestamp": {
"description": "ISO timestamp of when position was opened",
"type": "string"
}
},
"type": "object"
}