swap.quickswap.v1.QuickSwapBrokerService
ListVaults
ListVaults lists the broker's affiliate vaults. Errors: - NOT_FOUND: BROKER_NOT_FOUND. - INVALID_ARGUMENT: a page_token from another broker or malformed.
Method
POST
Path
swap.quickswap.v1.QuickSwapBrokerService/ListVaults
Service
swap.quickswap.v1.QuickSwapBrokerService
Visibility
Authentication
Session token
MFA Requirement
Not required
POST
swap.quickswap.v1.QuickSwapBrokerService/ListVaults Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/swap.quickswap.v1.QuickSwapBrokerService/ListVaults' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"broker": "value",
"limit": 100,
"pageToken": "eyJvZmZzZXQiOjEwMH0"
}'Responses
{
"nextPageToken": "eyJvZmZzZXQiOjIwMH0",
"vaults": [
{
"accountId": "7563897446546",
"createdAt": "2025-01-01T00:00:00Z",
"label": "Name Of My Subaccount",
"status": "VAULT_ACTIVE",
"updatedAt": "2025-01-01T00:00:00Z"
}
]
}Request
swap.quickswap.v1.ListVaultsRequestResponse
swap.quickswap.v1.ListVaultsResponse broker string
Broker name. A broker API key may name only its own broker.
limit integer (int32)
Maximum number of vaults to return; 0 means 100, at most 200.
pageToken string
Opaque keyset cursor from a previous next_page_token, exclusive, bound to the broker and ordered by ascending account_id. Empty for the first page.
5 fields
accountId string (fixed64)
Public sub-account ID of the vault; name it in AffiliateShare.account_id.
label string
Broker-chosen label, unique per broker.
status enum
Whether new QuickSwaps can name the vault.
VAULT_ACTIVE VAULT_DISABLED
createdAt string (date-time)
When the vault was created.
updatedAt string (date-time)
When the vault was last changed.
nextPageToken string
Cursor of the next page. Empty when no more results exist.
| 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. |