---
title: "aggregated messages grouped by timestamp"
method: GET
path: "/messages/aggregated/history"
tags: ["transaction"]
---

# aggregated messages grouped by timestamp

`GET /messages/aggregated/history`

## Request

- Base URL: `https://anton.tools/api/v0`
- URL: `https://anton.tools/api/v0/messages/aggregated/history`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tonindexer/apis/anton/docs/messages/aggregated/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Counts messages or sums amount

## Query parameters

- `metric` 'message_count' | 'message_amount_sum', required
- `src_address` string[]
- `dst_address` string[]
- `src_workchain` integer
- `dst_workchain` integer
- `src_contract` string[]
- `dst_contract` string[]
- `operation_name` string[]
- `minter_address` string
- `from` string
- `to` string
- `interval` '24h' | '8h' | '4h' | '1h' | '15m', required

## Response `200`

OK

- HistoryMessagesRes
  - `count_results` object[]
    - `timestamp` string
    - `value` integer
  - `sum_results` object[]
    - `timestamp` string
    - `value` BunbigInt

## Changes

- **2024-04-11** `6fe292b005be`: 2 info
  - added the new optional `query` request parameter `dst_workchain`
  - added the new optional `query` request parameter `src_workchain`
- **2023-03-29** `c5d1a6fbaa1f`: 1 info
  - endpoint added
- **2023-03-03** `e00c25bb9798`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/tonindexer/apis/anton/changes/messages/aggregated/history/get.md)

---

[API](https://skmtc.dev/tonindexer/apis/anton.md) - [All operations](https://skmtc.dev/tonindexer/apis/anton/llms.txt) - [OpenAPI document](https://skmtc.dev/tonindexer/apis/anton/revisions/a3d3850ec94f?raw)