Skip to content
POST/v1/tools/today· 2 credits a pull

Today so far, hourly

The open UTC day by hour: DEX flow and volume, plus the smart-money cohort's venue flow.

How to get it
today · hours, everyone, smart_money
Cost
2 credits a pull
Window
Up to 60 days

Get it

today returns it at hours, everyone, smart_money.

curl -X POST "https://api.blocktronics.xyz/v1/tools/today" \
  -H "Authorization: Bearer $BLOCKTRONICS_KEY" \
  -H "content-type: application/json" \
  -d '{"token":"base:0x4ed4e862860bed51a9570b96d89af5e1b0efefed"}'

Understand this metric

Every daily series stops at the last settled day. This is the day still in progress, one row per hour from midnight UTC to the last stored swap, for DEX trading as a whole and for the smart-money cohort.

  • partial is true until midnight UTC: never add these hours to a daily series.
  • is_current_utc_day is false when the hourly refresh hasn't stored today yet; day then names the latest day it has.
  • unpriced_swaps counts swaps with no USD value yet: a low bar beside them is a pricing gap, not a quiet hour.
  • token_overview carries today's totals too, without the hours.

In the answer

today · hours, everyone, smart_money
{
  "day": "2026-10-26",
  "as_of": "2026-10-26T02:41:07.000Z",
  "partial": true,
  "is_current_utc_day": true,
  "timezone": "UTC",
  "everyone": {
    "net_flow_usd": 412.5,
    "buy_volume_usd": 3120.25,
    "sell_volume_usd": 2707.75,
    "volume_usd": 5828,
    "buys": 14,
    "sells": 11,
    "unpriced_swaps": 0,
    "strongest_buy_hour": {
      "hour": "00:00",
      "net_flow_usd": 412.5
    },
    "strongest_sell_hour": null
  },
  "smart_money": {
    "net_usd": 640.8,
    "buy_usd": 640.8,
    "sell_usd": 0,
    "buyers": 1,
    "sellers": 0,
    "…": ""
  },
  "unavailable": {},
  "hours": [
    {
      "hour": "00:00",
      "net_flow_usd": 412.5,
      "buy_volume_usd": 3120.25,
      "sell_volume_usd": 2707.75,
      "buys": 14,
      "sells": 11,
      "unpriced_swaps": 0,
      "smart_net_usd": 640.8,
      "smart_buy_usd": 640.8,
      "smart_sell_usd": 0,
      "smart_buyers": 1,
      "smart_sellers": 0,
      "smart_net_tokens": 889999.8
    }
  ]
}
Example values

Availability and billing

A day with no figure is null, never 0, and unavailable names a panel that couldn't be read, with the reason. Keep gaps as gaps. See data availability and credits and billing.

More parts