ZipperService
Get Deposit & Withdraw Config
Retrieve the supported chains and unified assets for Zipper-powered deposit and withdraw flows.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/chain/deposit-withdraw/config' \ --header 'Accept: */*'
Responses
{
"assets": [
{
"asset": "USDT",
"icon": "💰",
"ledgerId": 1,
"name": "Tether USD",
"quantityDisplayDecimals": 8,
"quantityScale": 8,
"uAssetId": "100",
"variants": [
{
"chainId": 1,
"depositMinAmount": "123.45",
"isNativeAsset": false,
"networkFee": "0.001",
"sourceAddress": "0x4444444444444444444444444444444444444444",
"sourceDecimals": 1,
"supply": "1",
"withdrawMinAmount": "123.45",
"zippedAssetId": 100,
"ztokenAddress": "0x6666666666666666666666666666666666666666",
"ztokenDecimals": 1
}
]
}
],
"chains": [
{
"chainId": 1,
"code": "ETH",
"confirmationTimeSeconds": 1,
"explorerUrl": "https://etherscan.io",
"icon": "💰",
"isCaseSensitive": false,
"maxAddressLength": 1,
"minAddressLength": 1,
"name": "Ethereum",
"nativeChainId": "1",
"nativeCurrencySymbol": "ETH",
"requiredConfirmations": 1
}
],
"contracts": [
{
"address": "0x3333333333333333333333333333333333333333",
"description": "Trading account gateway contract.",
"name": "TradingGateway",
"type": "TRADING_GATEWAY",
"version": 1
}
],
"tsSec": 1735689600
}Unified Polyester asset code used inside Funding/Trading (for example: "USDT").
USDTOptional icon reference for the unified asset.
💰Public unified asset id.
1Human-friendly unified asset display name.
Tether USDUI display precision for the unified asset.
8Integer scale for unified-asset quantities (0..18). A scale of 8 means one whole asset is represented as 100000000 in supply_q and other quantity_scale-based fields.
8On-chain uAsset id for the unified asset.
100Chain that this asset belongs to.
1Minimum deposit amount for this variant as a human-readable string in zToken units.
123.45True when the asset is the native gas/token of the source chain.
falseLatest known network fee for this chain asset variant as a human-readable string in zToken units, with insignificant trailing zeroes trimmed.
0.001Source-chain token contract, mint, or native sentinel address.
0x4444444444444444444444444444444444444444Source-chain token decimals.
1Latest zToken supply for this chain asset variant, expressed in whole-token units.
1Minimum withdraw amount for this variant as a human-readable string in zToken units.
123.45Canonical zipped asset route id.
100Polyester zToken contract address for this chain asset variant.
0x6666666666666666666666666666666666666666zToken decimals on Polyester chain.
1PolyChain-registered chain id used across Zipper and lifecycle events.
1Stable machine-friendly chain key (for example: "ethereum", "solana").
ETHEstimated average confirmation time in seconds when known.
1Optional block explorer base URL for links.
https://etherscan.ioOptional icon reference for UI display.
💰True when source-chain addresses must preserve letter case.
falseInclusive maximum source-chain address length for validation.
1Inclusive minimum source-chain address length for validation.
1Human-friendly display name.
EthereumNative source-chain network identifier when useful for wallet or explorer integrations. For EVM chains this is the EIP-155 chain id; non-EVM chains may omit this and should be identified by `chain_id` and `code`.
1Native gas token symbol for this chain (for example: ETH, BTC, SOL).
ETHDefault required source-chain confirmations when known.
1EVM contract address on Polyester chain.
0x3333333333333333333333333333333333333333Optional human-readable description.
Trading account gateway contract.Stable contract key for client lookups.
TradingGatewayOptional product-facing contract category, when known.
TRADING_GATEWAYActive contract version for this name. Versions increase when the address changes, allowing clients to identify the exact contract revision in use.
1Snapshot generation timestamp (seconds since epoch, UTC).
1735689600| 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. |