agents.wallet
One agent wallet: who it acts for, under what limits, how much it used and what it did.
Details
- Endpoint
- GET /v1/agents/wallet
- Credits
- 2
- Rate class
- Light. Counts against your light requests per second.
is_agent says whether tide knows the address as an AI agent wallet (Agent Pass agent, allowance spender, Sui Agent Payments delegate, t2000 wallet, Talus sender, agent contract caller). acting_for lists every link to an owner (Rel: agent, owner, product (agent-pass, allowances, agent-payments, t2000, talus, agent-contracts, sponsored), kind (pass, allowance, grant, gas, funding), object (the allowance, pass or grant id), name, allowed (the limits in words), used (how much is used, in words), status, net (mainnet or testnet), denied (payments refused on chain), sinceMs.) including who pays its gas. activity: its latest actions in plain English. week: transactions and outflow volume over 7 days.
Parameters
| Name | Type | Description |
|---|---|---|
| addressrequired | string | A 0x Sui address or a .sui name. |
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/wallet?address=0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6" \
-H "x-api-key: YOUR_API_KEY"TypeScript
const res = await fetch("https://api.tide.ad/v1/agents/wallet?address=0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6", {
headers: {
"x-api-key": process.env.TIDE_API_KEY!,
},
});
const data = await res.json();Response
JSON
{
"address": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"is_agent": true,
"summary": "Agent acting for adeniyi.sui under Agent Pass \"Buy SUI daily\".",
"products": [
"Sui Agent Pass",
"Allowances"
],
"acting_for": [
{
"agent": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "agent-pass",
"kind": "pass",
"object": "0x03c7bd6a3d4910f56fea05dedb632efd9824c82f22ef274180b7b8756ce47bac",
"name": "Buy SUI daily",
"allowed": "Rules set in the pass",
"used": null,
"status": "active",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793394931479
},
{
"agent": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "agent-pass",
"kind": "allowance",
"object": "0x76caf0bd4746d8626e40a454904f0a3ce2f65302fda73cdf512869c991e16031",
"name": "Buy SUI daily",
"allowed": "up to 3.5 USDC in total, until Nov 6, 2026",
"used": "1 of 3.5 USDC used",
"status": "active",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793394931479
},
{
"agent": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "allowances",
"kind": "allowance",
"object": "0x6a32c2945d8be35a078f4adb315ca4468968960a2854c700962b6831e7787939",
"name": "agent gas",
"allowed": "up to 0.1 SUI in total, at most 0.02 SUI per day, until Nov 6, 2026",
"used": "0.02 of 0.1 SUI used",
"status": "active",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793394931479
}
],
"activity": [
{
"digest": "3egaYmQfr6XnoBr62KmumhuqNPKji21mrnQ6ccq2hv4w",
"ms": 1793639272731,
"net": "mainnet",
"product": "agent-pass",
"sentence": "The agent swapped 0.5 USDC for 0.563 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.5633"
}
],
"detail": "Buy SUI daily",
"id": "3egaYmQfr6XnoBr62KmumhuqNPKji21mrnQ6ccq2hv4w"
},
{
"digest": "CU6mwHEZBugtZoAheBFQMV9orU6jdo4QbZqz5dzEddNX",
"ms": 1793478492454,
"net": "mainnet",
"product": "agent-pass",
"sentence": "The agent swapped 0.5 USDC for 0.555 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.555"
}
],
"detail": "Buy SUI daily",
"id": "CU6mwHEZBugtZoAheBFQMV9orU6jdo4QbZqz5dzEddNX"
},
{
"digest": "CBRA9oVA9faDKRae89eoZyofazNSWADiQRipYyBrEojm",
"ms": 1793478491219,
"net": "mainnet",
"product": "allowances",
"sentence": "0xb569…dab6 drew 0.02 SUI from adeniyi.sui's allowance \"agent gas\" (0.02 of 0.1 SUI used, the limit for the day is reached).",
"agent": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"ok": true,
"verb": "Drew",
"kind": "withdraw",
"who": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
"legs": [
{
"type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"amount": "0.02"
}
],
"id": "CBRA9oVA9faDKRae89eoZyofazNSWADiQRipYyBrEojm"
}
],
"week": {
"txs": 5,
"volumeUsd": 0.060987627586157264
},
"as_of": "2026-11-05T13:37:13.760Z",
"asOf": {
"checkpoint": 341929923,
"timestamp": "2026-11-05T13:37:13.760Z",
"lagMs": null
}
}