tide
Sui blockchain data in plain English: transactions, wallets, coins, balances, fund flows and SQL.
Should I use this
Quality & Safety
Findings (6)
- HIGH
- MEDIUMin explain_transaction
- MEDIUMin agent_wallet
- LOWin explain_transaction
- LOWin price
- LOWin candles
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://api.tide.ad/mcp"
}
}
}Remote endpoints
https://api.tide.ad/mcpstreamable-httpWhat it can do
Tool inventory
Tools (38)
🟢explain_transaction(digest)
Explain one Sui transaction in plain English: what happened, the steps, who gained or lost which coins (with USD), the fee and the status. Use it whenever you have a transaction digest. Example: { digest: "5ajkuHAnivMiKRne6EYS2bzvHpCHWYx849cmoSHN89Vm" }.
Input Schema
{
"type": "object",
"properties": {
"digest": {
"type": "string",
"description": "Transaction digest, base58 (43 or 44 characters)."
}
},
"required": [
"digest"
],
"additionalProperties": false
}🟢wallet_profile(address)
Everything about a wallet in one call: total value with price status, top coins, DeFi and launchpad positions, SuiNS names and labels, who first funded it, its trading record and its latest transactions. Use it first for any question about an address or a .sui name. Example: { address: "example.sui" }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢wallet_history(address, limit, cursor, coin, direction, ...)
A wallet's transactions since genesis, newest first, each as one decoded sentence with the coins in and out. Filter by coin, direction (in or out) and days. Page with cursor. Spam airdrops are left out. Example: { address: "0x...", limit: 10 }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
},
"limit": {
"type": "integer",
"description": "Rows per page, 1 to 25. Default 10.",
"minimum": 1,
"maximum": 25
},
"cursor": {
"type": "string",
"description": "The cursor from the previous result, for the next page."
},
"coin": {
"type": "string",
"description": "Only transactions that moved this coin (coin type or symbol)."
},
"direction": {
"type": "string",
"description": "Only coins coming in, or going out.",
"enum": [
"in",
"out"
]
},
"from": {
"type": "string",
"description": "First day to include, like 2025-06-01 (UTC)."
},
"to": {
"type": "string",
"description": "Last day to include, like 2025-06-30 (UTC)."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢balance_at(address, coin, time, checkpoint)
The exact balance a wallet held at a past time or checkpoint, read from full history. With coin, that coin's balance and the transaction that last changed it. Without coin, every coin it held then, valued at that time's prices. Example: { address: "example.sui", coin: "SUI", time: "2025-06-01T00:00:00Z" }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
},
"coin": {
"type": "string",
"description": "Coin type or symbol. Leave it out for all coins."
},
"time": {
"type": [
"string",
"integer"
],
"description": "A past time: ISO 8601 like 2025-06-01T00:00:00Z (UTC), or unix seconds."
},
"checkpoint": {
"type": "integer",
"description": "A checkpoint sequence number, instead of time.",
"minimum": 0
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢token_info(coin)
A coin's price, market cap, liquidity, volume and holder count, its safety checks (mint authority, deny list, concentration), its top 10 holders with linked-wallet clusters, and a report on its creator's past launches. Use it to judge a coin. Example: { coin: "DEEP" }.
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "A coin type like 0x2::sui::SUI, or a symbol like DEEP (verified coins win ties)."
}
},
"required": [
"coin"
],
"additionalProperties": false
}🟢trace_funds(address, direction, depth, coin, minUsd)
Follow money between addresses. direction in: who sent funds to this address, hop by hop back, plus who first funded it. out: where its funds went, hop by hop forward. both: its largest counterparties either way. Exchanges and protocols end a path. Returns the 15 largest flows. Example: { address: "0x...", direction: "in", depth: 2 }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
},
"direction": {
"type": "string",
"description": "in (sources), out (destinations) or both (top counterparties). Default in.",
"enum": [
"in",
"out",
"both"
]
},
"depth": {
"type": "integer",
"description": "Hops to follow, 1 to 3. Default 2.",
"minimum": 1,
"maximum": 3
},
"coin": {
"type": "string",
"description": "Only this coin (coin type or symbol)."
},
"minUsd": {
"type": "number",
"description": "Skip flows smaller than this many USD. Default 10."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢search(query, limit)
Find anything on Sui by text: coins by symbol or name, SuiNS names, perps markets, pools, packages, addresses, objects and digests. Returns ids to pass to the other tools. Example: { query: "deep" }.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search text, a symbol, a name.sui, an id or a digest."
},
"limit": {
"type": "integer",
"description": "Matches to return, 1 to 15. Default 8.",
"minimum": 1,
"maximum": 15
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢perp_market(market, venue)
One perpetual futures market on Sui (Aftermath, Bluefin or Parchment): mark and index price, 24h change and volume, open interest, funding (last, estimated next, when), max leverage, fees, the latest trades and pools it backs. Pass a symbol; venue is optional (the busiest market wins). Example: { market: "BTC", venue: "aftermath" }.
Input Schema
{
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Market symbol like BTC, META or SUI-PERP."
},
"venue": {
"type": "string",
"description": "aftermath, bluefin or parchment. Leave it out for the busiest.",
"enum": [
"aftermath",
"bluefin",
"parchment"
]
}
},
"required": [
"market"
],
"additionalProperties": false
}🟢price(coins, at)
USD prices for up to 50 coins, now or at a past time. Pass coin types or symbols. Example: { coins: ["SUI", "DEEP"] }.
Input Schema
{
"type": "object",
"properties": {
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coin types or symbols, up to 50 (up to 10 symbols).",
"minItems": 1,
"maxItems": 50
},
"at": {
"type": "string",
"description": "Optional past time: ISO 8601 or unix seconds."
}
},
"required": [
"coins"
],
"additionalProperties": false
}🟢sql(query, execution_id, limit, offset)
Run one SQL SELECT over every Sui transaction, event, object version and balance change since genesis. Needs an API key. Returns up to 100 rows; page with execution_id and offset. If it is still running, call again with execution_id. Tables and columns: https://api.tide.ad/v1/sql/schema. Example: { query: "SELECT sequence_number, total_transaction_blocks FROM sui.checkpoints ORDER BY sequence_number DESC LIMIT 5" }. Needs an API key.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "One SQL SELECT statement."
},
"execution_id": {
"type": "string",
"description": "The execution_id of an earlier run, to get its rows or more of them."
},
"limit": {
"type": "integer",
"description": "Rows to return, 1 to 100. Default 50.",
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"description": "Rows to skip, for the next page.",
"minimum": 0
}
},
"additionalProperties": false
}🟢explain_unsigned(tx_bytes, sender)
Check a Sui transaction before signing it: tide simulates it, explains what it would do in plain words, and checks every recipient, coin and package against full history. Returns safe, caution or danger with findings and evidence links. Block on danger. Pass tx_bytes (base64 TransactionData, or TransactionKind bytes with sender). Example: { tx_bytes: "AAAC..." }.
Input Schema
{
"type": "object",
"properties": {
"tx_bytes": {
"type": "string",
"description": "The unsigned transaction as base64: TransactionData, or TransactionKind bytes with sender."
},
"sender": {
"type": "string",
"description": "The signer. Required with TransactionKind bytes; with TransactionData it runs the check as this address."
}
},
"required": [
"tx_bytes"
],
"additionalProperties": false
}🟢yield_options(asset, kind, protocol, max_tier, min_apy, ...)
Every place on Sui to earn yield (lending, pools, liquid staking, native staking) with the APY each actually paid over 7 and 30 days, deposits, exit liquidity and a risk tier from 1 (lowest) to 5 with reasons. Filter by asset, kind, protocol, max_tier, min_apy; sort by tvl, apy, tier or exit. Example: { asset: "USDC", max_tier: 2, sort: "apy" }.
Input Schema
{
"type": "object",
"properties": {
"asset": {
"type": "string",
"description": "A coin symbol (USDC, SUI) or coin type. USDC and SUI mean the native coins."
},
"kind": {
"type": "string",
"description": "lending, lp, liquid_staking, staking or vault.",
"enum": [
"lending",
"lp",
"liquid_staking",
"staking",
"vault"
]
},
"protocol": {
"type": "string",
"description": "A protocol id or name, like navi, suilend, scallop or cetus."
},
"max_tier": {
"type": "integer",
"description": "Highest risk tier to include, 1 to 5.",
"minimum": 1,
"maximum": 5
},
"min_apy": {
"type": "number",
"description": "Lowest realized APY plus rewards, in percent."
},
"sort": {
"type": "string",
"description": "tvl (default), apy, tier or exit.",
"enum": [
"tvl",
"apy",
"tier",
"exit"
]
},
"limit": {
"type": "integer",
"description": "Rows, default 15, at most 50.",
"minimum": 1,
"maximum": 50
}
},
"additionalProperties": false
}🟢yield_plan(amount_usd, asset, target_apy, max_risk_tier, horizon_days, ...)
A ranked menu of 3 to 6 yield options on Sui for an amount: the realized APY used (never the advertised one), expected USD over the horizon, cost to get in and out at that size, risk tier with reasons, plain steps and links. Ranks options that reach target_apy first, then lowest risk. With build: true and sender it also returns the unsigned transaction for the top option, already dry-run and checked, ready for the wallet to sign. Example: { amount_usd: 5000, asset: "USDC", target_apy: 6, max_risk_tier: 2, build: true, sender: "0x..." }.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": "number",
"minimum": 1,
"description": "Amount in USD."
},
"asset": {
"type": "string",
"description": "The coin held: a symbol (USDC, SUI) or coin type."
},
"target_apy": {
"type": "number",
"minimum": 0,
"description": "Target APY in percent."
},
"max_risk_tier": {
"type": "integer",
"description": "Highest risk tier to accept, 1 (lowest) to 5. For the lowest risk, pass 1 or 2.",
"minimum": 1,
"maximum": 5
},
"horizon_days": {
"type": "integer",
"description": "Days you plan to stay, default 365.",
"minimum": 1,
"maximum": 3650
},
"build": {
"type": "boolean",
"description": "Also build the unsigned transaction for the top option (or build_ranks), checked on current mainnet state. Needs sender."
},
"sender": {
"type": "string",
"description": "With build: the wallet that holds asset and will sign."
},
"pass": {
"type": "string",
"description": "With build: an Agent Pass id instead of sender; builds for the pass's agent within the owner's rules, with a signed receipt."
},
"amount": {
"type": [
"number",
"string"
],
"description": "With build: amount of asset in whole coins. Default amount_usd at today's price."
},
"build_ranks": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 6
},
"description": "With build: option ranks to build, default [1], at most 3."
},
"slippage_pct": {
"type": "number",
"description": "With build: slippage for a swap into the option's coin, percent, default 0.5."
}
},
"required": [
"amount_usd"
],
"additionalProperties": false
}🟢build_transaction(sender, pass, action, amount, asset, ...)
Build an unsigned Sui transaction for an action and get it back already checked: tide adds the protocol's own calls, picks the sender's gas coins, sets the budget, dry-runs the exact bytes on current mainnet state and runs the pre-sign check. Returns tx_bytes, a plain description, what leaves and enters the wallet, gas and the verdict. If it would fail or the check says danger you get the reason and no bytes. Amounts are whole coins. Actions: stake {amount, validator}; unstake {staked_sui_id, validator, amount}; lst_mint {lst, amount}; lst_redeem {lst, amount}; swap {from, to, amount, slippage_pct}; supply {protocol, asset, amount}; withdraw {protocol, asset, amount}. Lending protocols: suilend, navi, scallop. Swaps use the Aftermath router with slippage_pct (default 0.5) enforced on chain. steps runs several actions in one transaction; a step without amount takes the previous output. tide never signs: sign tx_bytes with your own wallet. Example: { sender: "0x...", action: "supply", protocol: "navi", asset: "USDC", amount: 100 }.
Input Schema
{
"type": "object",
"properties": {
"sender": {
"type": "string",
"description": "The wallet that will sign (0x address). Not needed with pass."
},
"pass": {
"type": "string",
"description": "Agent Pass id: build for the pass's agent within the owner's rules (allowance, venues, caps, price floor), prechecked, with a signed receipt. Actions: swap, supply (NAVI), stake (validator address), transfer (listed recipient name); each step needs an amount."
},
"action": {
"type": "string",
"enum": [
"stake",
"unstake",
"lst_mint",
"lst_redeem",
"swap",
"supply",
"withdraw"
],
"description": "What to do."
},
"amount": {
"type": [
"number",
"string"
],
"description": "Whole coins, or \"all\" where allowed."
},
"asset": {
"type": "string",
"description": "supply / withdraw: the coin (USDC, SUI or a coin type)."
},
"protocol": {
"type": "string",
"description": "supply / withdraw: suilend, navi or scallop."
},
"lst": {
"type": "string",
"description": "lst_mint / lst_redeem: afSUI, haSUI, vSUI, sSUI, stSUI."
},
"from": {
"type": "string",
"description": "swap: coin to sell."
},
"to": {
"type": "string",
"description": "swap: coin to buy."
},
"slippage_pct": {
"type": "number",
"description": "swap: percent, default 0.5."
},
"validator": {
"type": "string",
"description": "stake / unstake: validator address or name (stake picks one when left out)."
},
"staked_sui_id": {
"type": "string",
"description": "unstake: one StakedSui object id."
},
"steps": {
"type": "array",
"items": {
"type": "object"
},
"description": "Instead of action: [{ action, ...fields }, ...] in one transaction."
}
},
"additionalProperties": true
}🟢withdraw_plan(wallet, exit, to, slippage_pct)
List a wallet's staking, liquid staking and lending positions (native stakes, afSUI, haSUI, vSUI, sSUI, stSUI, Suilend, NAVI, Scallop), each with an id and the step that exits it, and with exit build the exit transactions: unsigned, gassed and checked on current mainnet state, or the reason one would fail. to swaps the proceeds into one coin in the same transaction. Example: { wallet: "0x...", exit: "all", to: "USDC" }.
Input Schema
{
"type": "object",
"properties": {
"wallet": {
"type": "string",
"description": "The wallet that holds the positions and will sign (0x address)."
},
"exit": {
"type": [
"array",
"string"
],
"items": {
"type": "string"
},
"description": "Position ids to build exits for, or \"all\". Left out: only the list."
},
"to": {
"type": "string",
"description": "Swap each exit's proceeds into this coin."
},
"slippage_pct": {
"type": "number",
"description": "For that swap, percent, default 0.5."
}
},
"required": [
"wallet"
],
"additionalProperties": false
}🟢receipt_for_transaction(tx_bytes, intent)
Before you sign: send the exact unsigned bytes and your intent; tide dry-runs them on mainnet and returns a receipt signed by tide (ed25519) with the digest Sui will give them, every simulated balance change, object and event, what Sui itself enforces (Agent Pass caps, listed pools, price floor, budget), checks of your intent (max_spend, min_receive, nothing else leaves the wallet) and a verdict. Give your human the url. After sending, call confirm_execution. Example: { tx_bytes: "AAAC...", intent: { action: "swap", max_spend: { USDC: "5" }, min_receive: { SUI: "4.9" } } }.
Input Schema
{
"type": "object",
"properties": {
"tx_bytes": {
"type": "string",
"description": "Full unsigned TransactionData, base64 (sender, gas and budget set)."
},
"intent": {
"type": "object",
"description": "What you mean to do. Optional fields: action, pass (Agent Pass id), wallet, max_spend { coin: amount }, min_receive { coin: amount }, deadline_ms. Amounts in whole coins."
}
},
"required": [
"tx_bytes"
],
"additionalProperties": false
}🟢confirm_execution(digest, receipt)
After execution: give the executed digest and the receipt (its id, or the receipt object). tide reads the transaction from the chain and compares status, balance changes, objects and events with the receipt. Returns match, or each difference in one plain sentence to report to your human (also not_executed, or other_transaction when the signed bytes were not the receipt's). Example: { digest: "CRDt...", receipt: "8e56072be767fadb73a18169d8dcfc3c" }.
Input Schema
{
"type": "object",
"properties": {
"digest": {
"type": "string",
"description": "Executed transaction digest."
},
"receipt": {
"type": [
"string",
"object"
],
"description": "Receipt id, or the receipt object."
}
},
"required": [
"digest",
"receipt"
],
"additionalProperties": false
}🟢verify_receipt(receipt, signature, public_key)
Check a receipt's ed25519 signature against tide's published key (https://api.tide.ad/.well-known/tide-attest.json), that its id matches its content, and that its digest is the blake2b digest of the bytes inside it. Pass the receipt id or the receipt object with its signature. Example: { receipt: "8e56072be767fadb73a18169d8dcfc3c" }.
Input Schema
{
"type": "object",
"properties": {
"receipt": {
"type": [
"string",
"object"
],
"description": "Receipt id, or the receipt object (or the whole answer of receipt_for_transaction)."
},
"signature": {
"type": "object",
"description": "The signature object, when the receipt object is passed alone."
},
"public_key": {
"type": "string",
"description": "Check against this ed25519 public key (base64) instead of tide's."
}
},
"required": [
"receipt"
],
"additionalProperties": false
}🟢agent_pass_report(owner, pass, limit)
A report for a human on Agent Pass (Sui's on-chain agent authorization): for an owner, an agent or one pass, each pass's status, its rules in plain words (pools, caps, price floor, recipients), budgets left, today's usage and every transaction signed under it, including what Sui refused and why. Example: { owner: "0x1eb7...e0b1" } or { pass: "0x03c7...7bac" }.
Input Schema
{
"type": "object",
"properties": {
"owner": {
"type": "string",
"description": "Owner or agent address."
},
"pass": {
"type": "string",
"description": "Pass object id."
},
"limit": {
"type": "integer",
"description": "Transactions per pass, 1 to 100. Default 15.",
"minimum": 1,
"maximum": 100
}
},
"additionalProperties": false
}🟢agent_pass_precheck(pass, sender, step)
Before building: check one action against an Agent Pass's rules as they stand now (active, signer is the agent, rule for the coin or pair, per-action and daily limits, listed pools, price floor, named recipient, budget left). Returns accept or the rule that would refuse it. Example: { pass: "0x03c7...7bac", step: { action: "swap", coin_in: "USDC", coin_out: "SUI", amount: "0.2" } }.
Input Schema
{
"type": "object",
"properties": {
"pass": {
"type": "string",
"description": "Pass object id."
},
"sender": {
"type": "string",
"description": "Your agent address."
},
"step": {
"type": "object",
"description": "{ action: swap|transfer|stake|supply, coin_in, coin_out, coin, amount, min_out, recipient (a name the owner listed), validator }"
}
},
"required": [
"pass",
"step"
],
"additionalProperties": false
}🟢agents_overview
The agent world on Sui: agent wallets active in 24 hours, their transactions and volume, Agent Passes, sui::allowance spend, Sui Agent Payments (testnet, mainnet when live), gasless and sponsored transactions, every agent product with its status (mainnet, testnet, announced), the latest agent actions in plain English and the most active agents this week. Example: {}.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢agent_wallet(address)
Is this address an AI agent, who does it act for and under what limits (Agent Pass, sui::allowance, Sui Agent Payments grant, t2000, Talus), how much of each limit is used, who pays its gas, and what it did lately in plain English. Example: { address: "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6" }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A 0x Sui address or a .sui name."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢owner_agents(address)
The AI agents one address runs on Sui: Agent Passes, allowances it granted, Sui Agent Payments grants, t2000 wallets it funded and agent wallets it pays gas for; per agent the limits in words, how much is used, payments refused on chain, and their latest actions. Example: { address: "adeniyi.sui" }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A 0x Sui address or a .sui name."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢billing_status
Your credits: what the plan has left this month, prepaid credits bought with USDC, the rate ($3 per million credits, so 1 USDC buys 333,333 credits), auto top-up settings and the latest payments. Needs an API key. Free. Example: {}. Needs an API key.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢billing_topup(usd, address, gas)
Build an unsigned transaction that pays USDC on Sui to tide's treasury for credits ($3 per million credits; 1 USDC buys 333,333). Returns base64 tx_bytes that need no SUI for gas (unless gas: true). Sign them with the paying address and send them, or POST them with the signature to https://api.tide.ad/v1/billing/topup/submit. Credits land on the paying address's account about a second after the transaction is final. With an API key the key's account pays; without one pass address. Free. Example: { usd: "10" }.
Input Schema
{
"type": "object",
"properties": {
"usd": {
"type": "string",
"description": "USD of USDC to pay, at least 1, like \"10\" or \"25.50\"."
},
"address": {
"type": "string",
"description": "The paying Sui address, when you have no API key."
},
"gas": {
"type": "boolean",
"description": "true to pay gas in SUI instead of building a gasless transaction."
}
},
"required": [
"usd"
],
"additionalProperties": false
}🟢get_object(id)
Read any Sui object by id: type, owner, version and fields, with its recent change history (which transactions changed it). Example: { id: "0x..." }.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Object id."
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢get_object_at(id, version, time, checkpoint)
Read a Sui object as it was at a version, checkpoint or time: its fields and owner then, or whether it was deleted or wrapped. Use it for what a pool, vault or position looked like before a change. Example: { id: "0x...", time: "2026-10-30T00:00:00Z" }.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Object id."
},
"version": {
"type": "integer",
"description": "Object version."
},
"time": {
"type": [
"string",
"integer"
],
"description": "A past time: ISO 8601 like 2025-06-01T00:00:00Z (UTC), or unix seconds."
},
"checkpoint": {
"type": "integer",
"description": "A checkpoint sequence number, instead of time.",
"minimum": 0
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢object_children(id, depth, cursor, limit)
List the dynamic fields of an object with decoded names and values (tables, bags, kiosks, pools, registries), or with depth 1 to 3, its tree of children. Page with cursor. Example: { id: "0x..." }.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Parent object id."
},
"depth": {
"type": "integer",
"description": "1 to 3 for the tree of children instead of one page of fields.",
"minimum": 1,
"maximum": 3
},
"cursor": {
"type": "string",
"description": "The cursor from the previous result, for the next page."
},
"limit": {
"type": "integer",
"description": "Fields per page, up to 50."
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢package_info(id, module, function, window)
A Move package. With only id: its modules, functions and upgrade history. With module and function: how to call it, each parameter explained, with a TypeScript snippet. With window (24h, 7d or 30d): calls per day and per function, failures and top callers. Example: { id: "0x2", module: "coin", function: "split" }.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Package id."
},
"module": {
"type": "string",
"description": "Module name, with function."
},
"function": {
"type": "string",
"description": "Function name, with module."
},
"window": {
"type": "string",
"description": "24h, 7d or 30d, for usage.",
"enum": [
"24h",
"7d",
"30d"
]
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢events(type, package, limit, cursor, fromTime, ...)
List on-chain events by Move event type or by package, newest first, with an optional time or checkpoint range. Page with cursor. Example: { type: "0x...::pool::SwapEvent", limit: 10 }.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Full Move event type."
},
"package": {
"type": "string",
"description": "Package id, instead of type."
},
"limit": {
"type": "integer",
"description": "Rows per page, up to 50. Default 10."
},
"cursor": {
"type": "string",
"description": "The cursor from the previous result, for the next page."
},
"fromTime": {
"type": "string",
"description": "Start time, ISO 8601."
},
"toTime": {
"type": "string",
"description": "End time, ISO 8601."
}
},
"additionalProperties": false
}🟢checkpoint(seq)
One checkpoint by sequence number, or the newest with seq "latest": time, epoch, gas totals and its transactions as one-line sentences. Use it to see what is happening on chain right now. Example: { seq: "latest" }.
Input Schema
{
"type": "object",
"properties": {
"seq": {
"type": "string",
"description": "Checkpoint sequence number, or latest."
}
},
"additionalProperties": false
}🟢candles(coin, interval, from, to)
OHLCV price candles for a coin, in USD. Pick interval and an optional from and to. Example: { coin: "SUI", interval: "1h" }.
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "A coin type like 0x2::sui::SUI, or a symbol like DEEP (verified coins win ties)."
},
"interval": {
"type": "string",
"description": "Candle size: 1m, 5m, 15m, 1h, 4h or 1d. Default 1h."
},
"from": {
"type": "string",
"description": "Start time, ISO 8601 or unix seconds."
},
"to": {
"type": "string",
"description": "End time."
}
},
"required": [
"coin"
],
"additionalProperties": false
}🟢nfts(address, limit, cursor)
The NFTs and kiosk items an address owns: name, collection, image and listing state. Page with cursor. Example: { address: "example.sui" }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
},
"limit": {
"type": "integer",
"description": "Items per page, up to 50. Default 10."
},
"cursor": {
"type": "string",
"description": "The cursor from the previous result, for the next page."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢staking(address, validator)
With address: the wallet's staked SUI, per stake its validator, principal, rewards and status. With validator: that validator's stake, commission and APY per epoch. Example: { address: "example.sui" }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
},
"validator": {
"type": "string",
"description": "Validator address, for its history."
}
},
"additionalProperties": false
}🟢order_book(pool, address, levels)
DeepBook order books. With nothing: every pool with best bid, ask and 24h volume. With pool: its depth and latest trades. With address: the wallet's open orders and recent fills. Example: { pool: "0x..." }.
Input Schema
{
"type": "object",
"properties": {
"pool": {
"type": "string",
"description": "Pool object id."
},
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
},
"levels": {
"type": "integer",
"description": "Price levels per side for depth. Default 10."
}
},
"additionalProperties": false
}🟢walrus_blob(id)
Everything about one Walrus blob: status (registered, certified, expired, deleted), owner and uploader, size, the register and certify transactions, start and end epoch with an estimated end date, deletable or permanent, shared blob funds, extensions, WAL paid, attributes, and what the content is (image, video, audio, pdf, json, markdown, csv, code, text, html, quilt with its patches, Seal encrypted with its policy package, binary), with a preview URL. Takes a blob id, a quilt patch id, the u256 or a Blob object id. Example: { id: "FHQl1gK7Rb5X5X3Q-DiNe4qvyTojL262p0JUn-ijQkQ" }.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Blob id (43 characters), quilt patch id (50 characters), u256 in decimal or 0x hex, or a Blob object id."
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢address_kind(address)
Tell what an address is: a plain key (ed25519, secp256k1, secp256r1), a passkey, a zkLogin address (with its provider), a multisig (members and threshold), an object, a package, or an address that never signed. Example: { address: "0x..." }.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "A Sui address (0x...), a SuiNS name like example.sui, or @example."
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢docs(question, limit)
Search the tide API docs for the method that answers a question, with its parameters, credits and a curl example. Use it when no other tool fits; then call the method over REST at https://api.tide.ad. Example: { question: "transfers of a coin between two times" }.
Input Schema
{
"type": "object",
"properties": {
"question": {
"type": "string",
"description": "What you want to do, in plain words."
},
"limit": {
"type": "integer",
"description": "Matches, 1 to 8. Default 3.",
"minimum": 1,
"maximum": 8
}
},
"required": [
"question"
],
"additionalProperties": false
}Community
Evidence