agents.overview

What AI agents do on Sui right now: active agent wallets, spend under allowances, payments, products and a live feed.

Details

Endpoint: GET /v1/agents/overview
Credits: 1
Rate class: Light. Counts against your light requests per second.

The agent world on Sui in one call. today: agent wallets active in 24 hours and known in all, their transactions and outflow volume in USD, Agent Passes (active), sui::allowance objects (active) and USD drawn under them (all time and 24 hours), Sui Agent Payments (testnet payments, refused payments; mainnet once published), gasless and sponsored transactions in 24 hours. products: Sui Agent Pass, allowances, gasless transfers, Sui Agent Payments, t2000, Talus Nexus and smaller agent contracts, each with status (mainnet, testnet, announced), a link and a few numbers. feed: the latest agent actions in plain English, each with digest, network, product, agent and owner. leaders: the most active agent wallets over 7 days by transactions and outflow volume. Rebuilt every 2 minutes.

Parameters

Name	Type	Description
feed	integer	Feed lines, default 20.From 0 to 100.
leaders	integer	Leaderboard rows, default 10.From 0 to 25.

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/agents/overview?feed=5&leaders=5" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/agents/overview?feed=5&leaders=5", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "asOf": {
    "checkpoint": 341929923,
    "timestamp": "2026-11-05T13:37:13.760Z",
    "lagMs": null
  },
  "checkpoint": 341929923,
  "today": {
    "activeAgents": 10,
    "knownAgents": 1850,
    "agentTxs": 262,
    "volumeUsd": 1131.9570009133524,
    "week": {
      "active": [
        37,
        42
      ],
      "txs": [
        1385,
        3163
      ],
      "spentUsd": [
        0.17368952697825438,
        null
      ],
      "passesActive": [
        3,
        1
      ]
    },
    "passes": 9,
    "passesActive": 3,
    "allowances": 121,
    "allowancesActive": 24,
    "allowanceSpentUsd": 1820.3815512502733,
    "allowanceSpent24hUsd": 0,
    "payments": {
      "mainnet": 0,
      "testnet": 33,
      "testnetUsd": 0.280007,
      "denied": 8
    },
    "gasless24h": 1003,
    "sponsored24h": 1308347
  },
  "products": [
    {
      "id": "agent-pass",
      "name": "Sui Agent Pass",
      "maker": "Mysten Labs",
      "status": "mainnet",
      "statusWords": "On mainnet for pre-launch tests with small sums",
      "blurb": "An owner signs a pass once; the agent's session key can then act only within the pass's on-chain rules and budgets.",
      "url": "https://www.npmjs.com/package/@mysten-incubation/sui-agent-pass",
      "decoded": true,
      "stats": [
        {
          "label": "Passes",
          "value": "9 (3 active)"
        },
        {
          "label": "Agents active, 7 days",
          "value": "6"
        }
      ]
    },
    {
      "id": "allowances",
      "name": "Allowances",
      "maker": "Sui protocol",
      "status": "mainnet",
      "statusWords": "Live on mainnet since protocol 138",
      "blurb": "A spending budget from an address balance: a cap, an optional daily or monthly limit and an expiry, revocable by the owner.",
      "url": "https://docs.sui.io/onchain-finance/allowances/allowances-overview",
      "decoded": true,
      "stats": [
        {
          "label": "Allowances",
          "value": "121 (24 active)"
        },
        {
          "label": "Drawn so far",
          "value": "$1,820.38"
        }
      ]
    },
    {
      "id": "gasless",
      "name": "Gasless stablecoin transfers",
      "maker": "Sui protocol",
      "status": "mainnet",
      "statusWords": "Live on mainnet since May 2026",
      "blurb": "USDC and other listed stablecoins move between address balances with no SUI for gas, so an agent can pay with stablecoins alone.",
      "url": "https://docs.sui.io/onchain-finance/address-balances",
      "decoded": true,
      "stats": [
        {
          "label": "Gasless txs, 24 hours",
          "value": "1,003"
        }
      ]
    }
  ],
  "feed": [
    {
      "digest": "5Qnpbk4zJEqCeEDFHw8sWrSqJkSkzbG7VWG5bFNtJE67",
      "ms": 1793882871404,
      "net": "mainnet",
      "product": "allowances",
      "sentence": "0x1b67…626a revoked the allowance \"t2000 M3 acceptance: a float draw\" that let 0xbd27…7537 spend USDC; 0.09 USDC had been drawn of 0.1 USDC.",
      "agent": "0xbd27c7d2f3afd9656c3e133d1a2e39a336dd4ed42ad255a399732a8760647537",
      "owner": "0x1b676ce907aaf007ddae6ab319194250eb21f25e64930207c876484d45b1626a",
      "ok": true,
      "verb": "Allowance revoked",
      "kind": "burn",
      "who": "0x1b676ce907aaf007ddae6ab319194250eb21f25e64930207c876484d45b1626a",
      "legs": [],
      "id": "5Qnpbk4zJEqCeEDFHw8sWrSqJkSkzbG7VWG5bFNtJE67"
    },
    {
      "digest": "BnKpUcV6SSqvm6AKNbBKw1wAkmxGemtd1Tjwx7uVjFE7",
      "ms": 1793882836070,
      "net": "mainnet",
      "product": "allowances",
      "sentence": "0x1b67…626a gave 0xbd27…7537 an allowance \"t2000 M3 acceptance: a float draw\" to spend its USDC: up to 0.1 USDC in total, at most 0.1 USDC per week, until Nov 12, 2026.",
      "agent": "0xbd27c7d2f3afd9656c3e133d1a2e39a336dd4ed42ad255a399732a8760647537",
      "owner": "0x1b676ce907aaf007ddae6ab319194250eb21f25e64930207c876484d45b1626a",
      "ok": true,
      "verb": "Allowance granted",
      "kind": "mint",
      "who": "0x1b676ce907aaf007ddae6ab319194250eb21f25e64930207c876484d45b1626a",
      "legs": [
        {
          "type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
          "symbol": "USDC",
          "amount": "0.1"
        }
      ],
      "id": "BnKpUcV6SSqvm6AKNbBKw1wAkmxGemtd1Tjwx7uVjFE7"
    },
    {
      "digest": "DiWUKDaEYUMRfWoxozG3SokJk7UquiZAALuLbZfHsJDY",
      "ms": 1793849408840,
      "net": "testnet",
      "product": "agent-payments",
      "sentence": "Agent 0x507f…ce0c paid 0.001 USDC to 0x158a…93e7 for a paid API call, under grant 0x3841…6338; 3.028 USDC left in the spend account.",
      "agent": "0x507f0752ba7a40e8bc872f3c3b0dda49e34bfe2f1a970cf6561ca26a1a1fce0c",
      "owner": null,
      "ok": true,
      "verb": "Paid",
      "kind": "transfer",
      "who": "0x507f0752ba7a40e8bc872f3c3b0dda49e34bfe2f1a970cf6561ca26a1a1fce0c",
      "legs": [
        {
          "type": "0xa1ec7fc00a6f40db9693ad1415d0c193ad3906494428cf252621037bd7117e29::usdc::USDC",
          "symbol": "USDC",
          "amount": "1,000"
        }
      ],
      "id": "DiWUKDaEYUMRfWoxozG3SokJk7UquiZAALuLbZfHsJDY"
    }
  ],
  "leaders": [
    {
      "address": "0xdcb39eb1c879ef2de47f710549c7ca41859793122bdbafce343bef3a653abe92",
      "product": "talus",
      "txs": 573,
      "volumeUsd": 43.44079764206689,
      "lastMs": 1793815408478,
      "owner": null,
      "spark": [
        13,
        11,
        0
      ]
    },
    {
      "address": "0x47a3aa424fc14008f4dfeebef948d3e31c5c3d8c45f29b465e77330feac591a4",
      "product": "talus",
      "txs": 208,
      "volumeUsd": 0.673295249949862,
      "lastMs": 1793709862960,
      "owner": null,
      "spark": [
        0,
        7,
        0
      ]
    },
    {
      "address": "0x1c4a98405fc29d73bd1e6e20a97863560d1c9a6a45436f25b0bc51bc5bb672df",
      "product": "talus",
      "txs": 177,
      "volumeUsd": 0.6108193130215909,
      "lastMs": 1793709851703,
      "owner": null,
      "spark": [
        0,
        3,
        0
      ]
    }
  ],
  "series": {
    "ends": [
      1791380184832,
      1791466584832,
      1791552984832
    ],
    "txs": {
      "agent-contracts": [
        4,
        39,
        34
      ],
      "t2000": [
        587,
        461,
        15
      ],
      "allowances": [
        0,
        0,
        0
      ],
      "talus": [
        25,
        2,
        16
      ],
      "agent-pass": [
        0,
        0,
        0
      ]
    },
    "active": [
      40,
      41,
      7
    ],
    "spend": [
      0,
      0,
      0
    ],
    "spendFrom": 29,
    "passes": [
      0,
      0,
      0
    ]
  },
  "logos": {
    "agent-pass": "/coins/sui.svg",
    "allowances": "/coins/sui.svg",
    "gasless": "/coins/sui.svg",
    "agent-payments": "/coins/sui.svg",
    "t2000": null,
    "talus": null,
    "walrus-memory": "/protocols/walrus.webp",
    "seal-mpc": "/coins/sui.svg",
    "rooms": "/coins/sui.svg",
    "warrant": "/coins/sui.svg",
    "arbiter": "/protocols/walrus.webp"
  },
  "testnet": {
    "package": "0x959c497f0c93f4d3d7f563bd1a2d6ff22540b1f958f17b8df19c0e81ca4bfd55",
    "grants": 22,
    "accounts": 8,
    "payments": 33,
    "denied": 8
  }
}

Long lists are cut to a few items here.