billing.history

Every USDC payment credited to your account, newest first.

Details

Endpoint: GET /v1/billing/history
Credits: Free
Rate class: Light. Counts against your light requests per second.

Lists credit events: transfers to the treasury from your address, top-ups, pay-per-call payments (x402, MPP) and auto top-up draws. Each has the transaction digest, the checkpoint it is final at, the USDC amount and the credits added. Also returns recent auto top-up draws with their status. Pass `before` (an id) for older rows. Costs nothing.

Parameters

Name	Type	Description
limit	integer	1 to 200, default 50.
before	integer	Return rows with an id below this (paging).

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/billing/history?limit=2" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/billing/history?limit=2", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "items": [
    {
      "id": 3,
      "kind": "topup",
      "digest": "5ajkuHAnivMiKRne6EYS2bzvHpCHWYx849cmoSHN89Vm",
      "checkpoint": 341700000,
      "usd": "10",
      "amountRaw": "10000000",
      "credits": 3333333,
      "sender": "0x7d20dcdb2bca4f508ea9613994683eb4e76e9c4ed371169677c1be02aaf0b58e",
      "network": "mainnet",
      "time": "2026-11-04T20:00:00.000Z"
    }
  ],
  "draws": [],
  "cursor": null
}