Fragment APIREST v1

Fund the balance you intend to spend.

Fragment API keeps TON and official USDT on TON as separate developer balances. Deposits share a destination address and your stable account memo; the transferred asset determines which balance is credited.

Supported balances

Balance	Network	Use
`TON`	TON	Stars and Premium orders paid in native TON.
`USDT`	TON	Stars and Premium orders paid in official Tether USD.

USDT sent over Ethereum, TRON, or any network other than TON is not supported. Sending the wrong asset, network, address, or memo can make a deposit unrecoverable.

Deposit safely from the dashboard

01Open Dashboard → Top up and choose TON or USDT.
02Copy the deposit address and your account memo/reference exactly as displayed.
03Send the selected asset on the TON network and include the memo in the transfer comment.
04Wait for network confirmation, then verify the matching balance before creating orders.

The same canonical memo can appear on both wallet cards. This is intentional: the deposited asset selects the balance while the memo identifies your developer account.

Read a balance through the API

GET

/wallet/balance?wallet_type=TON

curl "https://v1.fragmentapi.com/api/v1/partner/wallet/balance?wallet_type=USDT" \
  -H "API-Key: $FRAGMENT_API_KEY"

{
  "wallet_id": "550e8400-e29b-41d4-a716-446655440000",
  "balance": 1250.75,
  "currency": "USDT",
  "updated_at": "2026-09-21T10:30:00Z"
}

Supported query values are TON and USDT. Omitting wallet_type returns the TON balance for backward compatibility.

Failed-order returns go to the same balance

An order reserves its full amount from the selected balance. On a definite terminal failure before settlement, the system creates a refund transaction and restores that full amount to the same wallet.

Balance returns are internal wallet ledger entries, not outbound blockchain transfers. Check the order’s final state and the dashboard transaction history before taking further action.