Skip to main content
Glama

Reviewing Smart Money holdings history

smart_traders_and_funds_historical_token_balances
Read-only

Get the day-by-day history of aggregated smart trader and fund token balances (EXCLUDES whales, large holders, influencers, etc.) for a date range on base, bnb, ethereum, monad, robinhood or solana. Use this to see how smart money holdings changed over time; use smart_traders_and_funds_token_balances for the current snapshot. This endpoint uses inclusive UTC calendar dates, not rolling timestamps.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
requestYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "description": "Request for smart money historical token balances (v1 API) - flattened.",
      -    "properties": {
      -      "chains": {
      -        "description": "Chains to include. Supported: base, bnb, ethereum, monad, robinhood, solana.",
      -        "items": {
      -          "enum": [
      -            "base",
      -            "bnb",
      -            "ethereum",
      -            "monad",
      -            "robinhood",
      -            "solana"
      -          ],
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "dateRange": {
      -        "anyOf": [
      -          {
      -            "description": "Date range via tokens or dates.\nTokens: NOW, ALL_TIME, XMIN_AGO, XD_AGO, XH_AGO; THIS_YEAR_START, THIS_QUARTER_START, THIS_MONTH_START, THIS_WEEK_START, TODAY_START; LAST_WEEK_START/END, LAST_MONTH_START/END, LAST_QUARTER_START/END, LAST_YEAR_START/END.\nALL_TIME is full history. It resolves to 2009-01-03. Use ALL_TIME instead of a very large day count.\nWeek starts Monday. Quarters are calendar. Dates: YYYY-MM-DD or ___-MM-DD (year omitted).\nPlease check detailed system instructions for more information.",
      -            "properties": {
      -              "from": {
      -                "description": "Start value: token (see above) or date (YYYY-MM-DD or ___-MM-DD).",
      -                "type": "string"
      -              },
      -              "to": {
      -                "description": "End value: token (see above) or date (YYYY-MM-DD or ___-MM-DD).",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "from",
      -              "to"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Date range for the history. Defaults to the last 30 days. Maximum lookback is 4 years."
      -      },
      -      "includeNativeTokens": {
      -        "default": true,
      -        "description": "Whether to include native tokens (ETH, SOL, etc.) in results",
      -        "type": "boolean"
      -      },
      -      "includeSmartMoneyLabels": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "enum": [
      -                "30D Smart Trader",
      -                "90D Smart Trader",
      -                "180D Smart Trader",
      -                "All Time Smart Trader",
      -                "Fund",
      -                "Smart HL Perps Trader",
      -                "Any Smart Money"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Smart money category filters to include"
      -      },
      -      "includeStablecoin": {
      -        "default": true,
      -        "description": "Whether to include stablecoins in results",
      -        "type": "boolean"
      -      },
      -      "orderBy": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "date",
      -              "value_usd",
      -              "balance",
      -              "balance_24h_percent_change",
      -              "holders_count",
      -              "share_of_holdings_percent",
      -              "market_cap_usd"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Sort field. Pass an exact value above or None for default ('date')."
      -      },
      -      "orderByDirection": {
      -        "default": "DESC",
      -        "description": "Sort direction: 'ASC' or 'DESC' (case-insensitive).",
      -        "enum": [
      -          "ASC",
      -          "DESC",
      -          "asc",
      -          "desc"
      -        ],
      -        "type": "string"
      -      },
      -      "page": {
      -        "default": 1,
      -        "type": "integer"
      -      },
      -      "tokenAddress": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Restrict the history to a single token address"
      -      },
      -      "tokenSymbol": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Restrict the history to a single token symbol"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  {
      +    "description": "Request for smart money historical token balances (v1 API) - flattened.",
      +    "properties": {
      +      "chains": {
      +        "description": "Chains to include. Supported: base, bnb, ethereum, monad, robinhood, solana.",
      +        "items": {
      +          "enum": [
      +            "base",
      +            "bnb",
      +            "ethereum",
      +            "monad",
      +            "robinhood",
      +            "solana"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "dateRange": {
      +        "anyOf": [
      +          {
      +            "description": "Date range via tokens or dates.\nTokens: NOW, ALL_TIME, XMIN_AGO, XD_AGO, XH_AGO, XY_AGO; THIS_YEAR_START, THIS_QUARTER_START, THIS_MONTH_START, THIS_WEEK_START, TODAY_START; LAST_WEEK_START/END, LAST_MONTH_START/END, LAST_QUARTER_START/END, LAST_YEAR_START/END.\nDurations are exact rolling UTC timestamps at both ends: 1D_AGO equals 24H_AGO; 1Y_AGO equals 365 days. Bare duration aliases and case variants are supported.\nExplicit dates and calendar tokens keep calendar boundaries and inclusive final dates. TODAY_START is current-day midnight. Date-only endpoints keep their calendar contracts.\nALL_TIME is full history. It resolves to 2009-01-03. Use ALL_TIME instead of a very large day count.\nWeek starts Monday. Quarters are calendar. Dates: YYYY-MM-DD or ___-MM-DD (year omitted).\nPlease check detailed system instructions for more information.",
      +            "properties": {
      +              "from": {
      +                "description": "Start token or date (YYYY-MM-DD or ___-MM-DD). Durations use exact rolling UTC timestamps; dates and calendar tokens start at midnight.",
      +                "type": "string"
      +              },
      +              "to": {
      +                "description": "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.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "from",
      +              "to"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Date range for the history. Defaults to the last 30 days. Maximum lookback is 4 years."
      +      },
      +      "includeNativeTokens": {
      +        "default": true,
      +        "description": "Whether to include native tokens (ETH, SOL, etc.) in results",
      +        "type": "boolean"
      +      },
      +      "includeSmartMoneyLabels": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "enum": [
      +                "30D Smart Trader",
      +                "90D Smart Trader",
      +                "180D Smart Trader",
      +                "All Time Smart Trader",
      +                "Fund",
      +                "Smart HL Perps Trader",
      +                "Any Smart Money"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Smart money category filters to include"
      +      },
      +      "includeStablecoin": {
      +        "default": true,
      +        "description": "Whether to include stablecoins in results",
      +        "type": "boolean"
      +      },
      +      "orderBy": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "date",
      +              "value_usd",
      +              "balance",
      +              "balance_24h_percent_change",
      +              "holders_count",
      +              "share_of_holdings_percent",
      +              "market_cap_usd"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Sort field. Pass an exact value above or None for default ('date')."
      +      },
      +      "orderByDirection": {
      +        "default": "DESC",
      +        "description": "Sort direction: 'ASC' or 'DESC' (case-insensitive).",
      +        "enum": [
      +          "ASC",
      +          "DESC",
      +          "asc",
      +          "desc"
      +        ],
      +        "type": "string"
      +      },
      +      "page": {
      +        "default": 1,
      +        "type": "integer"
      +      },
      +      "tokenAddress": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Restrict the history to a single token address"
      +      },
      +      "tokenSymbol": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Restrict the history to a single token symbol"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "description": "Request for smart money historical token balances (v1 API) - flattened.",
      -    "properties": {
      -      "chains": {
      -        "description": "Chains to include. Supported: base, bnb, ethereum, monad, robinhood, solana.",
      -        "items": {
      -          "enum": [
      -            "base",
      -            "bnb",
      -            "ethereum",
      -            "monad",
      -            "robinhood",
      -            "solana"
      -          ],
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "dateRange": {
      -        "anyOf": [
      -          {
      -            "description": "Date range via tokens or dates.\nTokens: NOW, XMIN_AGO, XD_AGO, XH_AGO; THIS_YEAR_START, THIS_QUARTER_START, THIS_MONTH_START, THIS_WEEK_START, TODAY_START; LAST_WEEK_START/END, LAST_MONTH_START/END, LAST_QUARTER_START/END, LAST_YEAR_START/END.\nWeek starts Monday. Quarters are calendar. Dates: YYYY-MM-DD or ___-MM-DD (year omitted).\nPlease check detailed system instructions for more information.",
      -            "properties": {
      -              "from": {
      -                "description": "Start value: token (see above) or date (YYYY-MM-DD or ___-MM-DD).",
      -                "type": "string"
      -              },
      -              "to": {
      -                "description": "End value: token (see above) or date (YYYY-MM-DD or ___-MM-DD).",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "from",
      -              "to"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Date range for the history. Defaults to the last 30 days. Maximum lookback is 4 years."
      -      },
      -      "includeNativeTokens": {
      -        "default": true,
      -        "description": "Whether to include native tokens (ETH, SOL, etc.) in results",
      -        "type": "boolean"
      -      },
      -      "includeSmartMoneyLabels": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "enum": [
      -                "30D Smart Trader",
      -                "90D Smart Trader",
      -                "180D Smart Trader",
      -                "All Time Smart Trader",
      -                "Fund",
      -                "Smart HL Perps Trader",
      -                "Any Smart Money"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Smart money category filters to include"
      -      },
      -      "includeStablecoin": {
      -        "default": true,
      -        "description": "Whether to include stablecoins in results",
      -        "type": "boolean"
      -      },
      -      "orderBy": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "date",
      -              "value_usd",
      -              "balance",
      -              "balance_24h_percent_change",
      -              "holders_count",
      -              "share_of_holdings_percent",
      -              "market_cap_usd"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Sort field. Pass an exact value above or None for default ('date')."
      -      },
      -      "orderByDirection": {
      -        "default": "DESC",
      -        "description": "Sort direction: 'ASC' or 'DESC' (case-insensitive).",
      -        "enum": [
      -          "ASC",
      -          "DESC",
      -          "asc",
      -          "desc"
      -        ],
      -        "type": "string"
      -      },
      -      "page": {
      -        "default": 1,
      -        "type": "integer"
      -      },
      -      "tokenAddress": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Restrict the history to a single token address"
      -      },
      -      "tokenSymbol": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Restrict the history to a single token symbol"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  {
      +    "description": "Request for smart money historical token balances (v1 API) - flattened.",
      +    "properties": {
      +      "chains": {
      +        "description": "Chains to include. Supported: base, bnb, ethereum, monad, robinhood, solana.",
      +        "items": {
      +          "enum": [
      +            "base",
      +            "bnb",
      +            "ethereum",
      +            "monad",
      +            "robinhood",
      +            "solana"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "dateRange": {
      +        "anyOf": [
      +          {
      +            "description": "Date range via tokens or dates.\nTokens: NOW, ALL_TIME, XMIN_AGO, XD_AGO, XH_AGO; THIS_YEAR_START, THIS_QUARTER_START, THIS_MONTH_START, THIS_WEEK_START, TODAY_START; LAST_WEEK_START/END, LAST_MONTH_START/END, LAST_QUARTER_START/END, LAST_YEAR_START/END.\nALL_TIME is full history. It resolves to 2009-01-03. Use ALL_TIME instead of a very large day count.\nWeek starts Monday. Quarters are calendar. Dates: YYYY-MM-DD or ___-MM-DD (year omitted).\nPlease check detailed system instructions for more information.",
      +            "properties": {
      +              "from": {
      +                "description": "Start value: token (see above) or date (YYYY-MM-DD or ___-MM-DD).",
      +                "type": "string"
      +              },
      +              "to": {
      +                "description": "End value: token (see above) or date (YYYY-MM-DD or ___-MM-DD).",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "from",
      +              "to"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Date range for the history. Defaults to the last 30 days. Maximum lookback is 4 years."
      +      },
      +      "includeNativeTokens": {
      +        "default": true,
      +        "description": "Whether to include native tokens (ETH, SOL, etc.) in results",
      +        "type": "boolean"
      +      },
      +      "includeSmartMoneyLabels": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "enum": [
      +                "30D Smart Trader",
      +                "90D Smart Trader",
      +                "180D Smart Trader",
      +                "All Time Smart Trader",
      +                "Fund",
      +                "Smart HL Perps Trader",
      +                "Any Smart Money"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Smart money category filters to include"
      +      },
      +      "includeStablecoin": {
      +        "default": true,
      +        "description": "Whether to include stablecoins in results",
      +        "type": "boolean"
      +      },
      +      "orderBy": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "date",
      +              "value_usd",
      +              "balance",
      +              "balance_24h_percent_change",
      +              "holders_count",
      +              "share_of_holdings_percent",
      +              "market_cap_usd"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Sort field. Pass an exact value above or None for default ('date')."
      +      },
      +      "orderByDirection": {
      +        "default": "DESC",
      +        "description": "Sort direction: 'ASC' or 'DESC' (case-insensitive).",
      +        "enum": [
      +          "ASC",
      +          "DESC",
      +          "asc",
      +          "desc"
      +        ],
      +        "type": "string"
      +      },
      +      "page": {
      +        "default": 1,
      +        "type": "integer"
      +      },
      +      "tokenAddress": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Restrict the history to a single token address"
      +      },
      +      "tokenSymbol": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "description": "Restrict the history to a single token symbol"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources