Get static wallet deposit

Fetch a single static-wallet deposit by its id.

GET/v1/static-wallets/{staticWalletId}/deposits/{depositId}API key

Path parameters

Field	Type	Description
`staticWalletId`required	string	Static wallet ID
`depositId`required	string	Deposit ID

Response

200 OK

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

401 Unauthorized404 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/<deposit_id> \
  -H "X-Api-Key: $SUWARD_API_KEY"

request.js

const response = await fetch('https://api.suward.com/v1/static-wallets/<static_wallet_id>/deposits/<deposit_id>', {
  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/<deposit_id>", 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/<deposit_id>',
    headers={'X-Api-Key': os.environ['SUWARD_API_KEY']},
)
data = response.json()

Response · 200 OK

response.json

{
  "acceptedAt": 0,
  "address": "0xabc…def",
  "amount": "100000000",
  "asset": "USDT_ETHEREUM",
  "confirmedAt": 0,
  "createdAt": 0,
  "detectedAt": 0,
  "externalId": "order_abc123",
  "fee": "1000000",
  "id": "obj_abc123",
  "invalidatedAt": 0,
  "netAmount": "100000000",
  "networkFee": "150000",
  "projectId": "obj_abc123",
  "staticWalletId": "obj_abc123",
  "status": "detected",
  "transferIndex": "0",
  "txHash": "0x1234…abcd",
  "updatedAt": 0
}

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

PreviousList static wallet deposits NextSimulate static wallet deposit

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