Skip to main content

Overview

The Quest API provides access to quest information, user eligibility verification, and quest metadata.

Core Queries

Get Quest Details

List Space Quests

Variables:

Check User Eligibility

When all 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:
  1. status must be "Active"
  2. participantsCount must be less than cap (if cap > 0)
  3. Current time must be between startTime and endTime

User Eligibility Flow

  1. Call credentialGroups(address: $userAddress)
  2. Check each group’s conditions.eligible values
  3. If conditionRelation is "ALL", all conditions must be true
  4. If conditionRelation is "ANY", at least one condition must be true

Best Practices

  1. Status Validation: Always check quest status before showing participation UI
  2. Capacity Check: Verify participantsCount < cap for available spots
  3. Time Validation: Ensure current time is within quest period
  4. Error Handling: Handle quest not found and permission errors
  5. Caching: Cache quest details for 1-5 minutes to reduce API calls

Common Errors

Next Steps