Skip to main content
Glama

Comparing wallet connections

address_counterparties_batch
Read-onlyIdempotent

Get the top counterparties of up to 10 wallet addresses in one call.

Every wallet gets its own counterparty list. The lists are NOT added together: the answer has one table for each wallet.

Use this tool to compare wallets — counterparties that two wallets share, a group of wallets that sends to the same CEX deposit address, or one fund with many wallets. For one wallet, or for an entity name, use address_counterparties.

Limits:

  • Maximum 10 distinct wallet addresses for each call. Repeated addresses are removed.

  • Maximum 90 days for the date range. A wider range is rejected — make more than one call.

  • One chain family for each call: every address must be EVM, or every address must be Solana, and so on. Do not mix families.

Name a chain (for example ethereum) to read that chain only. Leave chain out to read every chain of the addresses' family at one time — then a counterparty met on more than one chain gets one row for each chain, so do not add those rows together.

Sorting Options (all fields support "ASC"/"DESC"): Available for sorting: total_volume_usd, volume_in_usd, volume_out_usd, interaction_count. The sort is applied inside each wallet's block.

Example (every key below is the name the request accepts, and the addresses are real — copy this shape as it stands): { "walletAddresses": [ "0x28c6c06298d514db089934071355e5743bf21d60", "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" ], "chain": "ethereum", "timeRange": {"from": "30D_AGO", "to": "NOW"}, "sourceInput": "Combined", "orderBy": "total_volume_usd", "orderByDirection": "DESC", "perPage": 100 }

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "request": "<request>"
    },
    "name": "address_counterparties_batch"
  }
}

Input Schema

NameRequiredDescriptionDefault
requestYesComplete request for batch address counterparties (flattened). Wallet addresses only. Use AddressCounterpartiesRequest for one wallet or for an entity name.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / request / properties / filters / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "Row filters for batch counterparties. Each filter drops counterparty rows.",
      -    "properties": {
      -      "excludeSmartMoneyLabels": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "enum": [
      -                "30D Smart Trader",
      -                "90D Smart Trader",
      -                "180D Smart Trader",
      -                "Smart Trader",
      -                "Smart HL Perps Trader",
      -                "Fund",
      -                "Public Figure",
      -                "Exchange",
      -                "Whale",
      -                "First Mover LP",
      -                "First Mover Staking",
      -                "Profitable LP",
      -                "Early MAGIC Miner",
      -                "BananaGun Bot User",
      -                "Top BananaGun Bot User",
      -                "Maestro Bot User",
      -                "Top Maestro Bot User"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Drop counterparties that carry one of these labels"
      -      },
      -      "includeSmartMoneyLabels": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "enum": [
      -                "30D Smart Trader",
      -                "90D Smart Trader",
      -                "180D Smart Trader",
      -                "Smart Trader",
      -                "Smart HL Perps Trader",
      -                "Fund",
      -                "Public Figure",
      -                "Exchange",
      -                "Whale",
      -                "First Mover LP",
      -                "First Mover Staking",
      -                "Profitable LP",
      -                "Early MAGIC Miner",
      -                "BananaGun Bot User",
      -                "Top BananaGun Bot User",
      -                "Maestro Bot User",
      -                "Top Maestro Bot User"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep only counterparties that carry one of these labels"
      -      },
      -      "interactionCount": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose interaction count is in this range"
      -      },
      -      "totalVolumeUsd": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose total USD volume is in this range"
      -      },
      -      "volumeInUsd": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose incoming USD volume is in this range"
      -      },
      -      "volumeOutUsd": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose outgoing USD volume is in this range"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "Row filters for batch counterparties. Each filter drops counterparty rows.",
      +    "properties": {
      +      "excludeSmartMoneyLabels": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "enum": [
      +                "Smart Trader",
      +                "Smart HL Perps Trader",
      +                "Fund",
      +                "Public Figure",
      +                "Exchange",
      +                "Whale",
      +                "First Mover LP",
      +                "First Mover Staking",
      +                "Profitable LP",
      +                "Early MAGIC Miner",
      +                "BananaGun Bot User",
      +                "Top BananaGun Bot User",
      +                "Maestro Bot User",
      +                "Top Maestro Bot User"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Drop counterparties that carry one of these labels"
      +      },
      +      "includeSmartMoneyLabels": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "enum": [
      +                "Smart Trader",
      +                "Smart HL Perps Trader",
      +                "Fund",
      +                "Public Figure",
      +                "Exchange",
      +                "Whale",
      +                "First Mover LP",
      +                "First Mover Staking",
      +                "Profitable LP",
      +                "Early MAGIC Miner",
      +                "BananaGun Bot User",
      +                "Top BananaGun Bot User",
      +                "Maestro Bot User",
      +                "Top Maestro Bot User"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep only counterparties that carry one of these labels"
      +      },
      +      "interactionCount": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose interaction count is in this range"
      +      },
      +      "totalVolumeUsd": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose total USD volume is in this range"
      +      },
      +      "volumeInUsd": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose incoming USD volume is in this range"
      +      },
      +      "volumeOutUsd": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose outgoing USD volume is in this range"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed2 schema fields changed
    • changedInput schema / properties / request / properties / filters / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "Row filters for batch counterparties. Each filter drops counterparty rows.",
      -    "properties": {
      -      "excludeSmartMoneyLabels": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "enum": [
      -                "30D Smart Trader",
      -                "90D Smart Trader",
      -                "180D Smart Trader",
      -                "Smart Trader",
      -                "Smart HL Perps Trader",
      -                "Fund",
      -                "Public Figure",
      -                "Exchange",
      -                "Whale",
      -                "First Mover LP",
      -                "First Mover Staking",
      -                "Profitable LP",
      -                "Early MAGIC Miner",
      -                "BananaGun Bot User",
      -                "Top BananaGun Bot User",
      -                "Maestro Bot User",
      -                "Top Maestro Bot User"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Drop counterparties that carry one of these labels"
      -      },
      -      "includeSmartMoneyLabels": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "enum": [
      -                "30D Smart Trader",
      -                "90D Smart Trader",
      -                "180D Smart Trader",
      -                "Smart Trader",
      -                "Smart HL Perps Trader",
      -                "Fund",
      -                "Public Figure",
      -                "Exchange",
      -                "Whale",
      -                "First Mover LP",
      -                "First Mover Staking",
      -                "Profitable LP",
      -                "Early MAGIC Miner",
      -                "BananaGun Bot User",
      -                "Top BananaGun Bot User",
      -                "Maestro Bot User",
      -                "Top Maestro Bot User"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep only counterparties that carry one of these labels"
      -      },
      -      "interactionCount": {
      -        "anyOf": [
      -          {
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose interaction count is in this range"
      -      },
      -      "totalVolumeUsd": {
      -        "anyOf": [
      -          {
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose total USD volume is in this range"
      -      },
      -      "volumeInUsd": {
      -        "anyOf": [
      -          {
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose incoming USD volume is in this range"
      -      },
      -      "volumeOutUsd": {
      -        "anyOf": [
      -          {
      -            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      -            "properties": {
      -              "from": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Minimum value (inclusive), optional"
      -              },
      -              "to": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Maximum value (inclusive), optional"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Keep counterparties whose outgoing USD volume is in this range"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "Row filters for batch counterparties. Each filter drops counterparty rows.",
      +    "properties": {
      +      "excludeSmartMoneyLabels": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "enum": [
      +                "30D Smart Trader",
      +                "90D Smart Trader",
      +                "180D Smart Trader",
      +                "Smart Trader",
      +                "Smart HL Perps Trader",
      +                "Fund",
      +                "Public Figure",
      +                "Exchange",
      +                "Whale",
      +                "First Mover LP",
      +                "First Mover Staking",
      +                "Profitable LP",
      +                "Early MAGIC Miner",
      +                "BananaGun Bot User",
      +                "Top BananaGun Bot User",
      +                "Maestro Bot User",
      +                "Top Maestro Bot User"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Drop counterparties that carry one of these labels"
      +      },
      +      "includeSmartMoneyLabels": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "enum": [
      +                "30D Smart Trader",
      +                "90D Smart Trader",
      +                "180D Smart Trader",
      +                "Smart Trader",
      +                "Smart HL Perps Trader",
      +                "Fund",
      +                "Public Figure",
      +                "Exchange",
      +                "Whale",
      +                "First Mover LP",
      +                "First Mover Staking",
      +                "Profitable LP",
      +                "Early MAGIC Miner",
      +                "BananaGun Bot User",
      +                "Top BananaGun Bot User",
      +                "Maestro Bot User",
      +                "Top Maestro Bot User"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep only counterparties that carry one of these labels"
      +      },
      +      "interactionCount": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose interaction count is in this range"
      +      },
      +      "totalVolumeUsd": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose total USD volume is in this range"
      +      },
      +      "volumeInUsd": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose incoming USD volume is in this range"
      +      },
      +      "volumeOutUsd": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "description": "Numeric range where from_value and to_value are optional,\nallowing for open-ended ranges (e.g., only minimum or only maximum).",
      +            "properties": {
      +              "from": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Minimum value (inclusive), optional"
      +              },
      +              "to": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "default": null,
      +                "description": "Maximum value (inclusive), optional"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Keep counterparties whose outgoing USD volume is in this range"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / request / properties / timeRange / additionalProperties
      Added value: +false
  3. Changed2 schema fields changed
    • changedInput schema / properties / request / properties / timeRange / properties / from / description
      Previous value: -"Start value: token (see above) or date (YYYY-MM-DD or ___-MM-DD)."New value: +"Start token or date (YYYY-MM-DD or ___-MM-DD). Durations use exact rolling UTC timestamps; dates and calendar tokens start at midnight."
    • changedInput schema / properties / request / properties / timeRange / properties / to / description
      Previous value: -"End value: token (see above) or date (YYYY-MM-DD or ___-MM-DD)."New value: +"End token or date (YYYY-MM-DD or ___-MM-DD). Durations use exact rolling UTC timestamps without an extra day. Dates and calendar tokens include the final date; TODAY_START stays at midnight."
  4. Added

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the read-only, idempotent, non-destructive profile, but the description adds the crucial result-shape behavior: lists are per wallet and NOT summed, and a counterparty seen on multiple chains produces duplicate rows that must not be added together. It also discloses rejection thresholds (10 addresses, 90 days, one chain family) and that sorting applies inside each wallet's block rather than globally.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The answer is front-loaded with purpose and the sibling routing, then segmented into Limits and Sorting sections, which is easy to scan. Some content is duplicated from the schema, notably the chain 'leave it out' explanation, which adds length without new information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a nested request with an output schema and full annotation coverage, the description covers everything an agent needs: aggregation semantics, hard limits, chain-family constraint, sorting scope, and a valid example payload. Return values need not be explained because an output schema exists.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, and the description adds real value on top: it clarifies that the sort is applied per wallet block and supplies a copyable example with the exact request keys. The chain-inclusion semantics it restates are already in the schema, which keeps it from being a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence gives a specific verb and resource ('Get the top counterparties') plus an explicit scope ('up to 10 wallet addresses in one call'). It immediately distinguishes itself from the single-wallet sibling by naming address_counterparties and the condition that selects it.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description names concrete use cases (shared counterparties between two wallets, a group sending to the same CEX deposit address, one fund with many wallets) and explicitly routes single-wallet and entity-name work to address_counterparties. It also states when the tool will fail: more than 10 addresses, ranges beyond 90 days, and mixed chain families.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources