HackList

Search and filter HackList's AI & Web3 hackathons, grants, bounties and programs. Filters by keyword, type, category, format, prize, how soon it closes and how recently it was posted or updated. Duplicate listings of the same event are collapsed by default. Use get_opportunity for the full brief and eligibility details of a result.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keywords, e.g. 'zk privacy', 'trading bot', 'Solana', 'computer vision'.",
      "type": "string"
    },
    "kind": {
      "default": "any",
      "type": "string",
      "enum": [
        "hackathon",
        "program",
        "grant",
        "bounty",
        "job",
        "any"
      ]
    },
    "category": {
      "default": "any",
      "type": "string",
      "enum": [
        "ai",
        "web3",
        "any"
      ]
    },
    "format": {
      "default": "any",
      "type": "string",
      "enum": [
        "online",
        "in-person",
        "hybrid",
        "any"
      ]
    },
    "free_only": {
      "default": false,
      "type": "boolean"
    },
    "min_prize_usd": {
      "description": "Minimum headline prize in USD (approximate conversion for other currencies).",
      "type": "number",
      "minimum": 0
    },
    "cash_only": {
      "default": false,
      "description": "Exclude rewards that are mostly credits or in-kind.",
      "type": "boolean"
    },
    "closes_within_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "updated_within_days": {
      "description": "Only listings posted or updated on HackList in the last N days.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "include_closed": {
      "default": false,
      "description": "Also search past listings from HackList's archive (slower the first time).",
      "type": "boolean"
    },
    "collapse_duplicates": {
      "default": true,
      "type": "boolean"
    },
    "sort": {
      "default": "relevance",
      "type": "string",
      "enum": [
        "relevance",
        "deadline",
        "prize",
        "newest"
      ]
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full details for one HackList listing: brief, prize (with USD estimate and cash vs credits), deadline and days left, when it was posted/updated on HackList, apply link, eligibility traps (students only, region-locked, in-person, approval needed) and duplicate listings. Accepts a HackList URL, an id, or a title.

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 2,
      "description": "HackList URL, listing id, or title (e.g. 'Qloo Agentic Hackathon')."
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ranks open HackList opportunities for a specific builder and explains each pick. Favours specific briefs (a named API, dataset, metric or protocol) over generic 'build anything with AI' events, weighs prize size and whether it is real cash, deadline runway and accessibility, collapses duplicate listings, and drops events the builder can't enter (students only, region-locked, in-person, partners only). Returns why each one ranks and what to watch out for.

{
  "type": "object",
  "properties": {
    "skills": {
      "description": "e.g. ['solidity', 'python', 'langgraph', 'zk']",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "interests": {
      "description": "e.g. ['agents', 'defi', 'fintech', 'africa']",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "country": {
      "description": "Where the builder is based, for region-locked events.",
      "type": "string"
    },
    "is_student": {
      "type": "boolean"
    },
    "can_travel": {
      "description": "false = drop in-person-only events.",
      "type": "boolean"
    },
    "cash_only": {
      "default": false,
      "type": "boolean"
    },
    "min_days_left": {
      "default": 2,
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_days_left": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "kind": {
      "default": "hackathon",
      "type": "string",
      "enum": [
        "hackathon",
        "program",
        "grant",
        "bounty",
        "job",
        "any"
      ]
    },
    "include_generic": {
      "default": false,
      "description": "Set true to stop down-ranking generic briefs.",
      "type": "boolean"
    },
    "limit": {
      "default": 8,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Listings posted or updated on HackList in the last N days, newest first. Useful for 'what got added this week'. Uses HackList's own posted date when the site exposes it, otherwise its sitemap last-modified time.

{
  "type": "object",
  "properties": {
    "days": {
      "default": 7,
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "open_only": {
      "default": true,
      "type": "boolean"
    },
    "limit": {
      "default": 15,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Open listings whose deadline is within N days, soonest first, with the prize and whether it's worth a sprint.

{
  "type": "object",
  "properties": {
    "days": {
      "default": 7,
      "type": "integer",
      "minimum": 0,
      "maximum": 60
    },
    "min_prize_usd": {
      "type": "number",
      "minimum": 0
    },
    "limit": {
      "default": 15,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A snapshot of HackList right now: how many open listings by type and category, total listed prize money, the biggest prizes, duplicate listings found, and how fresh/complete this server's data is. Pass refresh=true to re-fetch.

{
  "type": "object",
  "properties": {
    "refresh": {
      "default": false,
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search open HackList hackathons, grants and programs by keyword. Returns ids to pass to fetch. (Compatibility tool for ChatGPT connectors and deep research.)

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keywords"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch the full HackList listing for an id returned by search. (Compatibility tool for ChatGPT connectors and deep research.)

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing id from search"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}