List static wallets

List the project's static wallets, newest first. Paginated via limit and lastId.

GET/v1/static-walletsAPI key

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 static wallets exist beyond this page. To fetch the next page, pass the last item's id as the lastId query parameter.

itemsoptional StaticWalletResponse[] Page of static wallets, ordered per the request's order parameter.

items fields StaticWalletResponse

Field	Type	Description
`address`optional	string	Reusable on-chain deposit address of this static wallet. Customers may send accepted assets to it repeatedly; each incoming transfer becomes a deposit.
`allowedAssets`optional	AssetID[]	Accepted-asset allow-list, as asset id-strings (see GET /v1/assets). Deposits of assets outside this list are ignored and not credited.
`allowedAssets` 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`
`createdAt`optional	integer	Unix-milliseconds timestamp when the static wallet was created.
`externalId`optional	string	Your own identifier for this static wallet, echoed from creation. Null when none was provided.
`id`optional	string	Unique Suward identifier of the static wallet.
`metadata`optional	object	Arbitrary key/value data attached by the merchant, echoed back unchanged.
`projectId`optional	string	Identifier of the project that owns this static wallet.
`updatedAt`optional	integer	Unix-milliseconds timestamp when the static wallet was last updated.
`webhookUrl`optional	string	Webhook URL that receives this wallet's deposit events. Null when the project default webhook is used.

Errors

401 Unauthorized— 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 \
  -H "X-Api-Key: $SUWARD_API_KEY"

request.js

const response = await fetch('https://api.suward.com/v1/static-wallets', {
  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", 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))
}

Response · 200 OK

response.json

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

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

PreviousStatic Wallets NextCreate static wallet

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