IOTA Wallet Watch

Watch an IOTA mainnet address or IOTA name in a loop and get only new transactions since your last call: direction, IOTA amount, status, time and explorer link, plus the current balance. First call returns recent transactions and a cursor; pass the cursor back on the next call. For deposit detection, treasury and whale watching.

Run free trial ↗3 free calls per day with the example input. Paid: $0.002 USDC, no limit.

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/iota-watch", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"address":"0x74b8312393d50952c9a90bad5c9098c7c5da20f0832a22ed1ce8265524ab3df4","limit":3}),
});
const { data, payment } = await res.json();  // payment.status "settling"; header X-Payment-Settle: sync returns payment.transaction

Input

Field	Type	Description
address *	string	IOTA address or IOTA name
cursor	string	Cursor from the previous call
limit	integer = 20	Max transactions, 1 to 50

Output

Field	Type	Description
changed	boolean
new_transactions	array
iota_balance	number
cursor	string