List static wallet deposits

Paginated list of the deposits received by a static wallet, newest first.

GET/v1/static-wallets/{staticWalletId}/depositsAPI key

Path parameters

Field	Type	Description
`staticWalletId`required	string	Static wallet ID

Query parameters

Field	Type	Description
`order`optional	string	Sort order (asc/desc)
`order` values string `ascdesc`
`limit`optional	integer	Limit (default 20, max 100)
`lastId`optional	string	Last ID for pagination

Response

200 OK

Field Type Description

hasMoreoptional boolean True when more deposits exist beyond this page. To fetch the next page, pass the last item's id as the lastId query parameter.

itemsoptional StaticDepositResponse[] Page of static-wallet deposits, ordered per the request's order parameter.

items fields StaticDepositResponse

Field	Type	Description
`acceptedAt`optional	integer	Unix-milliseconds timestamp when the deposit reached the accepted (safe confirmations) tier. Null before acceptance.
`address`optional	string	On-chain address that received the deposit (the static wallet's address).
`amount`optional	string	Gross deposited amount, an integer string in the asset's smallest unit (see CreatePaymentRequest.amount).
`asset`optional	AssetID	Asset of the deposit, as an asset id-string (see GET /v1/assets).
`asset` values AssetID `USDT_ETHEREUMUSDT_ARBITRUMUSDT_OPTIMISMUSDT_BASEUSDT_BSCUSDT_PLASMAUSDT_POLYGONUSDC_ETHEREUMUSDC_ARBITRUMUSDCE_ARBITRUMUSDC_OPTIMISMUSDC_BASEUSDC_BSCUSDC_PLASMAUSDC_POLYGONETH_ETHEREUMETH_ARBITRUMETH_OPTIMISMETH_BASEXPL_PLASMABNB_BSCPOL_POLYGONTESTCOIN_ETHEREUMTESTCOIN_OPTIMISMTESTCOIN_PLASMATESTSTABLECOIN_ETHEREUMTESTSTABLECOIN_OPTIMISMTESTSTABLECOIN_PLASMA`
`confirmedAt`optional	integer	Unix-milliseconds timestamp when the deposit reached finality (confirmed). Null before confirmation.
`createdAt`optional	integer	Unix-milliseconds timestamp when the deposit record was created.
`detectedAt`optional	integer	Unix-milliseconds timestamp when the deposit was first detected on-chain.
`externalId`optional	string	ExternalID is the static wallet's externalId, denormalized onto the deposit.
`fee`optional	string	Platform fee on this deposit, integer string in the asset's smallest unit: max(0.4% of the amount, $1 equivalent). The $1 floor is 0 for assets without a published USD price.
`id`optional	string	Unique Suward identifier of the deposit.
`invalidatedAt`optional	integer	Unix-milliseconds timestamp when the deposit was invalidated (e.g. dropped by a chain reorg). Null unless invalidated.
`netAmount`optional	string	Amount credited to the merchant after fees (amount - fee - networkFee), integer string in the asset's smallest unit.
`networkFee`optional	string	Estimated on-chain (gas) cost deducted from the deposit, integer string in the asset's smallest unit.
`projectId`optional	string	Identifier of the project that owns this deposit.
`staticWalletId`optional	string	Identifier of the static wallet that received this deposit.
`status`optional	string	Deposit lifecycle status. detected: seen on-chain, awaiting confirmations. accepted: safe confirmations reached, credited (non-final). confirmed: finalized (terminal). ignored: the asset is not on the wallet's allow-list, so the deposit is not credited. invalidated: dropped after detection, e.g. by a chain reorg.
`status` values string `detectedacceptedconfirmedignoredinvalidated`
`transferIndex`optional	string	Index of this transfer within its transaction, as a string-encoded integer. Distinguishes multiple transfers to the same address in one transaction.
`txHash`optional	string	On-chain transaction hash of the deposit.
`updatedAt`optional	integer	Unix-milliseconds timestamp when the deposit was last updated.

Errors

404 Not Found— each returns { errorCode, message, args? }. Codes, retries and limits: Errors & limits

All Static Wallets endpoints

Request

terminal

curl https://api.suward.com/v1/static-wallets/<static_wallet_id>/deposits \
  -H "X-Api-Key: $SUWARD_API_KEY"

request.js

const response = await fetch('https://api.suward.com/v1/static-wallets/<static_wallet_id>/deposits', {
  method: 'GET',
  headers: {
    'X-Api-Key': process.env.SUWARD_API_KEY,
  },
});
const data = await response.json();

main.go

package main
 
import (
	"fmt"
	"io"
	"net/http"
	"os"
)
 
func main() {
	req, _ := http.NewRequest("GET", "https://api.suward.com/v1/static-wallets/<static_wallet_id>/deposits", nil)
	req.Header.Set("X-Api-Key", os.Getenv("SUWARD_API_KEY"))
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

request.py

import requests, os
 
response = requests.get(
    'https://api.suward.com/v1/static-wallets/<static_wallet_id>/deposits',
    headers={'X-Api-Key': os.environ['SUWARD_API_KEY']},
)
data = response.json()

Response · 200 OK

response.json

{
  "hasMore": false,
  "items": []
}

Illustrative values. Every field, type and status on this page is generated from the OpenAPI specification.

PreviousDelete static wallet NextGet static wallet deposit

Something unclear? payments@suward.com — we treat every integration question as a documentation defect.