Fund a user's wallet

Fund a user by sending tokens on-chain to their wallet address. You can send from any wallet or exchange you already use.

Find the address

Each user has one Solana address and one EVM address. You get both in wallets[] when you create the user, and again when you read the user. The EVM address is the same on every EVM chain we support.

Every asset in the catalog has a chain, which is the network it settles on. Fund the wallet on that network.

Match the network to the address

Tokens sent on the wrong network can be lost.

What to send

Send the stablecoin a market buy spends, on the chain the user will trade on, such as USDC on Solana. An order's quote names that asset in quote_asset. We pay the network fees for these wallets, so they need nothing else.

Check the balance

The balance updates once the network confirms your transfer. Read it with TM-On-Behalf-Of. available is what the user can trade with now.

TypeScript

Read one user's balances

const balances = await get("/v1/gateway/balances", forUser);

Python

Read one user's balances

balances = get("/v1/gateway/balances", for_user)

curl

Read one user's balances

curl -s https://api.truemarkets.co/v1/gateway/balances \
  -H "Authorization: Bearer $ORG_TOKEN" \
  -H "TM-On-Behalf-Of: $USER_ID"

Response200one row per asset; available is what they can trade

{
  "data": [
    {
      "asset_id": "b3d9e5f2-1a4c-4e7b-9f0d-2c8a6b3e5f91",
      "symbol": "USDC",
      "chain": "solana",
      "venue": "defi",
      "available": "3.000000",
      "total": "3.000000",
      "…": "…"
    }
  ]
}

Next: Send funds