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": 342150053,
"timestamp": "2026-11-06T04:14:08.526Z",
"lagMs": null
},
"checkpoint": 342150053,
"today": {
"activeAgents": 12,
"knownAgents": 1855,
"agentTxs": 28,
"volumeUsd": 6147.750309676926,
"week": {
"active": [
38,
38
],
"txs": [
1327,
3220
],
"spentUsd": [
21.49891854816017,
null
],
"passesActive": [
3,
1
]
},
"passes": 9,
"passesActive": 3,
"allowances": 121,
"allowancesActive": 24,
"allowanceSpentUsd": 1834.685348849433,
"allowanceSpent24hUsd": 21.335229021181917,
"payments": {
"mainnet": 0,
"testnet": 33,
"testnetUsd": 0.280007,
"denied": 8
},
"gasless24h": 970,
"sponsored24h": 1511557
},
"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": "5"
}
]
},
{
"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,834.69"
}
]
},
{
"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": "970"
}
]
}
],
"feed": [
{
"digest": "ABFVT6JQ4tGXMWu1hBLa8mNDDRcT3aRmhxya1MDNJyUK",
"ms": 1793902937294,
"net": "mainnet",
"product": "agent-pass",
"sentence": "The agent swapped 0.5 USDC for 0.59 SUI on Cetus.",
"agent": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"ok": true,
"verb": "Swapped",
"kind": "swap",
"who": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"legs": [
{
"type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
"symbol": "USDC",
"amount": "-0.5"
},
{
"type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"amount": "+0.5899"
}
],
"detail": "Buy SUI daily",
"id": "ABFVT6JQ4tGXMWu1hBLa8mNDDRcT3aRmhxya1MDNJyUK"
},
{
"digest": "3nowKBiMC1PXMjU2h7XdUetbtsq42gwEBXYg4g9WrmDX",
"ms": 1793889332390,
"net": "mainnet",
"product": "agent-contracts",
"sentence": "0xdcb3…be92 called new on the Agent contract.",
"agent": "0xdcb39eb1c879ef2de47f710549c7ca41859793122bdbafce343bef3a653abe92",
"owner": null,
"ok": true,
"verb": "New",
"kind": "contract_call",
"who": "0xdcb39eb1c879ef2de47f710549c7ca41859793122bdbafce343bef3a653abe92",
"legs": [],
"count": 1,
"detail": "Agent",
"id": "3nowKBiMC1PXMjU2h7XdUetbtsq42gwEBXYg4g9WrmDX"
},
{
"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"
}
],
"leaders": [
{
"address": "0xdcb39eb1c879ef2de47f710549c7ca41859793122bdbafce343bef3a653abe92",
"product": "talus",
"txs": 543,
"volumeUsd": 34.80450282122019,
"lastMs": 1793889344596,
"owner": null,
"spark": [
6,
11,
1
]
},
{
"address": "0x47a3aa424fc14008f4dfeebef948d3e31c5c3d8c45f29b465e77330feac591a4",
"product": "talus",
"txs": 198,
"volumeUsd": 0.5985957581873681,
"lastMs": 1793709862960,
"owner": null,
"spark": [
0,
7,
0
]
},
{
"address": "0x1c4a98405fc29d73bd1e6e20a97863560d1c9a6a45436f25b0bc51bc5bb672df",
"product": "talus",
"txs": 169,
"volumeUsd": 0.5586375036850478,
"lastMs": 1793709851703,
"owner": null,
"spark": [
0,
3,
0
]
}
],
"series": {
"ends": [
1791432819882,
1791519219882,
1791605619882
],
"txs": {
"agent-contracts": [
24,
43,
14
],
"allowances": [
0,
0,
4
],
"t2000": [
745,
315,
2
],
"talus": [
2,
8,
12
],
"agent-pass": [
0,
0,
0
]
},
"active": [
43,
36,
5
],
"spend": [
0,
0,
0
],
"spendFrom": 28,
"passes": [
0,
0,
0
]
},
"logos": {
"agent-pass": "/coins/sui.svg",
"allowances": "/coins/sui.svg",
"gasless": "/coins/sui.svg",
"agent-payments": "/coins/sui.svg",
"t2000": "/protocols/t2000.webp",
"talus": "/protocols/talus.webp",
"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.