Skip to main content
GET
Get an incoming stablecoin deposit

What this endpoint does

Returns one provider-created stablecoin deposit with asset/network, transaction reference, finality, amounts, status, next action, and linked wallet movement.

When to use it

Use it after a deposit webhook, during blockchain reconciliation, or when a detected transaction has not become available.

Before you call

Authenticate with treasury:read and pass a deposit ID owned by the same tenant account.

Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

States and completion

Follow detected, confirming, credited, held, and returned. A transaction hash is not enough: only a credited deposit with finality can increase spendable balance.

Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an Idempotency-Key. Read Funding and balances for the complete workflow.

Authorizations

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Path Parameters

id
string
required

Response

200 - application/json
id
string
required
Minimum string length: 1
clientId
string
required
Minimum string length: 1
fundingInstrumentId
string
required
Minimum string length: 1
status
enum<string>
required
Available options:
detected,
confirming,
credited,
held,
returned
gross
object
required
inboundFee
object
required
netCredit
object
required
providerReference
string
required
Minimum string length: 1
nextAction
enum<string>
required
Available options:
none,
wait_for_confirmation,
contact_support
occurredAt
string<date-time>
required
updatedAt
string<date-time>
required
type
enum<string>
required
Available options:
stable_deposit
asset
enum<string>
required
Available options:
USDC,
USDT
network
enum<string>
required
Available options:
ethereum,
base,
arbitrum,
optimism,
polygon,
bsc,
avalanche,
solana,
tron
finalityReached
boolean
required
externalReference
string
Minimum string length: 1
downstreamReference
string
Minimum string length: 1
movementId
string
Minimum string length: 1
reason
string
Minimum string length: 1
creditedAt
string<date-time>
transactionHash
string
Minimum string length: 1