# tide API

> Sui data for apps and agents: assets (one shape for NFTs, kiosk items, SuiNS names and coins), parsed transactions with plain-language explanations, full address history since genesis, wallets, coins, streams and webhooks. Every answer carries asOf, the index position it is true at.

## Base URLs

- REST: https://api.tide.ad/v0/... and https://api.tide.ad/v1/...
- JSON-RPC 2.0: POST https://api.tide.ad/ (also /rpc), batches up to 100
- MCP (streamable HTTP): https://api.tide.ad/mcp
- WebSocket: wss://api.tide.ad/ and SSE https://api.tide.ad/v1/stream

## Auth

- Pass a key as ?api-key=KEY, header x-api-key: KEY or Authorization: Bearer KEY.
- No key needed to try it: the keyless tier allows 2 requests/s and 1,000 credits a day per IP.
- Free keys need no email: https://tide.ad/developers/keys, or POST /v0/keys/agent with a signed challenge.
- Free is for one person: one IP makes at most 3 new free accounts a day (10 per /24 or /64), Free accounts on one network share 7,500,000 credits a month, and an address with no on-chain history gets 1,000 credits a day until it makes a transaction or tops up. Prepaid USDC credits are never pooled.
- Paid plans (Developer, Business, Professional, Enterprise): join the tide Telegram, t.me/tide_sui. Subscriptions are coming soon.
- Add fields=a,b.c to trim any answer and view=compact to drop explain text and raw blocks.

## MCP for agents

- Endpoint: https://api.tide.ad/mcp (Streamable HTTP, stateless). Works keyless; add Authorization: Bearer KEY for more.
- Claude Code: claude mcp add --transport http tide https://api.tide.ad/mcp
- Configs for Claude Desktop, Cursor and VS Code: https://tide.ad/docs/mcp
- Skill for coding agents: https://tide.ad/skills/tide/SKILL.md
- Every tool returns a plain-English summary, compact facts and a tide.ad link. Tools (credits per call):
  - explain_transaction: a transaction in plain English: sentence, steps, balance changes, fee, status (1)
  - wallet_profile: a wallet: total value, top coins, positions, names and labels, first funder, trading record, recent transactions (10)
  - wallet_history: a wallet's transactions since genesis as decoded sentences; filters and cursor (5)
  - balance_at: exact balance at a past time or checkpoint, or all coins held then (5)
  - token_info: a coin: price, market cap, liquidity, holders, safety, top holders with clusters, creator report (5)
  - trace_funds: where money came from or went, hop by hop, plus the first funder (10)
  - search: coins, SuiNS names, perps markets, pools, packages, addresses, digests (1)
  - price: USD prices for up to 50 coins, now or at a past time (1)
  - perp_market: a perps market on Aftermath or Bluefin: mark and index price, volume, open interest, funding, leverage, fees, latest trades (1)
  - explain_unsigned: pre-sign check: simulate an unsigned transaction, explain it, verdict safe, caution or danger with evidence (10)
  - sql: one SQL SELECT over all of Sui (API key only) (1 + run)
  - get_object, get_object_at, object_children, package_info, events, checkpoint, candles, nfts, staking, order_book, address_kind, docs: specialist reads (0 to 10)

## Pay with USDC

- Rate: $3 per million credits (1 USDC = 333,333 credits), native USDC on Sui mainnet. Prepaid credits never expire and are spent after the plan's monthly credits run out.
- Top up at https://tide.ad/developers/billing, or POST /v1/billing/topup {usd, gas?} for unsigned txBytes, sign, then POST /v1/billing/topup/submit {txBytes, signature}. GET /v1/billing shows the balance. These calls are free.
- Treasury: 0x3d651ddf154835f6cd20e107a9a957b05cc701b9a492a7f680a0a4c3b5d8b0f1. Any USDC transfer from your account's address to it is credited automatically, once per digest.
- Auto top-up with sui::allowance: POST /v1/billing/allowance, sign the grant, POST /v1/billing/allowance/confirm {digest}. Revoke on chain at any time.
- No account needed: a request over the keyless limit, or with a key out of credits, gets HTTP 402: every offer in the body (accepts, x402 v2, network sui:mainnet; mpp, MPP challenges), plus a compact PAYMENT-REQUIRED header and one WWW-Authenticate: Payment challenge. Offers: $0.01, $1, $10. GET /v1/billing/offers lists them.
- x402: send exactly amount of asset to payTo in a gasless transaction (balance::send_funds, ValidDuring from extra.validDuring), sign it, retry with PAYMENT-SIGNATURE: base64 {x402Version: 2, accepted, payload: {signature, transaction}}. The answer carries PAYMENT-RESPONSE and X-Tide-Api-Key.
- X-Tide-Api-Key is derived from the payer address (same every time). Use it as Authorization: Bearer KEY.
- MCP: billing_status shows credits, billing_topup {usd, address?, gas?} returns unsigned tx_bytes.
- Details: https://tide.ad/docs/plans#pay-with-usdc

## Sign in with Google (zkLogin)

- Give every Google user a Sui address in your app. Register your OAuth client id first: POST /v1/zklogin/clients {clientId, jwt?}. Only ID tokens whose aud is registered to your key are accepted.
- POST /v1/zklogin/salt {jwt}: the user's salt and address (the same every time). POST /v1/zklogin/proof {jwt, extendedEphemeralPublicKey, maxEpoch, randomness}: proof inputs with addressSeed for getZkLoginSignature or ZkLoginSigner.
- Salts, backups and imports are free. Proofs: 50,000 new proofs a month free per app, then 1,000 credits each; the same request again is cached and free.
- Moving existing users: POST /v1/zklogin/import {clientId, users: [{subHash, salt}]} keeps their addresses (subHash = hex SHA-256 of sub).
- Backups: POST /v1/zklogin/backup {jwt} returns a recovery kit (iss, aud, sub, salt, address) and a short code. With it and their Google account a user can rebuild the wallet with any standard zkLogin prover. Check one at https://tide.ad/docs/login/recover. Browser helper with a backup button: https://tide.ad/sdk/zklogin.js
- Guide: https://tide.ad/docs/login

## Links

- Full reference with parameters and curl examples: https://api.tide.ad/llms-full.txt
- OpenAPI 3.1: https://api.tide.ad/openapi.json
- Method catalog as JSON: https://api.tide.ad/catalog.json
- Docs: https://tide.ad/docs
- Plans and pricing: https://tide.ad/docs/plans
- Your API keys, usage and billing: https://tide.ad/developers

## Assets

NFTs, kiosk items, SuiNS names and coins in one asset shape.

- getAsset (JSON-RPC getAsset, 2 credits): One asset: an NFT, kiosk item, SuiNS name, other object, or a coin type.
- getAssetBatch (JSON-RPC getAssetBatch, varies credits): Up to 1,000 assets by id in one call.
- getAssetsByOwner (JSON-RPC getAssetsByOwner, 5 credits): Everything an address holds: NFTs (including those in its kiosks), SuiNS names and optionally coins.
- getAssetsByGroup (JSON-RPC getAssetsByGroup, 5 credits): The items of one collection.
- searchAssets (JSON-RPC searchAssets, 5 credits): Find assets by owner, collection, name, traits or kind.
- getTransactionsForAsset (JSON-RPC getTransactionsForAsset, 5 credits): Every transaction that changed an object, newest first.
- getKiosk (JSON-RPC getKiosk, 2 credits): A kiosk: who controls it, what is in it, and what is listed at what price.
- kiosk.policies (GET /v1/kiosk/policies/:type, 2 credits): Transfer policies and rules (royalty, kiosk lock, floor price) for an NFT type.

## Transactions

Parsed transactions with plain-language explanations.

- tx.parse (POST /v0/transactions, varies credits): Parse up to 100 transaction digests into typed, described transactions.
- getTransaction (JSON-RPC getTransaction, 1 credits): One parsed transaction by digest.
- getTransactionBlock (JSON-RPC getTransactionBlock, 1 credits): The raw transaction as the Sui node reports it.

## History

Full address history since genesis.

- tx.history (GET /v0/addresses/:address/transactions, 10 credits): Parsed transaction history of an address, filterable by type, source, time and checkpoint.
- getTransactionsForAddress (JSON-RPC getTransactionsForAddress, varies credits): Full history of an address with sort order, filters and a pagination token.
- bridge.transfers (GET /v1/wallet/:wallet/bridge, 3 credits): Sui Bridge transfers of a wallet, out of Sui and into Sui, newest first.

## Wallet

Balances, identity, PnL, positions and holdings at any time.

- wallet.balances (GET /v1/wallet/:wallet/balances, 10 credits): Every coin a wallet holds now, with USD value, sorted by value.
- wallet.nfts (GET /v1/wallet/:wallet/nfts, 10 credits): NFTs and kiosk items a wallet holds now.
- wallet.balanceAt (GET /v1/wallet/:wallet/balance-at, 10 credits): A wallet's balance of one coin at a past time or checkpoint.
- wallet.holdingsAt (GET /v1/wallet/:wallet/holdings-at, 20 credits): Every coin a wallet held at a past time, with USD at that time.
- wallet.history (GET /v1/wallet/:wallet/history, 10 credits): A wallet's transactions with its balance changes, all history, both directions.
- wallet.transfers (GET /v1/wallet/:wallet/transfers, 10 credits): A wallet's coin transfers in and out with the counterparty.
- wallet.identity (GET /v1/wallet/:wallet/identity, 1 credits): Who a wallet is: known label and SuiNS names.
- wallet.batchIdentity (POST /v1/wallet/batch-identity, varies credits): Identity of up to 100 wallets in one call.
- wallet.fundedBy (GET /v1/wallet/:wallet/funded-by, 10 credits): Who first sent SUI to a wallet.
- wallet.pnl (GET /v1/wallet/:wallet/pnl, 10 credits): Realized and unrealized profit and loss per coin for a wallet.
- wallet.positions (GET /v1/wallet/:wallet/positions, 10 credits): A wallet's DeFi positions: liquidity, lending, staking and vaults.
- wallet.linked (GET /v1/wallet/:wallet/linked, 10 credits): Wallets that look related to this one.
- address.kind (GET /v1/address/:address/kind, 2 credits): What a Sui address is: key scheme, zkLogin, multisig, passkey, object or package.
- agentPass.report (GET /v1/agent-pass/report, 5 credits): Agent Pass report: an owner's (or agent's) passes, their rules in plain words, spend against caps and every action, for a human.
- agentPass.precheck (POST /v1/agent-pass/precheck, 2 credits): Will this Agent Pass accept the action? Each rule checked before anything is signed.

## Coins and markets

Prices, candles, holders, trades, pools and safety checks.

- coins.get (GET /v1/coins/:type, 1 credits): One coin: metadata, supply, price, market cap, volume, liquidity, holders and who holds the TreasuryCap.
- coins.prices (POST /v1/prices, varies credits): USD prices for up to 100 coins, now or at a past time.
- coins.candles (GET /v1/coins/:type/candles, 2 credits): OHLCV candles for a coin at 1 second to 1 week intervals.
- coins.holders (GET /v1/coins/:type/holders, 5 credits): Top holders of a coin, ranked by balance, with the USD value of each.
- coins.trades (GET /v1/coins/:type/trades, 2 credits): Recent DEX trades of a coin, newest first.
- coins.pools (GET /v1/coins/:type/pools, 2 credits): The busiest liquidity pools for a coin, with TVL and 24 hour volume.
- coins.security (GET /v1/coins/:type/security, 2 credits): Launch safety for a coin: TreasuryCap and deny list status, honeypot flag, and a list of checks.
- markets.top (GET /v1/markets, 2 credits): Ranked coin lists: trending, top, new, gainers, losers, bonding and graduated.
- coins.holdersAt (GET /v1/coins/:type/holders-at, 25 credits): The top holders of a coin at a past time or checkpoint.

## Chain

Objects, events, checkpoints, epochs, validators, packages, names and search.

- objects.get (GET /v1/objects/:id, 1 credits): One object: type, owner, version and fields as they are now.
- objects.history (GET /v1/objects/:id/history, 5 credits): Every version of an object since it was created, either direction.
- events.list (GET /v1/events, 5 credits): Move events by type or package in any time or checkpoint range.
- checkpoints.get (GET /v1/checkpoints/:seq, 1 credits): One checkpoint: header, gas and its transactions.
- epochs.list (GET /v1/epochs, 1 credits): Epochs, newest first, with gas price and transaction counts.
- validators.list (GET /v1/validators, 1 credits): The active validator set with stake, voting power, APY and commission.
- packages.get (GET /v1/packages/:id, 1 credits): A Move package: versions, modules, functions and dependencies.
- names.resolve (GET /v1/names/:name, 1 credits): Resolve a SuiNS name to the address it points at.
- names.reverse (GET /v1/names/reverse/:address, 1 credits): The SuiNS names of an address.
- search (GET /v1/search, 1 credits): Find coins, names, packages, collections, addresses, objects and transactions.

## Simulate

Dry-run a transaction before signing and get it explained.

- tx.simulate (POST /v1/tx/simulate, 10 credits): Check a transaction before signing: what it would do, what it would cost, or why it would fail.
- simulateTransaction (JSON-RPC simulateTransaction, 10 credits): Check a transaction before signing: what it would do, what it would cost, or why it would fail.
- tx.check (POST /v1/tx/check, 10 credits): Pre-sign check: simulate an unsigned transaction, explain it and judge every counterparty, with a verdict and evidence.
- checkTransaction (JSON-RPC checkTransaction, 10 credits): Pre-sign check: simulate an unsigned transaction, explain it and judge every counterparty, with a verdict and evidence.
- tx.receipt (POST /v1/tx/receipt, 10 credits): Signed receipt for unsigned bytes: simulated effects, Agent Pass policy check, intent checks and a verdict, signed by tide.
- receipts.get (GET /v1/receipts/:id, 1 credits): A signed receipt by id.
- receipts.verify (POST /v1/receipts/verify, 1 credits): Check a receipt's signature and that its digest is the digest of its bytes.
- tx.receiptCheck (GET /v1/tx/:digest/receipt-check, 2 credits): After execution: compare the transaction's actual effects with its receipt.
- tx.receiptCheckPost (POST /v1/tx/:digest/receipt-check, 2 credits): After execution: compare actual effects with a receipt you send in the body.

## Build

Unsigned transactions for staking, liquid staking, lending and swaps, checked before you sign. tide never signs.

- tx.build (POST /v1/tx/build, 15 credits): Build an unsigned transaction for stake, liquid staking, lending or a swap, gassed and checked on current mainnet state.
- buildTransaction (JSON-RPC buildTransaction, 15 credits): Build an unsigned transaction for stake, liquid staking, lending or a swap, gassed and checked on current mainnet state.
- yield.withdrawPlan (POST /v1/yield/withdraw-plan, varies credits): A wallet's staking, liquid staking and lending positions, each with the step that exits it, and the exits built and checked on request.

## Objects and fields

Objects at any version, dynamic fields and object trees.

- objects.at (GET /v1/objects/:id/at, 5 credits): An object as it was at a version, checkpoint or time, with its contents.
- objects.dynamicFields (GET /v1/objects/:id/dynamic-fields, 2 credits): The dynamic fields of an object, with decoded names and values.
- objects.tree (GET /v1/objects/:id/tree, 10 credits): Everything an object holds: dynamic fields, tables, wrapped structs and kiosk items.

## Packages

Move ABIs, upgrade history, usage, callers and ready-to-use call templates.

- packages.abi (GET /v1/packages/:id/abi, 2 credits): The full Move interface of a package: modules, functions, structs, enums and events.
- packages.versions (GET /v1/packages/:id/versions, 2 credits): Every version of a package with publisher, time and the modules each upgrade added or removed.
- packages.usage (GET /v1/packages/:id/usage, 10 credits): How a package is used: calls per day, per function, unique senders, failure rate and events.
- packages.callers (GET /v1/packages/:id/callers, 10 credits): The top senders that call a package, with call counts, last call time and success rate.
- packages.howToCall (GET /v1/packages/:id/functions/:module/:function/call, 1 credits): How to call one Move function from a PTB: parameters explained, a TypeScript snippet and a JSON PTB.

## AI agents

What AI agents do on Sui: agent wallets, the limits their owners set (Agent Pass, allowances, Agent Payments grants), what they spend and do, live.

- agents.overview (GET /v1/agents/overview, 1 credits): What AI agents do on Sui right now: active agent wallets, spend under allowances, payments, products and a live feed.
- agents.feed (GET /v1/agents/feed, 1 credits): The latest actions of AI agents on Sui, one plain-English line each.
- agents.wallet (GET /v1/agents/wallet, 2 credits): One agent wallet: who it acts for, under what limits, how much it used and what it did.
- agents.owner (GET /v1/agents/owner, 2 credits): The AI agents one address runs: passes, allowances granted, payment grants, funded and sponsored agent wallets.

## Yield

Every place on Sui to earn yield, with realized rates and an evidence-based risk readout, and a ranked plan for an amount.

- yield.options (GET /v1/yield/options, 2 credits): Every place on Sui to earn yield: lending, pools, liquid staking and native staking, with realized APY and a risk readout.
- yield.plan (POST /v1/yield/plan, varies credits): A ranked menu of 3 to 6 yield options for an amount, with expected USD yield, exit cost, risk and steps; with build: true, the unsigned transactions to do it, checked.

## Staking

Stakes with rewards so far, and validator history per epoch.

- wallet.stakes (GET /v1/wallet/:wallet/stakes, 3 credits): A wallet's staked SUI: validator, status and rewards so far.
- validators.history (GET /v1/validators/:address/history, 2 credits): One validator across epochs: stake, voting power, commission, gas price, rewards, APY.

## Order books

DeepBook pools, depth, trades and open orders.

- books.list (GET /v1/books, 2 credits): Every DeepBook v3 pool with its coins, book parameters, best prices and 24 hour activity.
- books.depth (GET /v1/books/:pool/depth, 3 credits): Live bids and asks of one DeepBook pool, with mid price and spread.
- books.trades (GET /v1/books/:pool/trades, 2 credits): Recent fills of one DeepBook pool, newest first.
- wallet.orders (GET /v1/wallet/:wallet/orders, 5 credits): A wallet's DeepBook balance managers with their balances, open orders and recent fills.

## Walrus

Walrus blobs: status, size, expiry and owner.

- walrus.blob (GET /v1/walrus/blobs/:blobId, 2 credits): One Walrus blob: size, epochs, expiry, deletable flag, owner and status.
- walrus.blobs (GET /v1/wallet/:wallet/walrus-blobs, 2 credits): Walrus blobs a wallet owns, with epochs, size and expiry.
- walrus.blobDetail (GET /v1/walrus/blob/:id, 3 credits): One Walrus blob in full: facts, history, storage paid, attributes, what the content is and a preview URL.

## SQL

Run SQL over every Sui transaction, event, object version and balance change since genesis, about a second behind the chain.

- sql.execute (POST /v1/sql/execute, varies credits): Run a SQL query over all of Sui
- sql.status (GET /v1/execution/:execution_id/status, 0 credits): Status of a SQL run
- sql.results (GET /v1/execution/:execution_id/results, 0 credits): Results of a SQL run
- sql.results_csv (GET /v1/execution/:execution_id/results/csv, 0 credits): Results of a SQL run as CSV
- sql.cancel (POST /v1/execution/:execution_id/cancel, 0 credits): Cancel a SQL run
- sql.schema (GET /v1/sql/schema, 0 credits): The public SQL tables and columns
- sql.translate (POST /v1/sql/translate, 0 credits): Trino SQL to tide SQL
- sql.limits (GET /v1/sql/limits, 0 credits): Your SQL limits
- sql.pulse (GET /v1/sql/pulse, 0 credits): Live numbers for Sui
- query.create (POST /v1/query, 0 credits): Save a query
- query.get (GET /v1/query/:query_id, 0 credits): A saved query
- query.update (PUT /v1/query/:query_id, 0 credits): Update a saved query
- query.fork (POST /v1/query/:query_id/fork, 0 credits): Fork a query
- query.star (POST /v1/query/:query_id/star, 0 credits): Star or unstar a query
- query.list (GET /v1/queries, 0 credits): Browse saved queries
- query.execute (POST /v1/query/:query_id/execute, varies credits): Run a saved query
- query.results (GET /v1/query/:query_id/results, 0 credits): Latest results of a saved query
- dashboard.create (POST /v1/dashboard, 0 credits): Create a dashboard
- dashboard.get (GET /v1/dashboard/:dashboard, 0 credits): A dashboard with its results
- dashboard.update (PUT /v1/dashboard/:dashboard, 0 credits): Update a dashboard
- dashboard.fork (POST /v1/dashboard/:dashboard/fork, 0 credits): Fork a dashboard
- dashboard.star (POST /v1/dashboard/:dashboard/star, 0 credits): Star or unstar a dashboard
- dashboard.run (POST /v1/dashboard/:dashboard/run, varies credits): Run a dashboard with filter values
- dashboard.list (GET /v1/dashboards, 0 credits): Browse dashboards
- dashboard.gallery (GET /v1/dashboards/gallery, 0 credits): The dashboards gallery
- dashboard.publish (POST /v1/dashboard/:dashboard/publish, 0 credits): Publish a dashboard to the gallery
- dashboard.unpublish (POST /v1/dashboard/:dashboard/unpublish, 0 credits): Take a dashboard out of the gallery
- dashboard.view (POST /v1/dashboard/:dashboard/view, 0 credits): Count a visit
- dashboard.report (POST /v1/dashboard/:dashboard/report, 0 credits): Report a dashboard
- dashboard.moderate (POST /v1/dashboard/:dashboard/moderate, 0 credits): Feature, unlist or restore a dashboard (admin)
- dashboard.review (GET /v1/dashboards/review, 0 credits): Reported dashboards (admin)

## Gas

Gas price estimates.

- getGasPriceEstimate (JSON-RPC getGasPriceEstimate, 1 credits): Gas price levels from recent transactions, optionally for given shared objects.

## Sign in with Google

zkLogin for Sui apps: salts, proofs, imported salts for existing users and recovery kits. Salts and backups are free; proofs are free up to a monthly allowance per app. Guide: https://tide.ad/docs/login

- zklogin.salt (POST /v1/zklogin/salt, 0 credits): The salt and Sui address for a Google sign-in.
- zklogin.proof (POST /v1/zklogin/proof, varies credits): A zkLogin proof for an ephemeral key, ready to sign Sui transactions.
- zklogin.backup (POST /v1/zklogin/backup, 0 credits): A recovery kit for the signed-in user: issuer, client id, user id, salt and address.
- zklogin.import (POST /v1/zklogin/import, 0 credits): Import the salts your users already have, so their addresses stay the same.
- zklogin.clients (GET /v1/zklogin/clients, 0 credits): Your registered sign-in client ids, proof usage this month and the free allowance.
- zklogin.clientAdd (POST /v1/zklogin/clients, 0 credits): Register an OAuth client id (aud) to your account.
- zklogin.clientRemove (DELETE /v1/zklogin/clients/:clientId, 0 credits): Remove a client id from your account.
- zklogin.config (GET /v1/zklogin/config, 0 credits): Sign-in settings: accepted issuers, free allowance, proof price and whether the prover is up.

## Account and keys

Sign in with a wallet, create and manage API keys.

- auth.nonce (POST /v0/auth/nonce, 0 credits): Start a sign-in: get a message to sign with a Sui key.
- auth.verify (POST /v0/auth/verify, 0 credits): Finish sign-in: trade a signature for a 30-day session token.
- keys.agent (POST /v0/keys/agent, 0 credits): Agents: sign one message with any Sui key, get a Free API key.
- keys.list (GET /v0/keys, 0 credits): List your API keys.
- keys.create (POST /v0/keys, 0 credits): Create an API key.
- keys.update (PUT /v0/keys/:id, 0 credits): Rename a key or change where it works.
- keys.revoke (DELETE /v0/keys/:id, 0 credits): Revoke an API key.
- account.get (GET /v0/account, 0 credits): Your plan, credits used and left this month, and limits.
- account.usage (GET /v0/account/usage, 0 credits): Usage per day and method.
- intel.cases.create (POST /v1/intel/cases, 0 credits): Save an investigation as a case file.
- intel.cases.list (GET /v1/intel/cases, 0 credits): List your case files.
- intel.cases.get (GET /v1/intel/cases/:caseID, 0 credits): Read one case file.
- intel.cases.update (PUT /v1/intel/cases/:caseID, 0 credits): Save changes to a case file.
- intel.cases.delete (DELETE /v1/intel/cases/:caseID, 0 credits): Delete a case file.
- intel.cases.duplicate (POST /v1/intel/cases/:caseID/duplicate, 0 credits): Copy a case into your account.
- account.pins.get (GET /v1/account/pins, 0 credits): Read the pins on your home page.
- account.pins.put (PUT /v1/account/pins, 0 credits): Save the pins on your home page.
- billing.get (GET /v1/billing, 0 credits): Your credits: plan credits left this month, prepaid USDC credits, auto top-up.
- billing.history (GET /v1/billing/history, 0 credits): Every USDC payment credited to your account, newest first.
- billing.topup (POST /v1/billing/topup, 0 credits): Build an unsigned USDC top-up transaction to sign.
- billing.submit (POST /v1/billing/topup/submit, 0 credits): Send a signed top-up and get the credits once it is final.
- billing.allowance (POST /v1/billing/allowance, 0 credits): Build an unsigned sui::allowance grant for auto top-up.
- billing.allowanceConfirm (POST /v1/billing/allowance/confirm, 0 credits): Turn on auto top-up after your allowance grant is on chain.
- billing.autotopup (PUT /v1/billing/autotopup, 0 credits): Change auto top-up: on or off, threshold, draw size.
- billing.revoke (POST /v1/billing/allowance/revoke, 0 credits): Build an unsigned revoke for your auto top-up allowance.
- billing.offers (GET /v1/billing/offers, 0 credits): x402 and MPP payment offers to buy credits without signing in.
- billing.pay (POST /v1/billing/pay, 0 credits): Settle an x402 or MPP payment and get its credits and API key.
- billing.admin (GET /v1/billing/admin, 0 credits): Owner view: treasury balance, hot key gas, credits sold.

## Meta

Status, catalog and agent endpoints.

- meta.index (GET /, 0 credits): What this API is and where to start.
- meta.status (GET /v0/status, 0 credits): Live status: index head, chain tip, lag and per-method latency.
- catalog.json (GET /catalog.json, 0 credits): Every method with params, result schema, example and credits, as JSON.
- catalog.openapi (GET /openapi.json, 0 credits): OpenAPI 3.1 description of every REST path and JSON-RPC method.
- catalog.llms (GET /llms.txt, 0 credits): Short plain-text index for language models: base URLs, auth and one line per method.
- catalog.llmsFull (GET /llms-full.txt, 0 credits): Plain-text reference: every method with a parameter table and a curl example.
- mcp (POST /mcp, 0 credits): Remote MCP server (Streamable HTTP) with tide's answer tools for agents.
- meta.attestKey (GET /.well-known/tide-attest.json, 0 credits): tide's attestation public key (ed25519) for receipts.

## Plans

- keyless: custom or none, 1000 credits a day, 2 light and 1 heavy requests/s
- free: $0/mo, 5000000 credits a month, 15 light and 5 heavy requests/s
- developer: $29/mo, 30000000 credits a month, 75 light and 25 heavy requests/s
- business: $249/mo, 250000000 credits a month, 300 light and 100 heavy requests/s
- professional: $599/mo, 600000000 credits a month, 750 light and 250 heavy requests/s
- enterprise: custom or none, 5000000000 credits a month, 2000 light and 800 heavy requests/s
- Full table, credits per method and paying with USDC: https://tide.ad/docs/plans