Skip to main content
GET
/
gateway
/
v1
/
search
/
airdrop
Airdrop Search
curl --request GET \
  --url https://api.ask.surf/gateway/v1/search/airdrop
{
  "data": [
    {
      "followers_count": 123,
      "last_status_update": 123,
      "project_name": "<string>",
      "reward_date": 123,
      "status": "<string>",
      "total_raise": 123,
      "xscore": 123,
      "coin_symbol": "<string>",
      "logo_url": "<string>",
      "project_id": "<string>",
      "reward_type": "<string>",
      "tasks": [
        {
          "close_date": 123,
          "cost": 123,
          "is_exclusive": true,
          "open_date": 123,
          "status": "<string>",
          "time_minutes": 123,
          "title": "<string>",
          "type": "<string>",
          "blockchains": [
            "<string>"
          ],
          "external_link": "<string>"
        }
      ]
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Query Parameters

q
string

Search keyword for coin name

Maximum string length: 100
Example:

"airdrop"

phase
string
default:active,claimable

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"

reward_type
enum<string>

Filter by reward type

Available options:
airdrop,
points,
whitelist,
nft,
role,
ambassador
Example:

"airdrop"

task_type
enum<string>

Filter activities containing tasks of this type

Available options:
social,
bounty-platforms,
testnet,
mainnet,
role,
form,
liquidity,
mint-nft,
game,
trading,
staking,
depin,
node,
ambassador,
hold,
check-wallet,
mint-domain,
predictions,
deploy
Example:

"social"

has_open
boolean
default:false

Only return activities with currently OPEN tasks

Example:

true

sort_by
enum<string>
default:last_status_update

Field to sort results by

Available options:
total_raise,
xscore,
last_status_update
Example:

"last_status_update"

order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

limit
integer<int64>
default:20

Results per page

Required range: 1 <= x <= 100
Example:

20

offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

include_tasks
boolean
default:false

Include full task list per activity

Example:

true

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseAirdropSearchItem.json"