Wallets

A wallet is the thing that actually holds money in Sly. Every transfer moves funds between wallets; every stream flows from a wallet; every balance query reads a wallet. Wallets belong to either an account (parent wallets) or an agent (agent wallets). The distinction matters for policy enforcement:

Account wallets — policy set at the account level; typically funded from the outside (bank wire, on-ramp) and used to pay humans or other businesses.
Agent wallets — policy set at the agent level; funded from a parent account wallet or from earnings; spending is gated by KYA tier + wallet policy.

Wallet shape

{
  "id": "wal_...",
  "owner_type": "agent",     // or "account"
  "owner_id": "agt_...",     // or "acc_..."
  "currency": "USDC",
  "balance_available": "1250.50",
  "balance_pending": "75.00",
  "network": "base-sepolia", // live: base / polygon / solana / etc.
  "address": "0x...",        // on-chain address (for stablecoin wallets)
  "status": "active",
  "policy_id": "pol_..."     // agent wallets only
}

Supported currencies and networks

Currency	Networks (live)	Networks (sandbox)
USDC	Base, Polygon, Solana, Ethereum	Base Sepolia
USDT	Ethereum, Polygon, Tron	Sepolia
EURC	Base, Ethereum	Base Sepolia
Fiat (USD, EUR, GBP, …)	N/A (off-chain ledger)	N/A

When creating a wallet you specify the currency; the network is selected based on your tenant’s configuration (live: cheapest confirmed settlement for the currency; sandbox: always a testnet).

Create an account wallet

curl -X POST https://api.getsly.ai/v1/wallets \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "owner_type": "account",
    "owner_id": "acc_...",
    "currency": "USDC"
  }'

Agent wallets are created automatically when you create an agent. You can add additional wallets later via POST /v1/agent-wallets.

Fund a wallet

Live:

Bank wire or card on-ramp via funding endpoints
Internal transfer from another wallet
Incoming transfer from a peer account

Sandbox:

Faucet — POST /v1/wallets/:id/fund credits test tokens instantly

curl -X POST https://sandbox.getsly.ai/v1/wallets/wal_.../fund \
  -H "Authorization: Bearer pk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "amount": "1000.00" }'

Read balances

curl https://api.getsly.ai/v1/wallets/wal_... \
  -H "Authorization: Bearer pk_live_..."

balance_available reflects what you can spend now. balance_pending includes amounts held by in-flight transfers (debited from available but not yet settled).

Freeze and unfreeze

For incident response:

curl -X POST https://api.getsly.ai/v1/wallets/wal_.../freeze \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Suspicious activity investigation" }'

Frozen wallets cannot spend. Incoming transfers still land (funds can arrive). Unfreezing requires the same API key scope.

Wallet policies (agent wallets only)

Agent wallets carry a policy that enforces spending rules at the moment of transaction. See wallet policies for the full shape.

On-chain details

For stablecoin wallets, Sly custodies the private key on your behalf (or — for advanced tenants — integrates with your MPC custody provider). Every wallet has a public address, and every on-chain movement is observable in the block explorer.

Get Started

Onboarding

Migration

Authentication

Core Concepts

Guides

Recipes

Architecture

Settlement & Treasury

Stellar

Protocols

Agent Platform

SDKs & Tools

Webhooks

Resources

Wallet shape

Supported currencies and networks

Create an account wallet

Fund a wallet

Read balances

Freeze and unfreeze

Wallet policies (agent wallets only)

On-chain details

​Wallet shape

​Supported currencies and networks

​Create an account wallet

​Fund a wallet

​Read balances

​Freeze and unfreeze

​Wallet policies (agent wallets only)

​On-chain details

Wallet shape

Supported currencies and networks

Create an account wallet

Fund a wallet

Read balances

Freeze and unfreeze

Wallet policies (agent wallets only)

On-chain details