DepositAddressService
List Deposit Addresses
List known deposit addresses for one account target.
Method
GET
Path
/v1/chain/deposit-addresses
Visibility
Authentication
Session token or API key
MFA Requirement
Not required
GET
/v1/chain/deposit-addresses Request
Testnet
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/chain/deposit-addresses?chainId=1&subaccountId=6789012345678' \ --header 'Accept: */*' \ --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \ --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \ --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'
Responses
{
"depositAddresses": [
{
"chainId": 1,
"depositAddress": "0x7777777777777777777777777777777777777777"
}
]
} chainId integer
Optional PolyChain-registered source chain id filter. When omitted, the response returns all known deposit addresses for the selected target, ordered by ascending chain id.
subaccountId string (int64)
Optional subaccount public id. When omitted, the authenticated caller's root account is used as the target account.
2 fields
chainId integer (int32)
PolyChain-registered source chain id used across deposit flows.
Example
1 depositAddress string
Assigned external-chain deposit address for the selected account target.
Example
0x7777777777777777777777777777777777777777| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |