Overview
The Quest API provides access to quest information, user eligibility verification, and quest metadata.Core Queries
Get Quest Details
List Space Quests
Check User Eligibility
conditions.eligible are true, the user meets quest requirements.
Field Reference
Quest Status
Quest Types
Gas Types
Key Fields
Integration Patterns
Basic Quest Validation
Quest Status Validation
Check these conditions before allowing participation:statusmust be"Active"participantsCountmust be less thancap(if cap > 0)- Current time must be between
startTimeandendTime
User Eligibility Flow
- Call
credentialGroups(address: $userAddress) - Check each group’s
conditions.eligiblevalues - If
conditionRelationis"ALL", all conditions must betrue - If
conditionRelationis"ANY", at least one condition must betrue
Best Practices
- Status Validation: Always check quest status before showing participation UI
- Capacity Check: Verify
participantsCount < capfor available spots - Time Validation: Ensure current time is within quest period
- Error Handling: Handle quest not found and permission errors
- Caching: Cache quest details for 1-5 minutes to reduce API calls
Common Errors
Next Steps
- Quest Integration Guide - Complete implementation patterns
- Credential API Reference - User verification
- Authentication - Access token setup