Crypto Airdrop Search & Filter

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Search keyword for coin name. Example: airdrop."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Example: 20. Defaults to 20."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort order. Example: desc. Defaults to \"desc\"."
    },
    "phase": {
      "type": "string",
      "default": "active,claimable",
      "minLength": 1,
      "description": "Comma-separated lifecycle phases. active = tasks open, can participate (POTENTIAL + CONFIRMED). claimable = eligible, can claim (SNAPSHOT + VERIFICATION + REWARD_AVAILABLE). completed = done (DISTRIBUTED). Defaults to active,claimable to show actionable airdrops. Example: active. Defaults to \"active,claimable\"."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. Example: 0. Defaults to 0."
    },
    "sort_by": {
      "enum": [
        "total_raise",
        "xscore",
        "last_status_update"
      ],
      "type": "string",
      "default": "last_status_update",
      "description": "Field to sort results by. Example: last_status_update. Defaults to \"last_status_update\"."
    },
    "has_open": {
      "type": "boolean",
      "default": false,
      "description": "Only return activities with currently OPEN tasks. Example: True. Defaults to false."
    },
    "task_type": {
      "enum": [
        "social",
        "bounty-platforms",
        "testnet",
        "mainnet",
        "role",
        "form",
        "liquidity",
        "mint-nft",
        "game",
        "trading",
        "staking",
        "depin",
        "node",
        "ambassador",
        "hold",
        "check-wallet",
        "mint-domain",
        "predictions",
        "deploy"
      ],
      "type": "string",
      "description": "Filter activities containing tasks of this type. Example: social."
    },
    "reward_type": {
      "enum": [
        "airdrop",
        "points",
        "whitelist",
        "nft",
        "role",
        "ambassador"
      ],
      "type": "string",
      "description": "Filter by reward type. Example: airdrop."
    },
    "include_tasks": {
      "type": "boolean",
      "default": false,
      "description": "Include full task list per activity. Example: True. Defaults to false."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Lifecycle status within the requested phase, e.g. 'CONFIRMED'. The full set of values is documented upstream by phase (active: POTENTIAL/CONFIRMED, claimable: SNAPSHOT/VERIFICATION/REWARD_AVAILABLE, completed: DISTRIBUTED) but only 'CONFIRMED' has been observed on a real call."
          },
          "xscore": {
            "type": "number",
            "description": "A social/influence score. Observed as 0 on the one real result seen."
          },
          "project_id": {
            "type": "string",
            "description": "The provider's internal project id."
          },
          "coin_symbol": {
            "type": "string",
            "description": "e.g. 'ARB'."
          },
          "reward_date": {
            "type": "number",
            "description": "Unix seconds for a scheduled reward event. Observed as 0 (unset/unknown) on the one real result seen -- not confirmed to ever hold a real timestamp."
          },
          "reward_type": {
            "type": "string",
            "description": "e.g. 'airdrop', 'points', 'whitelist', 'nft', 'role', 'ambassador'."
          },
          "total_raise": {
            "type": "number",
            "description": "Total funding raised by the project, in USD, per the provider."
          },
          "project_name": {
            "type": "string",
            "description": "The project's own public name, e.g. 'Arbitrum'."
          },
          "task_summary": {
            "type": "object",
            "properties": {
              "open": {
                "type": "number",
                "description": "Currently open task count."
              },
              "total": {
                "type": "number",
                "description": "Total task count for this project."
              },
              "types": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Distinct task type labels, e.g. 'liquidity', 'mint-nft'."
              }
            },
            "additionalProperties": true
          },
          "followers_count": {
            "type": "number",
            "description": "Social follower count. Observed as 0 on the one real result seen."
          },
          "last_status_update": {
            "type": "number",
            "description": "Unix seconds of the most recent status change."
          }
        },
        "additionalProperties": true
      },
      "description": "Matching airdrop opportunities. Empty when no project matches the search."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number"
        },
        "cached": {
          "type": "boolean"
        },
        "offset": {
          "type": "number"
        },
        "has_more": {
          "type": "boolean",
          "description": "True when more matching results exist beyond this page."
        }
      },
      "additionalProperties": true
    }
  },
  "description": "Search results for airdrop opportunities matching the given filters.",
  "additionalProperties": true
}