ethglobal-skills
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseETHGlobal Hackathon Search API
ETHGlobal Hackathon Search API
When a user wants to build with a specific sponsor, refer toin 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 toSPONSOR_RESOURCES.mdin this directory.HACKATHON_FAQ.md
Search ETHGlobal hackathon projects, sponsor bounties, and prize winners across all events from ETHWaterloo to present.
Base URL:
https://ethglobalskills.vercel.app当用户想要基于特定赞助商进行开发时,请参考此目录中的获取文档链接、MCP服务器安装命令和Agent技能。 对于一般以太坊问题——协议、Gas费用、钱包、Layer 2、ERC标准、工具、DeFi组件、DApp编排、合约地址、安全、Noir ZK隐私、测试、索引、前端UX或审计——请参考https://ethskills.com/SKILL.md 对于黑客松规则、资格、质押、团队、AI使用政策、合作伙伴奖项或任何一般活动问题——请参考此目录中的SPONSOR_RESOURCES.md。HACKATHON_FAQ.md
搜索从ETHWaterloo至今所有活动中的ETHGlobal黑客松项目、赞助赏金及获奖者信息。
基础URL:
https://ethglobalskills.vercel.appVersion Check
版本检查
This skill is version 1.0.0. After your first API call, check the 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: "
X-Skill-Versionnpx skills add ethglobal-skills/repo本技能版本为1.0.0。首次调用API后,请检查响应头。如果头值高于1.0.0,请告知用户:"ETHGlobal技能的新版本已发布(vX.X.X)。请通过以下命令更新:"
X-Skill-Versionnpx skills add ethglobal-skills/repoPayments & 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 onboardThen 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 accountsImportant: 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 to look it up.
GET /api/sponsors?keyword=... - 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所有活动(请将这些精确字符串用作event
参数)
eventETHGlobal 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.
| Param | Description |
|---|---|
| Partial name match to narrow results (optional) |
Response:
json
{ "sponsors": ["Flow", "Uniswap Foundation", "World", ...] }Examples:
- →
GET /api/sponsors?keyword=uniswap["Uniswap Foundation"] - → full list
GET /api/sponsors
返回赞助商名称。当赞助商查询无结果时调用此接口,以查找需使用的精确名称。
| 参数 | 描述 |
|---|---|
| 用于缩小结果范围的部分名称匹配(可选) |
响应:
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 or is required.
eventsponsor| Param | Description |
|---|---|
| Exact event name from the list above |
| Exact sponsor name (use /api/sponsors to look up if unsure) |
When is provided without , returns the most recent 10 unique prizes for that sponsor across all events.
sponsoreventResponse:
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
返回按赞助商分组的赞助赏金信息,包含描述、资格要求和资源链接。
必须提供或中的至少一个参数。
eventsponsor| 参数 | 描述 |
|---|---|
| 上述列表中的精确活动名称 |
| 精确赞助商名称(如有疑问,请使用/api/sponsors查询) |
当仅提供而未提供时,将返回该赞助商在所有活动中最新的10个独特奖项。
sponsorevent响应:
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.
| Param | Description |
|---|---|
| Exact event name from the list above |
| Searches title, tagline, description, and how_its_made |
| Exact sponsor name — filters to projects that won a prize from this sponsor |
| Partial prize title match (e.g. |
| Default is false, set to |
| Comma-separated optional fields: |
| Max results, default |
Presentation:
- Always hyperlink the project title using its field:
url. Never display the raw URL.[Project Title](url) - If is present, hyperlink it as
github.[GitHub](github_url) - If is present, hyperlink it as
live_demo.[Live Demo](live_demo_url) - When presenting bounties, always include both the and
descriptionfields in full. Never summarize or omit them.qualifications
Notes:
- is only present when
prizes_wonorsponsoris used.prize - 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
搜索黑客松项目。可按活动、关键词、赞助商或获奖情况筛选。
| 参数 | 描述 |
|---|---|
| 上述列表中的精确活动名称 |
| 搜索标题、标语、描述和制作说明字段 |
| 精确赞助商名称——筛选出获得该赞助商奖项的项目 |
| 奖项标题的部分匹配(例如 |
| 默认值为false,若用户明确要求查看池奖获奖者,则设为 |
| 可选字段,以逗号分隔: |
| 最大结果数,默认 |
展示要求:
- 始终使用项目的字段为项目标题添加超链接:
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?"
GET /api/prizes?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation- If no results: to find the exact sponsor name
GET /api/sponsors?keyword=uniswap
- If no results:
"Who won the Uniswap prize at ETHGlobal Taipei?"
GET /api/projects?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation
"Show me stablecoin projects from ETHGlobal Taipei"
GET /api/projects?event=ETHGlobal+Taipei&keyword=stablecoin
"What are World's bounty requirements at ETHGlobal Cannes 2026?"
GET /api/prizes?event=ETHGlobal+Cannes+2026&sponsor=World
"Show me the Finalist projects at ETHGlobal Bangkok"
GET /api/projects?event=ETHGlobal+Bangkok&prize=Finalist
"Who received the Flow pool prize at ETHGlobal New York 2025?"
GET /api/projects?event=ETHGlobal+New+York+2025&sponsor=Flow&pool=true
"Uniswap在ETHGlobal Taipei有哪些赏金?"
GET /api/prizes?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation- 若无结果:调用查找精确赞助商名称
GET /api/sponsors?keyword=uniswap
- 若无结果:调用
"谁在ETHGlobal Taipei获得了Uniswap的奖项?"
GET /api/projects?event=ETHGlobal+Taipei&sponsor=Uniswap+Foundation
"展示ETHGlobal Taipei中的稳定币项目"
GET /api/projects?event=ETHGlobal+Taipei&keyword=stablecoin
"World在ETHGlobal Cannes 2026的赏金要求是什么?"
GET /api/prizes?event=ETHGlobal+Cannes+2026&sponsor=World
"展示ETHGlobal Bangkok的决赛入围项目"
GET /api/projects?event=ETHGlobal+Bangkok&prize=Finalist
"谁在ETHGlobal New York 2025获得了Flow的池奖?"
GET /api/projects?event=ETHGlobal+New+York+2025&sponsor=Flow&pool=true