Skip to Content
f1owdocs
Tool reference

Wallet Status

Whether deposits and withdrawals are open for an asset on each exchange and network. Unknown is never reported as disabled, and stale or missing venues are flagged — check before moving funds.

Exchangesexchange_wallet_statusGET /exchanges/wallet-statusx402 · $0.01 / callRead-only

What it does

Crypto deposit and withdrawal availability across exchanges, for every asset each exchange returns (omit 'assets' for all; there is no ticker list or top-N cutoff). One row per exchange, region, asset and network where the exchange states flags per network (KuCoin, Bitget, Gate, HTX, Binance, MEXC, Bybit, OKX, Upbit); otherwise one asset-level row with network null (Coinone, WhiteBIT). 'deposit' and 'withdrawal' are independent: enabled, disabled or unknown. unknown means the exchange did not state it in a documented way; a missing field, an absent asset, a failed or rate-limited request or an unrecognised value is never reported as disabled. An asset-level flag is never copied onto its networks. Rows keep the exchange's own asset and network ids and contract address where it gives one; 'network' is a canonical name matched by explicit aliases (ERC20, TRC20, BEP20...), never by ticker. 'networks' filters by alias, the exchange's own label or a contract address; asset-level rows never match it. Page with 'limit' (default 200, max 1000) and 'cursor' (next_cursor; same filters). Each row carries retrieved_at and stale: a stale row is last-known data served because the exchange failed now, with its original retrieved_at. Coverage and health are not part of the response; instead 'warnings' names every exchange that did not answer (its rows are absent, which never means disabled), that answered from stale data, that was not queried for lack of credentials, and where Gate's per-chain status was not confirmed. Keyed exchanges (Binance, MEXC, Bybit, OKX, Upbit) are not queried until the operator configures read-only keys. Status can lag the exchange by minutes; check before moving funds, never a guarantee.

Parameters

NameTypeDescription
assetsquerystring[]Asset symbols, e.g. ['WAVES'] or ['USDT','USDC']. Omit for every asset each exchange returns.
exchangesquerystring[]Exchange names or ids, e.g. ['Gate','upbit-kr']. Omit for all.
networksquerystring[]Networks, by alias ('ERC20', 'Tron'), the exchange's own label, or a contract address. Omit for all.
limitqueryintegerRows per page, 1-1000. Default 200.
cursorquerystringnext_cursor from the previous page, with the same filters.

Call it

One API key works for MCP, REST and WebSocket; each call uses one unit. Agents without an account can pay per call with x402.

curl "https://mcp.f1ow.com/v1/exchanges/wallet-status?assets=USDT&networks=TRC20&limit=50" \
  -H "Authorization: Bearer $F1OW_API_KEY"
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exchange_wallet_status",
    "arguments": {
      "assets": [
        "USDT"
      ],
      "networks": [
        "TRC20"
      ],
      "limit": 50
    }
  }
}
const res = await fetch("https://mcp.f1ow.com/v1/exchanges/wallet-status?assets=USDT&networks=TRC20&limit=50", {
  headers: { Authorization: `Bearer ${process.env.F1OW_API_KEY}` },
});
const data = await res.json(); // the tool's result as JSON, typed in the OpenAPI spec
console.log(data);
import os, requests

res = requests.get(
    "https://mcp.f1ow.com/v1/exchanges/wallet-status?assets=USDT&networks=TRC20&limit=50",
    headers={"Authorization": f"Bearer {os.environ['F1OW_API_KEY']}"},
)
data = res.json()  # the tool's result as JSON, typed in the OpenAPI spec
print(data)
// wss://mcp.f1ow.com/v1/ws — subprotocol "jsonrpc-2.0", Authorization: Bearer <key>
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exchange_wallet_status",
    "arguments": {
      "assets": [
        "USDT"
      ],
      "networks": [
        "TRC20"
      ],
      "limit": 50
    }
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "exchange_wallet_status",
    "arguments": {
      "assets": [
        "USDT"
      ],
      "networks": [
        "TRC20"
      ],
      "limit": 50
    },
    "intervalSeconds": 60
  }
}
# No account: the first call answers 402 with a PAYMENT-REQUIRED challenge;
# an x402 client pays it in USDC on Base and retries.
curl "https://mcp.f1ow.com/x402/v1/exchanges/wallet-status?assets=USDT&networks=TRC20&limit=50"

Sample response

A real response captured 2026-11-17. JSON is what REST and WebSocket return, and the structuredContent of an MCP call (trimmed for length), with generatedAt for freshness. Text is the report an MCP client hands to a model.

Exchange wallet status: 6 matching rows, 6 on this page
Warning: not queried, no API credentials configured: MEXC, OKX, Upbit
Warning: Coinone: 1 asset-level rows excluded by the network filter: this venue states no per-network flags
Warning: WhiteBIT: 1 asset-level rows excluded by the network filter: this venue states no per-network flags
Rows (first 6; all 6 are in structuredContent):
  Binance USDT [TRX]: deposit enabled, withdrawal enabled
  Bitget USDT [TRC20]: deposit enabled, withdrawal enabled
  Bybit USDT [TRX]: deposit enabled, withdrawal enabled
  Gate USDT [TRX]: deposit enabled, withdrawal enabled
  HTX USDT [trc20usdt]: deposit enabled, withdrawal enabled
  KuCoin USDT [trx]: deposit enabled, withdrawal enabled
{
  "rows": [
    {
      "exchange": "Binance",
      "region": "global",
      "asset": "USDT",
      "asset_id": "USDT",
      "network": "tron",
      "network_id": "TRX",
      "network_name": null,
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "deposit": "enabled",
      "withdrawal": "enabled",
      "retrieved_at": "2026-11-17T17:10:02Z",
      "stale": false,
      "stale_reason": null
    },
    {
      "exchange": "Bitget",
      "region": "global",
      "asset": "USDT",
      "asset_id": "USDT",
      "network": "tron",
      "network_id": "TRC20",
      "network_name": null,
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "deposit": "enabled",
      "withdrawal": "enabled",
      "retrieved_at": "2026-11-17T17:10:01Z",
      "stale": false,
      "stale_reason": null
    },
    {
      "exchange": "Bybit",
      "region": "global",
      "asset": "USDT",
      "asset_id": "USDT",
      "network": "tron",
      "network_id": "TRX",
      "network_name": "TRX",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "deposit": "enabled",
      "withdrawal": "enabled",
      "retrieved_at": "2026-11-17T17:10:02Z",
      "stale": false,
      "stale_reason": null
    },
    {
      "exchange": "Gate",
      "region": "global",
      "asset": "USDT",
      "asset_id": "USDT",
      "network": "tron",
      "network_id": "TRX",
      "network_name": "Tron(TRC20)",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "deposit": "enabled",
      "withdrawal": "enabled",
      "retrieved_at": "2026-11-17T17:10:04Z",
      "stale": false,
      "stale_reason": null
    },
    {
      "exchange": "HTX",
      "region": "global",
      "asset": "USDT",
      "asset_id": "usdt",
      "network": "tron",
      "network_id": "trc20usdt",
      "network_name": "TRC20",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "deposit": "enabled",
      "withdrawal": "enabled",
      "retrieved_at": "2026-11-17T17:10:02Z",
      "stale": false,
      "stale_reason": null
    },
    {
      "exchange": "KuCoin",
      "region": "global",
      "asset": "USDT",
      "asset_id": "USDT",
      "network": "tron",
      "network_id": "trx",
      "network_name": "TRC20",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "deposit": "enabled",
      "withdrawal": "enabled",
      "retrieved_at": "2026-11-17T17:10:01Z",
      "stale": false,
      "stale_reason": null
    }
  ],
  "total": 6,
  "next_cursor": null,
  "warnings": [
    "not queried, no API credentials configured: MEXC, OKX, Upbit",
    "Coinone: 1 asset-level rows excluded by the network filter: this venue states no per-network flags",
    "WhiteBIT: 1 asset-level rows excluded by the network filter: this venue states no per-network flags"
  ],
  "generatedAt": "2026-11-17T17:10:04.6030291+00:00"
}

Call Wallet Status from your agent

Sign in, get an API key and make your first call in under a minute. No card required.

For agents: this page as Markdown · all docs

On this page