ClaimsService
Claim Daily Reward
Claim today's reward once for the authenticated root account, paid to the root account or to a subaccount it owns. Requires a session JWT; API keys are not accepted. All reward assets are transferred together, and retries return the same claim and destination.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/v1/trading/daily-claim/claim' \
--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' \
--header 'Content-Type: application/json' \
--data '{
"subaccountId": "45LUmqjT"
}'Responses
{
"campaign": {
"campaignId": "value",
"claimPolicy": "UTC_DAILY",
"description": "Example configuration for the API playground.",
"name": "value"
},
"claimId": "value",
"claimedAt": "2025-01-01T00:00:00Z",
"resetAt": "2025-01-01T00:00:00Z",
"rewards": [
{
"amount": "18.446744073709551617",
"assetCode": "USDC",
"assetId": 100
}
],
"state": "AVAILABLE",
"subaccountId": "45LUmqjT",
"transfers": [
{
"assetId": 100,
"transferId": "9155001234569"
}
]
}Optional public id of a subaccount owned by the authenticated root account that receives the reward. When omitted, the reward is paid to the root account. Subaccounts shared with the caller but owned by another root account cannot be selected. The destination is fixed when today's claim is created; retries return the existing claim and its destination.
Stable campaign identifier.
valueHow frequently each root account may claim from this campaign.
UTC_DAILYCampaign description. Existing claims retain the description that applied when they were created.
Example configuration for the API playground.Campaign name. Existing claims retain the name that applied when they were created.
valueClaim identifier.
valueTime when the claim completed. Omitted while the claim is processing.
2025-01-01T00:00:00ZStart of the next UTC calendar day.
2025-01-01T00:00:00ZClaim amount in 18-decimal unified asset units.
18.446744073709551617Asset code.
USDCAsset identifier.
100Current claim state.
AVAILABLESubaccount public id that receives this claim's reward. Zero or omitted when the reward is paid to the root account.
45LUmqjTAsset identifier.
100Transfer identifier.
9155001234569| 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. |