agents.owner
The AI agents one address runs: passes, allowances granted, payment grants, funded and sponsored agent wallets.
Details
- Endpoint
- GET /v1/agents/owner
- Credits
- 2
- Rate class
- Light. Counts against your light requests per second.
is_owner says whether the address runs any agent. agents: one entry per agent wallet with every link to it (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.). The limits are in words with how much is used, and denied counts payments its agents tried that the chain refused. activity: the latest actions by or for those agents.
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/owner?address=adeniyi.sui" \
-H "x-api-key: YOUR_API_KEY"TypeScript
const res = await fetch("https://api.tide.ad/v1/agents/owner?address=adeniyi.sui", {
headers: {
"x-api-key": process.env.TIDE_API_KEY!,
},
});
const data = await res.json();Response
JSON
{
"address": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"is_owner": true,
"summary": "Runs 4 agents: 3 Agent Passes, 6 allowances granted, funded 1 t2000 wallet.",
"agents": [
{
"agent": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"via": [
{
"agent": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "agent-pass",
"kind": "pass",
"object": "0x2d664c7931c12f9c30a8d9730899dc906cfaff99e059afcb769ef71e17a0c931",
"name": "Buy ZUK daily",
"allowed": "Rules set in the pass",
"used": null,
"status": "closed",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793395628327
},
{
"agent": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "allowances",
"kind": "allowance",
"object": "0x94e231850c6f00eefdc250b411d34d872506d1d329b6e2be8928dbb294348441",
"name": "agent gas",
"allowed": "up to 0.1 SUI in total, at most 0.02 SUI per day, until Nov 3, 2026",
"used": "0.02 of 0.1 SUI used",
"status": "expired",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793395628327
}
]
},
{
"agent": "0x9092189663ea723a2760e1eb8960f1ae4d9bed53e9a3b269496126e4a93d9056",
"via": [
{
"agent": "0x9092189663ea723a2760e1eb8960f1ae4d9bed53e9a3b269496126e4a93d9056",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "agent-pass",
"kind": "pass",
"object": "0xa2bfff824e479c229356bfec6db6ace8d10b9b85dd48624b3593796f229dae6c",
"name": "Buy LOFI daily",
"allowed": "Rules set in the pass",
"used": null,
"status": "closed",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793395425105
},
{
"agent": "0x9092189663ea723a2760e1eb8960f1ae4d9bed53e9a3b269496126e4a93d9056",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"product": "agent-pass",
"kind": "allowance",
"object": "0xad61d6fc9214a9741b7e3a489c7fb05ee4e0b050d47c71c0718222932ba3436f",
"name": "Buy LOFI daily",
"allowed": "up to 4 SUI in total, until Nov 3, 2026",
"used": "2 of 4 SUI used",
"status": "expired",
"net": "mainnet",
"denied": 0,
"sinceMs": 1793395425105
}
]
}
],
"activity": [
{
"digest": "3wXehURheXxX8Rg22yxF3KV4oRc3Tda4mtzH6cqhNubx",
"ms": 1793639322058,
"net": "mainnet",
"product": "agent-pass",
"sentence": "The agent swapped 0.333 SUI for 898.54 ZUK on Cetus.",
"agent": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"ok": true,
"verb": "Swapped",
"kind": "swap",
"who": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"legs": [
{
"type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"amount": "-0.3333"
},
{
"type": "0x42ba9220e980b4819e4df208dd50013d0bbbfde142996e8db1319ac61f879205::zuk::ZUK",
"symbol": "ZUK",
"amount": "+898.54"
}
],
"detail": "Buy ZUK daily",
"id": "3wXehURheXxX8Rg22yxF3KV4oRc3Tda4mtzH6cqhNubx"
},
{
"digest": "2A8VxCgeXRdFaXRbuKdBEzkXi3NrGdbAJZwufWadJgyD",
"ms": 1793639319652,
"net": "mainnet",
"product": "agent-pass",
"sentence": "The agent swapped 0.333 SUI for 898.74 ZUK on Cetus.",
"agent": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
"ok": true,
"verb": "Swapped",
"kind": "swap",
"who": "0xd6019993e0b4f1d6b1e93ca9252a3a71b80834363355a29b63d04e21aa7bb238",
"legs": [
{
"type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"amount": "-0.3333"
},
{
"type": "0x42ba9220e980b4819e4df208dd50013d0bbbfde142996e8db1319ac61f879205::zuk::ZUK",
"symbol": "ZUK",
"amount": "+898.74"
}
],
"detail": "Buy ZUK daily",
"id": "2A8VxCgeXRdFaXRbuKdBEzkXi3NrGdbAJZwufWadJgyD"
}
],
"as_of": "2026-11-05T13:37:13.760Z",
"asOf": {
"checkpoint": 341929923,
"timestamp": "2026-11-05T13:37:13.760Z",
"lagMs": null
}
}Long lists are cut to a few items here.