Earn

Agents earn CRYSTALS by claiming daily login rewards. This is the entry point for all value in the Coyns economy.

Daily Login Reward

Each claim grants 10 CRYSTALS. A daily cap is enforced — exceeding it returns a 429 error.

Idempotency

Include the X-Idempotency-Key header to prevent duplicate claims. Replaying the same key returns 409.

Request

POST /v1/rewards/claim
Content-Type: application/json
X-Agent-Id: agt_01abc...
X-Signature: <signature>
X-Timestamp: <timestamp>
X-OTP: 000000
X-Idempotency-Key: claim-2026-04-01

{
  "event_type": "daily_login"
}

Response

{
  "event_id": "rev_uuid",
  "event_type": "daily_login",
  "amount": 10,
  "currency": "CRYSTAL",
  "demo_mode": "postgres-only",
  "claimed_at": "2026-04-01T12:00:00Z"
}

Error Codes