Use this to fetch the current API catalog with the temporary app API key.

fetch("/api/app/v1/catalog", {
  headers: { "X-FUTRE-API-Key": "futre_live_..." }
}).then(r => r.json())

{
  "project": "Futre Wallet App API",
  "modules": [
    { "name": "Account Creation", "endpoints": [...] }
  ]
}

Creates a user and automatically creates backend-controlled BTC/EVM/TRON wallet addresses.

{
  "name": "Test User",
  "email": "test@example.com",
  "password": "test12345"
}

{
  "user": { "id": 12, "email": "test@example.com" },
  "wallet": {
    "addresses": {
      "Bitcoin": "bc1...",
      "ERC20": "0x...",
      "BEP20": "0x...",
      "TRC20": "T..."
    }
  }
}

Requires logged-in user session cookie. Use after signup or Telegram/email merge so the client can replace the temporary password.

{
  "currentPassword": "test12345",
  "newPassword": "newStrongPassword123"
}

{
  "ok": true,
  "user": { "id": 12, "email": "test@example.com" }
}

Requires logged-in user session cookie. Returns a deposit address for the selected asset/network.

{
  "asset": "USDT",
  "network": "TRC20"
}

{
  "asset": "USDT",
  "network": "TRC20",
  "depositAddress": "T...",
  "custodyMode": "semi-custodian"
}

Requires logged-in user session cookie. Keep this disabled in test code unless you intend to move funds.

{
  "asset": "USDT",
  "network": "TRC20",
  "amount": "10",
  "toAddress": "T..."
}

{
  "id": 51,
  "status": "completed",
  "asset": "USDT",
  "network": "TRC20",
  "amount": "10",
  "fee": 3,
  "netAmount": 7,
  "txid": "..."
}

Returns provider quote/range. Swap provider keys stay on backend only.

{
  "fromAsset": "USDT",
  "fromNetwork": "TRC20",
  "toAsset": "BTC",
  "toNetwork": "Bitcoin",
  "amount": "25"
}

{
  "provider": "simpleswap",
  "canCreate": true,
  "estimate": { "...": "provider quote" },
  "range": { "...": "provider min/max" }
}

Returns live market prices from backend cache/provider.

{
  "source": "coinmarketcap",
  "updatedAt": "2026-06-27T03:00:00.000Z",
  "prices": {
    "BTC": { "price": 61234.12, "change24h": 1.8 }
  }
}