VIPService
List VIP Tiers
List the complete active VIP0 through VIP10 tier catalog.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/vip/tiers' \ --header 'Accept: */*'
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"
}
]
}Positive identifier of the returned VIP policy version.
1UTC time at which this policy version became effective.
2025-01-01T00:00:00ZAverage portfolio value retention threshold in basis points. One basis point is 0.01%; valid values are 1 through 10000.
1Numeric VIP tier in the inclusive range 0 through 10.
10Rolling 30-day settled spot volume entry threshold in USD, encoded as a non-negative base-10 decimal string without separators or a currency symbol.
12.3456Rolling 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.
50000Absolute 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.
0.09Absolute 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.
0.03| 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. |