Ethglobal Skills

ETHGlobal Hackathon Search API

When a user wants to build with a specific sponsor, refer to SPONSOR_RESOURCES.md in this directory for docs links, MCP server installation commands, and agent skills. For general Ethereum questions — the protocol, gas/costs, wallets, layer 2s, ERC standards, tools, DeFi legos, dapp orchestration, contract addresses, security, Noir ZK privacy, testing, indexing, frontend UX, or auditing — refer to https://ethskills.com/SKILL.md For hackathon rules, eligibility, staking, teams, AI usage policy, partner prizes, or any general event questions — refer to HACKATHON_FAQ.md in this directory.

Search ETHGlobal hackathon projects, sponsor bounties, and prize winners across all events from ETHWaterloo to present.

Base URL: https://ethglobalskills.vercel.app

Version Check

This skill is version 1.0.0. After your first API call, check the X-Skill-Version response header. If the header value is higher than 1.0.0, tell the user: "A newer version of the ETHGlobal skill is available (vX.X.X). Update with: npx skills add ethglobal-skills/repo"

Payments & Rate Limiting

This API allows 10 free requests per minute. After that, requests return HTTP 402 Payment Required and must be paid with $0.05 USDC on Base mainnet per request.

If you receive a 402:

Install AgentCash to pay automatically:

bashCopy code
npx agentcash@latest onboard

Then retry your request using AgentCash:

bashCopy code
npx agentcash@latest fetch "<your-api-url>"

Important: Any invite code credits land on the Tempo network, not Base. AgentCash will show a balance but still fail on this API with "Insufficient balance." You must separately transfer USDC to your AgentCash Base wallet address (shown after onboarding, or via npx agentcash@latest accounts).

Important: Always use exact names

• Event names: Use the exact name from the list below. Do not call /api/events.
• Sponsor names: Use the exact sponsor name as it appears in prize results. If unsure, call GET /api/sponsors?keyword=... to look it up.
• Year disambiguation: If the user says "ETHGlobal New York" without a year, ALWAYS ask them which year before querying.

All events (use these exact strings for the event param)

ETHGlobal Mumbai, ETHGlobal Tokyo 2026, ETHOnline 2026, ETHGlobal Lisbon 2026, ETHGlobal New York 2026, Open Agents, ETHGlobal Cannes 2026, HackMoney 2026, ETHGlobal Buenos Aires, ETHOnline 2025, ETHGlobal New Delhi, ETHGlobal New York 2025, Unite Defi, ETHGlobal Cannes, ETHGlobal Prague, ETHGlobal Taipei, ETHGlobal Trifecta, Agentic Ethereum, ETHGlobal Bangkok, ETHGlobal San Francisco, ETHGlobal Singapore, ETHOnline 2024, Superhack 2024, ETHGlobal Brussels, StarkHack, HackFS 2024, ETHGlobal Sydney, Scaling Ethereum 2024, Frameworks, ETHGlobal London, Circuit Breaker, LFGHO, ETHIndia 2023, ETHGlobal Istanbul, ETHOnline 2023, ETHGlobal New York, Superhack, ETHGlobal Paris, ETHGlobal Waterloo, HackFS 2023, Autonomous Worlds, ETHGlobal Lisbon, ETHGlobal Tokyo, Scaling Ethereum 2023, FVM Space Warp, ETHIndia 2022, Hack FEVM, ETHSanFrancisco 2022, ETHBogotá, ETHOnline 2022, ETHMexico, Metabolism, HackFS 2022, ETHNewYork 2022, HackMoney 2022, ETHAmsterdam, DAOHacks, LFGrow, BuildQuest, Road to Web3, NFTHack 2022, Web3Jam, UniCode, ETHOnline 2021, HackFS 2021, HackMoney 2021, Web3 Weekend, Scaling Ethereum, NFTHack, MarketMake, ETHOnline, HackFS, HackMoney, ETHLondonUK, ETHWaterloo 2019, ETHBoston, ETHNewYork, ETHCapeTown, ETHParis, ETHSingapore, ETHSanFrancisco, ETHWaterloo

Endpoints

GET /api/sponsors

Returns sponsor names. Call this when a sponsor query returns no results to find the exact name to use.

Response:

jsonCopy code
{ "sponsors": ["Flow", "Uniswap Foundation", "World", ...] }

Examples:

• GET /api/sponsors?keyword=uniswap → ["Uniswap Foundation"]
• GET /api/sponsors → full list

GET /api/prizes

Returns sponsor bounties grouped by sponsor, with descriptions, qualifications, and resource links.

At least one of event or sponsor is required.

When sponsor is provided without event, returns the most recent 10 unique prizes for that sponsor across all events.

Response:

jsonCopy code
{
  "results": [
    {
      "name": "World",
      "about": "...",
      "docs": [
        { "name": "Mini App Documentation", "url": "https://..." }
      ],
      "prizes": [
        {
          "title": "Best Mini App",
          "description": "...",
          "qualifications": "..."
        }
      ]
    }
  ]
}

Examples:

• All bounties at ETHGlobal Taipei: GET /api/prizes?event=ETHGlobal+Taipei
• World's bounties at ETHGlobal Taipei: GET /api/prizes?event=ETHGlobal+Taipei&sponsor=World
• All World bounties (most recent 10): GET /api/prizes?sponsor=World

GET /api/projects

Search hackathon projects. Filter by event, keyword, sponsor, or prize won.

Presentation:

• Always hyperlink the project title using its url field: [Project Title](url). Never display the raw URL.
• If github is present, hyperlink it as [GitHub](github_url).
• If live_demo is present, hyperlink it as [Live Demo](live_demo_url).
• When presenting bounties, always include both the description and qualifications fields in full. Never summarize or omit them.

Notes:

• prizes_won is only present when sponsor or prize is used.
• For finalists, use prize=Finalist.

Response:

jsonCopy code
{
  "projects": [
    {
      "title": "Realove",
      "url": "https://ethglobal.com/showcase/realove-siv7w",
      "tagline": "...",
      "github": "https://github.com/...",
      "live_demo": "https://...",
      "hackathon": "ETHGlobal Taipei",
      "prizes_won": ["Best Mini App 1st place"]
    }
  ]
}

Examples:

• All projects at ETHGlobal Taipei: GET /api/projects?event=ETHGlobal+Taipei
• Projects mentioning "uniswap" in any field: GET /api/projects?keyword=uniswap
• World's Best Mini App winners at ETHGlobal Taipei: GET /api/projects?event=ETHGlobal+Taipei&sponsor=World&prize=Best+Mini+App
• Finalists at ETHGlobal Taipei: GET /api/projects?event=ETHGlobal+Taipei&prize=Finalist
• All Uniswap Foundation named prize winners: GET /api/projects?sponsor=Uniswap+Foundation
• All Uniswap Foundation winners including pool: GET /api/projects?sponsor=Uniswap+Foundation&pool=true

Typical workflows

"What bounties does Uniswap have at ETHGlobal Taipei?"

1. GET /api/prizes?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation
   • If no results: GET /api/sponsors?keyword=uniswap to find the exact sponsor name

"Who won the Uniswap prize at ETHGlobal Taipei?"

1. GET /api/projects?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation

"Show me stablecoin projects from ETHGlobal Taipei"

1. GET /api/projects?event=ETHGlobal+Taipei&keyword=stablecoin

"What are World's bounty requirements at ETHGlobal Cannes 2026?"

1. GET /api/prizes?event=ETHGlobal+Cannes+2026&sponsor=World

"Show me the Finalist projects at ETHGlobal Bangkok"

1. GET /api/projects?event=ETHGlobal+Bangkok&prize=Finalist

"Who received the Flow pool prize at ETHGlobal New York 2025?"

1. GET /api/projects?event=ETHGlobal+New+York+2025&sponsor=Flow&pool=true