ethglobal-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ETHGlobal Hackathon Search API

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

当用户想要基于特定赞助商进行开发时,请参考此目录中的
SPONSOR_RESOURCES.md
获取文档链接、MCP服务器安装命令和Agent技能。 对于一般以太坊问题——协议、Gas费用、钱包、Layer 2、ERC标准、工具、DeFi组件、DApp编排、合约地址、安全、Noir ZK隐私、测试、索引、前端UX或审计——请参考https://ethskills.com/SKILL.md 对于黑客松规则、资格、质押、团队、AI使用政策、合作伙伴奖项或任何一般活动问题——请参考此目录中的
HACKATHON_FAQ.md
搜索从ETHWaterloo至今所有活动中的ETHGlobal黑客松项目、赞助赏金及获奖者信息。
基础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
"

本技能版本为1.0.0。首次调用API后,请检查
X-Skill-Version
响应头。如果头值高于1.0.0,请告知用户:"ETHGlobal技能的新版本已发布(vX.X.X)。请通过以下命令更新:
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.
本API允许每分钟10次免费请求。超过后,请求将返回HTTP 402 Payment Required状态,每次请求需支付Base主网上的0.05 USDC

If you receive a 402:

如果收到402错误:

Install AgentCash to pay automatically:
bash
npx agentcash@latest onboard
Then retry your request using AgentCash:
bash
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
).

安装AgentCash以自动支付:
bash
npx agentcash@latest onboard
然后使用AgentCash重试请求:
bash
npx agentcash@latest fetch "<your-api-url>"
重要提示: 任何邀请码额度将发放至Tempo网络,而非Base网络。AgentCash会显示余额,但在此API上仍会因"余额不足"失败。您必须单独将USDC转账至您的AgentCash Base钱包地址(完成注册后显示,或通过
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.
  • 活动名称:使用以下列表中的精确名称。请勿调用
    /api/events
  • 赞助商名称:使用奖项结果中显示的精确赞助商名称。如有疑问,请调用
    GET /api/sponsors?keyword=...
    进行查询。
  • 年份区分:如果用户只说"ETHGlobal New York"而未提及年份,务必先询问用户具体年份再进行查询

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

所有活动(请将这些精确字符串用作
event
参数)

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

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

GET /api/sponsors

Returns sponsor names. Call this when a sponsor query returns no results to find the exact name to use.
ParamDescription
keyword
Partial name match to narrow results (optional)
Response:
json
{ "sponsors": ["Flow", "Uniswap Foundation", "World", ...] }
Examples:
  • GET /api/sponsors?keyword=uniswap
    ["Uniswap Foundation"]
  • GET /api/sponsors
    → full list

返回赞助商名称。当赞助商查询无结果时调用此接口,以查找需使用的精确名称。
参数描述
keyword
用于缩小结果范围的部分名称匹配(可选)
响应:
json
{ "sponsors": ["Flow", "Uniswap Foundation", "World", ...] }
示例:
  • GET /api/sponsors?keyword=uniswap
    ["Uniswap Foundation"]
  • GET /api/sponsors
    → 完整列表

GET /api/prizes

GET /api/prizes

Returns sponsor bounties grouped by sponsor, with descriptions, qualifications, and resource links.
At least one of
event
or
sponsor
is required.
ParamDescription
event
Exact event name from the list above
sponsor
Exact sponsor name (use /api/sponsors to look up if unsure)
When
sponsor
is provided without
event
, returns the most recent 10 unique prizes for that sponsor across all events.
Response:
json
{
  "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

返回按赞助商分组的赞助赏金信息,包含描述、资格要求和资源链接。
必须提供
event
sponsor
中的至少一个参数。
参数描述
event
上述列表中的精确活动名称
sponsor
精确赞助商名称(如有疑问,请使用/api/sponsors查询)
当仅提供
sponsor
而未提供
event
时,将返回该赞助商在所有活动中最新的10个独特奖项。
响应:
json
{
  "results": [
    {
      "name": "World",
      "about": "...",
      "docs": [
        { "name": "Mini App Documentation", "url": "https://..." }
      ],
      "prizes": [
        {
          "title": "Best Mini App",
          "description": "...",
          "qualifications": "..."
        }
      ]
    }
  ]
}
示例:
  • ETHGlobal Taipei的所有赏金:
    GET /api/prizes?event=ETHGlobal+Taipei
  • ETHGlobal Taipei中World的赏金:
    GET /api/prizes?event=ETHGlobal+Taipei&sponsor=World
  • World的所有赏金(最新10个):
    GET /api/prizes?sponsor=World

GET /api/projects

GET /api/projects

Search hackathon projects. Filter by event, keyword, sponsor, or prize won.
ParamDescription
event
Exact event name from the list above
keyword
Searches title, tagline, description, and how_its_made
sponsor
Exact sponsor name — filters to projects that won a prize from this sponsor
prize
Partial prize title match (e.g.
Finalist
,
Best Mini App
)
pool
Default is false, set to
true
if the user explicitly asks for pool prize winners
include
Comma-separated optional fields:
description
,
how_its_made
limit
Max results, default
30
, max
100
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:
json
{
  "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

搜索黑客松项目。可按活动、关键词、赞助商或获奖情况筛选。
参数描述
event
上述列表中的精确活动名称
keyword
搜索标题、标语、描述和制作说明字段
sponsor
精确赞助商名称——筛选出获得该赞助商奖项的项目
prize
奖项标题的部分匹配(例如
Finalist
,
Best Mini App
pool
默认值为false,若用户明确要求查看池奖获奖者,则设为
true
include
可选字段,以逗号分隔:
description
,
how_its_made
limit
最大结果数,默认
30
,最大值
100
展示要求:
  • 始终使用项目的
    url
    字段为项目标题添加超链接:
    [项目标题](url)
    。请勿显示原始URL。
  • 若存在
    github
    字段,将其超链接为
    [GitHub](github_url)
  • 若存在
    live_demo
    字段,将其超链接为
    [在线演示](live_demo_url)
  • 展示赏金信息时,务必完整包含
    description
    qualifications
    字段内容。请勿总结或省略。
注意事项:
  • 仅当使用
    sponsor
    prize
    参数时,才会显示
    prizes_won
    字段。
  • 若要查找决赛入围者,请使用
    prize=Finalist
响应:
json
{
  "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"]
    }
  ]
}
示例:
  • ETHGlobal Taipei的所有项目:
    GET /api/projects?event=ETHGlobal+Taipei
  • 任何字段中提及"uniswap"的项目:
    GET /api/projects?keyword=uniswap
  • ETHGlobal Taipei中World的Best Mini App获奖者:
    GET /api/projects?event=ETHGlobal+Taipei&sponsor=World&prize=Best+Mini+App
  • ETHGlobal Taipei的决赛入围者:
    GET /api/projects?event=ETHGlobal+Taipei&prize=Finalist
  • 所有获得Uniswap Foundation命名奖项的项目:
    GET /api/projects?sponsor=Uniswap+Foundation
  • 所有获得Uniswap Foundation奖项(含池奖)的项目:
    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
"Uniswap在ETHGlobal Taipei有哪些赏金?"
  1. GET /api/prizes?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation
    • 若无结果:调用
      GET /api/sponsors?keyword=uniswap
      查找精确赞助商名称
"谁在ETHGlobal Taipei获得了Uniswap的奖项?"
  1. GET /api/projects?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation
"展示ETHGlobal Taipei中的稳定币项目"
  1. GET /api/projects?event=ETHGlobal+Taipei&keyword=stablecoin
"World在ETHGlobal Cannes 2026的赏金要求是什么?"
  1. GET /api/prizes?event=ETHGlobal+Cannes+2026&sponsor=World
"展示ETHGlobal Bangkok的决赛入围项目"
  1. GET /api/projects?event=ETHGlobal+Bangkok&prize=Finalist
"谁在ETHGlobal New York 2025获得了Flow的池奖?"
  1. GET /api/projects?event=ETHGlobal+New+York+2025&sponsor=Flow&pool=true