Allium · Balances History

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://agents.allium.so/api/v1/developer/wallet/balances/history", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "addresses": [
      {
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "chain": "ethereum"
      }
    ],
    "end_timestamp": "2025-06-17T00:00:00Z",
    "start_timestamp": "2025-06-01T00:00:00Z"
  }),
});
const data = await res.json();

curl -X POST \
  "https://agents.allium.so/api/v1/developer/wallet/balances/history" \
  -H "Content-Type: application/json" \
  -d '{"addresses":[{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"ethereum"}],"end_timestamp":"2025-06-17T00:00:00Z","start_timestamp":"2025-06-01T00:00:00Z"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "items": [
    {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "block_number": 20000000,
      "block_timestamp": "2025-06-17T00:00:00Z",
      "chain": "ethereum",
      "raw_balance": 1500000000000000000,
      "raw_balance_str": "1500000000000000000",
      "token": {
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "chain": "ethereum",
        "decimals": 18,
        "info": {
          "name": "Wrapped Ether",
          "symbol": "WETH"
        },
        "object": "token",
        "type": "evm_erc20"
      }
    }
  ]
}