Balance Deposit Wallet

POST
/api/v1/prefund/wallet

Request the tenant's prefund deposit wallet on a network. Creates it on first call (status creating); subsequent calls return the current state. Poll GET /prefund/wallet until active.

Authorization

headerX-Api-Key<token>

API key in format: sti_env_prefix_secret

Request Body

application/json
  1. body
network*string

Prefund network: ethereum, polygon, solana, tron.

Value in"ethereum""polygon""solana""tron"

Response Body

Default Response

application/json
  1. response
status*string

Lifecycle state of the prefund wallet. Deposit address is available once active.

Value in"not_created""creating""active""failed"
wallet?

Present only when status is active.

min_deposit*

Suggested minimum deposit (UI hint; smaller deposits still credit).

Example Request
curl -X POST 'https://api.sandbox.stables.money/api/v1/prefund/wallet' \  -H 'Content-Type: application/json' \  -d '{  "network": "ethereum"}'
Example Response
{  "status": "not_created",  "wallet": {    "address": "string",    "network": "string",    "currency": "string",    "currencies": [      "string"    ]  },  "min_deposit": {    "amount": "string",    "currency": "string"  }}
GET
/api/v1/prefund/wallet

Get the tenant's prefund deposit wallet on a network (default polygon) and its lifecycle status.

Authorization

headerX-Api-Key<token>

API key in format: sti_env_prefix_secret

Query Parameters

network?string

Prefund network: ethereum, polygon, solana, tron.

Default"polygon"
Value in"ethereum""polygon""solana""tron"

Response Body

Default Response

application/json
  1. response
status*string

Lifecycle state of the prefund wallet. Deposit address is available once active.

Value in"not_created""creating""active""failed"
wallet?

Present only when status is active.

min_deposit*

Suggested minimum deposit (UI hint; smaller deposits still credit).

Example Request
curl -X GET 'https://api.sandbox.stables.money/api/v1/prefund/wallet'
Example Response
{  "status": "not_created",  "wallet": {    "address": "string",    "network": "string",    "currency": "string",    "currencies": [      "string"    ]  },  "min_deposit": {    "amount": "string",    "currency": "string"  }}

Request your balance's deposit wallet on a network, then poll until it is active. Deposits only credit when they come from a whitelisted wallet.