vip.v1.VIPService
ListVIPTiers
List the complete active VIP0 through VIP10 tier catalog in ascending tier order. This public, caller-independent catalog supports cacheable ConnectRPC GET.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/vip.v1.VIPService/ListVIPTiers' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{}'Responses
{
"effectiveFrom": "2025-01-01T00:00:00Z",
"policyVersion": "1",
"retentionThresholdBp": 1,
"tiers": [
{
"aopThresholdUsd": "50000",
"makerFeeRatePercent": "0.09",
"takerFeeRatePercent": "0.03",
"tier": 10,
"volumeThresholdUsd": "12.3456"
}
]
}vip.v1.ListVIPTiersRequestvip.v1.ListVIPTiersResponsePositive identifier of the returned VIP policy version.
UTC time at which this policy version became effective.
Average portfolio value retention threshold in basis points. One basis point is 0.01%; valid values are 1 through 10000.
Numeric VIP tier in the inclusive range 0 through 10.
Rolling 30-day settled spot volume entry threshold in USD, encoded as a non-negative base-10 decimal string without separators or a currency symbol.
Rolling 30-day average portfolio value entry threshold in USD, encoded as a positive base-10 decimal string without separators or a currency symbol. Omitted for VIP0, which has no average portfolio value entry threshold.
Absolute maker fee rate before symbol-specific adjustments, encoded as a base-10 percentage string without a percent sign. Values are between -100 and 100 inclusive.
Absolute taker fee rate before symbol-specific adjustments, encoded as a non-negative base-10 percentage string without a percent sign. Values are between 0 and 100 inclusive.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |