Spot Trading

Spot trading agents require visibility into execution history and asset validity.

get_spot_trading_history

Example Request
Example Response
{
  "clientAddress": "0xF4614C8C45beF5700e491E627aeecd4d5aabac61"
}
{
  "clientAddress": "0xF4614C8C45beF5700e491E627aeecd4d5aabac61",
  "trades": [
    {
      "tradeId": "trade_102394",
      "side": "buy",
      "baseCoin": "ETH",
      "quoteCoin": "USDC",
      "amountIn": 500.0,
      "amountOut": 0.1472,
      "entryPrice": 3396.74,
      "takeProfitPrice": 3500.0,
      "stopLossPrice": 3300.0,
      "usdFeePaid": 0.75,
      "txHash": "0xabc123...",
      "status": "success",
      "executedAt": "2025-01-13T11:05:44Z"
    }
  ]
}

supported_spot_trading_token_list

Example Request
Example Response
{
  "chainId": 8453 // optional
}
{
  "chain": "Base",
  "venue": "dex_aggregator",
  "supportedTokens": [
    {
      "symbol": "ETH",
      "tokenAddress": "0x4200000000000000000000000000000000000006",
      "supportedPairs": ["ETH/USDC", "ETH/USDT"],
      "supportedOrderTypes": ["market", "limit"]
    },
    {
      "symbol": "USDC",
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "supportedPairs": ["ETH/USDC", "BTC/USDC"],
      "supportedOrderTypes": ["market", "limit"]
    }
  ],
  "lastUpdatedAt": "2025-01-13T11:05:44Z"
}

get_spot_trading_market_price

Example Request
Example Response
{
  "baseToken": "ETH",
  "quoteToken": "USDC",
  "chainId": 8453
}
{
  "chain": "Base",
  "baseCoin": "ETH",
  "quoteCoin": "USDC",
  "price": 3402.15,
  "slippageEstimatePercentage": 0.25,
  "quotedAt": "2025-01-13T11:05:44Z"
}

Last updated