Web3 Grant & Bounty Apply

Overview

This skill enables AI Agents to discover Web3 grants and bounties on AgentRel, retrieve application requirements, and submit applications on behalf of authenticated users.

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

Authentication

All write operations require a Bearer token in the Authorization header.

Obtain a token via:

POST /api/auth/login
{ "email": "<user_email>", "password": "<password>" }
→ { "access_token": "...", "api_key": "agentrel_xxx" }

Use either access_token or api_key as the Bearer token.

Tools

1. list_grants — List open grants and bounties

GET /api/build
Query params:
  status=open|closed|all  (default: open)
  type=grant|bounty       (optional keyword filter)

Example response:

{
  "items": [
    {
      "id": "uuid",
      "title": "Solana DeFi Grant",
      "sponsor": "Solana Foundation",
      "reward": "$5,000 USDC",
      "deadline": "2026-05-01T00:00:00Z",
      "status": "open",
      "track": "DeFi"
    }
  ],
  "count": 12
}

2. get_grant — Get grant details and application schema

GET /api/build/{id}

Example response:

{
  "id": "uuid",
  "title": "...",
  "description": "...",
  "reward": "$5,000 USDC",
  "deadline": "2026-05-01T00:00:00Z",
  "application_schema": [
    { "name": "github_url", "label": "GitHub URL", "type": "url", "required": true },
    { "name": "project_description", "label": "Project Description", "type": "textarea", "required": true }
  ],
  "template_md": "## Project Background\n\n## Technical Approach\n\n## Why This Grant",
  "_apply_endpoint": "POST /api/build/{id}/apply"
}

3. apply_grant — Submit an application

POST /api/build/{id}/apply
Authorization: Bearer <token>
Content-Type: application/json

{
  "pitch": "Our project builds...",
  "custom_fields": {
    "github_url": "https://github.com/...",
    "project_description": "..."
  }
}

Fields in custom_fields should match the grant's application_schema. Use template_md (from get_grant) as a starting point for pitch.

Example response:

{
  "application_id": "uuid",
  "grant_id": "uuid",
  "grant_title": "Solana DeFi Grant",
  "status": "pending",
  "message": "Application submitted successfully."
}

Recommended Agent Workflow

1. list_grants(status="open") → pick relevant grants
2. get_grant(id) → read description, requirements, application_schema, template_md
3. Fill pitch using template_md as structure
4. apply_grant(id, pitch=<filled_text>, custom_fields=<schema_fields>) → submit

Gotchas

• application_schema may be null for grants with free-form applications — just send pitch
• Duplicate applications return 409 with existing application_id
• deadline is ISO 8601; check before applying — API returns 400 if expired
• Bearer token must be obtained from /api/auth/login — hardcoded API keys won't work for new users

Feedback

If this skill is outdated or incorrect, call: POST /api/feedback with { "skill": "agentrel/grant-apply", "issue": "<description>" }