Skip to main content
POST
/
agent
/
batch-swap
{
    "agentId": "e8a54723-6485-41b9-91d7-7bdfd61ba621",
    "tokenIn": "MON",
    "tokenOut": "0x350035555e10d9afaf1566aaebfced5ba6c27777",
    "weight": 5,
    "intentOptions": {
        "desiredProtocol": "nadfun"
    }
}

{
    "message": "Swap submitted",
    "batchId": "63946153-9f33-4b7e-9b32-b99a4a6037e2",
    "successful": 1,
    "failed": 0,
    "results": [
        {
            "smartAccount": "0xbaf3de56e5815e9b2894a95d85b8023c3ac03e4e",
            "result": {
                "success": true,
                "executeTxHash": "0x8bbaa0300777ec...",
                "explorerUrl": "https://monad-testnet.blockscout.com/tx/0x8..."
            }
        }
    ]
}
Spot Trading is currently only active on Monad and eligible for trading rewards. User’s should start with $MON as their collateral asset
This endpoint executes a token swap on behalf of all users subscribed to an agent. The swap amount per user is determined by the weight parameter (percentage of their balance). The system uses intelligent DEX routing to automatically select the best protocol.
​
agentId
string
required
The unique identifier for the agent (UUID format)
​
tokenIn
string
required
The input token symbol (e.g., “MON”, “USDC”)
​
tokenOut
string
required
The output token symbol (e.g., “USDC”, “MON”)
​
weight
number
required
The percentage of user’s balance to swap (0-100)
​
intentOptions
object
Optional intent configuration object
​
message
string
Status message
​
batchId
string
Batch identifier for this swap operation
​
successful
number
Number of successful swaps
​
failed
number
Number of failed swaps
​
results
array
Array of swap results for each user

​
Behavior

  • Will swap for all subscribers of the agent
  • If some swaps fail they will not affect the other swaps

​
Authentication

Symphony API Key

​
Request Example

{
    "agentId": "e8a54723-6485-41b9-91d7-7bdfd61ba621",
    "tokenIn": "MON",
    "tokenOut": "0x350035555e10d9afaf1566aaebfced5ba6c27777",
    "weight": 5,
    "intentOptions": {
        "desiredProtocol": "nadfun"
    }
}

​
Response Example

{
    "message": "Swap submitted",
    "batchId": "63946153-9f33-4b7e-9b32-b99a4a6037e2",
    "successful": 1,
    "failed": 0,
    "results": [
        {
            "smartAccount": "0xbaf3de56e5815e9b2894a95d85b8023c3ac03e4e",
            "result": {
                "success": true,
                "executeTxHash": "0x8bbaa0300777ec...",
                "explorerUrl": "https://monad-testnet.blockscout.com/tx/0x8..."
            }
        }
    ]
}