MCP Tool: TokenSwaps

Returns detailed swap transaction data with optional advanced trader DNA metrics.

🧠 Capabilities

• Query swap history with pagination (up to 1,000 per call)
• Filter by wallet, token pair, liquidity pool, or DNA metrics (intelligence, reputation, flow, mass, epoch)
• Analyze buy/sell patterns and notional values
• Sort chronologically or reverse chronologically

🧾 Parameters

Code
 
{
  "tokenAddress": "string",
  "counterTokenAddress": "string",
  "pairAddress": "string",
  "walletAddress": "string",
  "walletRole": "trader | maker",
  "side": "buy | sell | all",
  "startUtc": "MM-DD-YYYY hh:mm:ss",
  "startBlockNumber": "string",
  "startLogIndex": "string",
  "notionalUsdMin": "string",
  "notionalUsdMax": "string",
  "num": "25",
  "order": "asc | desc",
  "blockchain": "ethereum",
  "estimateCost": false,
  "dnaToInclude": ["all", "tokens", "intelligence", "reputation", "flow", "mass", "epoch", "makerPresence", "entry"]
}

🧬 DNA Filter Parameters

Code
 
{
  "iqMin": "0", "iqMax": "200",
  "intelligenceMin": "Idiot", "intelligenceMax": "Einstein",
  "reputationMin": "0", "reputationMax": "100",
  "reputationTierMin": "F", "reputationTierMax": "A+",
  "flowMin": "0", "flowMax": "999",
  "flowTierMin": "Dry", "flowTierMax": "Tsunami",
  "buyFlowMin": "0", "buyFlowMax": "999",
  "buyFlowTierMin": "Dry", "buyFlowTierMax": "Tsunami",
  "sellFlowMin": "0", "sellFlowMax": "999",
  "sellFlowTierMin": "Dry", "sellFlowTierMax": "Tsunami",
  "massMin": "0", "massMax": "999",
  "massTierMin": "Ghost", "massTierMax": "Moby",
  "epochMin": "0", "epochMax": "200",
  "epochTierMin": "Newbie", "epochTierMax": "Ultra OG",
  "makerPresenceMin": "0", "makerPresenceMax": "999",
  "makerPresenceTierMin": "Zero", "makerPresenceTierMax": "Hyperactive"
}

🔐 Requirements

• No required fields. Defaults to entire chain
• Use tokenAddress or pairAddress to narrow scope
• Combine filters for targeted DNA-based analysis
• Use estimateCost: true to preview SLAM usage for DNA queries

🤖 Use Cases

• Smart money and whale tracking tools
• Entry/exit pattern analysis
• Epoch-weighted trend analysis
• Alpha discovery using high-IQ and high-reputation traders