Create Earn Event

Send raw event data to Absinthe, which will then be processed by your custom business rules to generate points for users.

Conceptual Overview

Think of this as a two-step process:

1. Send Raw Data: Use this API to report that something happened (e.g., "user killed 5 monsters", "user minted 3 NFTs", "user scored 1,250 points in leaderboard")
2. Rules Processing: Absinthe applies your configured business rules to convert this raw data into points (e.g., "5 monsters × 10 points each = 50 points", "3 NFTs × bonus multiplier = 75 points")

Example Event Types

• Gaming: Monsters killed, levels completed, achievements unlocked
• DeFi: Tokens swapped, liquidity provided, transactions completed
• Social: Posts created, likes received, referrals made
• Commerce: Items purchased, reviews written, loyalty actions

API Details

• Endpoint: https://gql3.absinthe.network/api/rest/earn-event
• Method: POST
• Auth: Authorization header (API key generated per campaign)
• Payload: Raw event data — not processed points

Authorization

Authorization: Bearer \<YOUR_API_KEY>

Sending Event Data

curl -X POST https://gql3.absinthe.network/api/rest/earn-event \
  -H "Authorization: Bearer \<YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
        "account_id":   "0x123",
        "amount":       15,
        "identity_type": "EVM_ADDRESS",
        "reg_event_id": "9bb4c38c-c3e9-4d74-a8c4-f617ccd9aa4a"
      }'

Real-world Examples

curl -X POST https://gql3.absinthe.network/api/rest/earn-event \
  -H "Authorization: Bearer \<YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
        "account_id":   "player123@email.com",
        "amount":       25,           // 25 monsters killed this session
        "identity_type": "EMAIL",
        "reg_event_id": "monsters-killed-event-id"
      }'

curl -X POST https://gql3.absinthe.network/api/rest/earn-event \
  -H "Authorization: Bearer \<YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
        "account_id":   "0xABC123...",
        "amount":       1500.50,      // $1,500.50 in trading volume
        "identity_type": "EVM_ADDRESS",
        "reg_event_id": "trading-volume-event-id"
      }'

How Rules Convert Data to Points

After you send raw event data, Absinthe processes it through your configured rules:

Raw Event: "User killed 15 monsters"
↓
Business Rule: "1 monster = 10 points, with 2x multiplier for 10+ monsters"
↓
Final Points: (15 × 10) × 2 = 300 points awarded

Raw Event: "User traded $1,500 volume"
↓
Business Rule: "Every $100 volume = 5 points, max 100 points per day"
↓
Final Points: min(1500/100 × 5, 100) = 75 points awarded

Behavior Rules

Identity Types

Parameters

Error Handling

All requests return 200 OK. Check the top-level errors[] array for GraphQL failures:

{
  "data": null,
  "errors": [
    {
      "message": "invalid identity_type",
      "extensions": { "code": "validation-failed" }
    }
  ]
}

FAQ

What's the difference between event data and points?

Event data is raw metrics (15 monsters killed, $500 traded). Points are the processed output after your business rules are applied (15 monsters → 150 points via your multipliers).

Can I send the same event multiple times?

Yes. Each call logs a new event occurrence. If a user kills 10 monsters, then later kills 5 more, send two separate events with amount: 10 and amount: 5.

How do I set up the business rules?

Configure your rules in the Absinthe dashboard under Rules Engine. Define how raw event values should be converted to points, including multipliers, caps, and conditions.

Why separate raw data from points calculation?

This architecture lets you change your point economics without losing historical data. You can adjust multipliers, add seasonal bonuses, or implement complex rules while preserving the original event log.