claims.v1.ClaimsService
ClaimDailyReward
Claim today's reward once for the authenticated root account, paid to the root account or to a subaccount it owns. All reward assets are transferred together, and retries return the same claim.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/claims.v1.ClaimsService/ClaimDailyReward' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"subaccountId": "6789012345678"
}'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": [
{
"amountE18": {
"hi": "1",
"lo": "1"
},
"assetCode": "USDC",
"assetId": 100
}
],
"state": "CLAIM_AVAILABLE",
"subaccountId": "6789012345678",
"transfers": [
{
"assetId": 100,
"transferId": "9155001234569"
}
]
}claims.v1.ClaimDailyRewardRequestclaims.v1.ClaimDailyRewardResponseOptional 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.
Claim identifier.
Current claim state.
Time when the claim completed. Omitted while the claim is processing.
Asset identifier.
Asset code.
Most significant 64 bits.
Least significant 64 bits.
Asset identifier.
Transfer identifier.
Start of the next UTC calendar day.
Stable campaign identifier.
Campaign name. Existing claims retain the name that applied when they were created.
Campaign description. Existing claims retain the description that applied when they were created.
How frequently each root account may claim from this campaign.
Subaccount public id that receives this claim's reward. Zero or omitted when the reward is paid to the root account.
| 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. |