# Wallet Status (`exchange_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.

- Category: Exchanges
- MCP tool: `exchange_wallet_status`
- REST: `GET /exchanges/wallet-status`
- x402 price: $0.01 per call (USDC on Base)
- HTML: https://www.f1ow.com/docs/tools/exchange_wallet_status

## 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

| Name | Type | In | Required | Description |
| --- | --- | --- | --- | --- |
| `assets` | string[] | query | no | Asset symbols, e.g. ['WAVES'] or ['USDT','USDC']. Omit for every asset each exchange returns. |
| `exchanges` | string[] | query | no | Exchange names or ids, e.g. ['Gate','upbit-kr']. Omit for all. |
| `networks` | string[] | query | no | Networks, by alias ('ERC20', 'Tron'), the exchange's own label, or a contract address. Omit for all. |
| `limit` | integer | query | no | Rows per page, 1-1000. Default 200. |
| `cursor` | string | query | no | next_cursor from the previous page, with the same filters. |

## Call it

### cURL

```bash
curl "https://mcp.f1ow.com/v1/exchanges/wallet-status?assets=USDT&networks=TRC20&limit=50" \
  -H "Authorization: Bearer $F1OW_API_KEY"
```

### MCP

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exchange_wallet_status",
    "arguments": {
      "assets": [
        "USDT"
      ],
      "networks": [
        "TRC20"
      ],
      "limit": 50
    }
  }
}
```

### TypeScript

```ts
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);
```

### Python

```python
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)
```

### WebSocket

```jsonc
// 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
  }
}
```

### x402

```bash
# 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

Captured 2026-11-17. The JSON is what REST and WebSocket return and the `structuredContent` of an MCP call (trimmed):

```json
{
  "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"
}
```

Over MCP the text report a model reads comes with it:

```text
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
```

## Related tools

- [Market Regime](https://www.f1ow.com/docs/tools/research_regime) — What kind of market you are trading in. Seven forces — trend, volatility, cycle, sentiment, leverage stress, ETF liquidity, rotation — each voting with its own reasoning and its own threshold for changing the call.
- [Positioning](https://www.f1ow.com/docs/tools/research_positioning) — Who is on the other side of your trade. Up to eight reads on one coin — who is crowded, who is fragile, who is trapped — plus the price levels the whole board is watching.
- [Opportunity Scan](https://www.f1ow.com/docs/tools/research_opportunities) — A liquidity-qualified major and mid-cap universe screened on crowding, stress, leverage, compression, trend, location and entry quality. Ranked candidates with disclosed setup rules and entry, stop and target geometry — not a forecast or a proven edge.
- [Trade Plan Review](https://www.f1ow.com/docs/tools/research_trade_plan) — Check your entry, stop and target against ATR, perp levels, liquidation distance, fees, slippage and funding. Add account size and risk for sizing, or a placement time to replay a trade from public candles. An interactive ticket in MCP Apps hosts; no orders placed or plans stored.
