ClaimsService
Get Daily Claim Status
Get today's reward and claim status for the authenticated root account. Requires a session JWT; API keys are not accepted. Future reward schedules are not returned.
Method
GET
Path
/v1/trading/daily-claim
Visibility
Authentication
Session token
MFA Requirement
Not required
GET
/v1/trading/daily-claim Request
Testnet
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/trading/daily-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'
Responses
{
"campaign": {
"campaignId": "value",
"claimPolicy": "UTC_DAILY",
"description": "Example configuration for the API playground.",
"name": "value"
},
"claimId": "value",
"resetAt": "2025-01-01T00:00:00Z",
"rewards": [
{
"amount": "18.446744073709551617",
"assetCode": "USDC",
"assetId": 100
}
],
"state": "AVAILABLE"
} 4 fields
campaignId string
Stable campaign identifier.
Example
value claimPolicy enum
How frequently each root account may claim from this campaign.
UTC_DAILY
Example
UTC_DAILY description string
Campaign description. Existing claims retain the description that applied when they were created.
Example
Example configuration for the API playground. name string
Campaign name. Existing claims retain the name that applied when they were created.
Example
value claimId string
Claim identifier. Empty until a claim has been created.
Example
value resetAt string (date-time)
Start of the next UTC calendar day.
Example
2025-01-01T00:00:00Z 3 fields
amount string
Claim amount in 18-decimal unified asset units.
Example
18.446744073709551617 assetCode string
Asset code.
Example
USDC assetId integer (int32)
Asset identifier.
Example
100 state enum
Current state of today's claim.
AVAILABLE PROCESSING CLAIMED UNAVAILABLE
Example
AVAILABLE| 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. |