Funding Program Finder

Search the Karma Funding Map for funding programs via the public API.

The registry has 6 program types: grants, hackathons, bounties, accelerators, VC funds, and RFPs. Use “programs” / “opportunities” / “funding” — not just “grants”.

API

Base URL: https://gapapi.karmahq.xyz Endpoint: GET /v2/program-registry/search Auth: None (public)

Query Parameters

Program Types

Omitting type returns all types. Multiple types: type=grant,hackathon.

Response Shape

{
  "programs": [{ "id", "programId", "type", "name", "isValid", "isActive", "isOnKarma", "deadline", "submissionUrl", "communities": [{ "uid", "name", "slug", "imageUrl" }], "createdAt", "updatedAt", "metadata": { "title", "description", "shortDescription", "status", "startsAt", "endsAt", "categories", "ecosystems", "networks", "grantTypes", "organizations", "minGrantSize", "maxGrantSize", "programBudget", "website", "projectTwitter", "anyoneCanJoin", "socialLinks": { "twitter", "discord", "website", "orgWebsite", "grantsSite" } } }],
  "count", "totalPages", "currentPage", "hasNext", "hasPrevious"
}

Known Ecosystem Values

Ethereum, Optimism, Arbitrum, Base, Polygon, Solana, Cosmos,
Avalanche, Near, Polkadot, Sui, Aptos, Starknet, zkSync,
Scroll, Linea, Mantle, Celo, Gnosis, Fantom, Filecoin,
Internet Computer, Tezos, Algorand, Hedera, MultiversX,
TON, Sei, Injective, Osmosis, Celestia, Berachain, Monad

Known Category Values

Funding Opportunity, Grant, DAO Governance, Award,
Program Results, Upcoming Deadline, Retroactive Funding,
Quadratic Funding, Ecosystem Fund, Developer Grant,
Research, Tool

Natural Language → Query Parameters

Budget shorthand: K→000, M→000000 (e.g., $50K → 50000, $1M → 1000000).

URL encoding: Values with spaces or special characters must be percent-encoded when building curl URLs (e.g., categories=Retroactive%20Funding, not Retroactive Funding). Most HTTP clients handle this automatically, but manual URL construction requires explicit encoding.

Ecosystem Search Strategy

The ecosystems metadata field is often empty — many programs are linked to an ecosystem only via the communities field. When searching by ecosystem, run these queries in parallel and merge:

1. Community UID lookup: fetch all communities from GET /v2/communities?limit=100, find the best match for the user’s query by comparing against community names (case-insensitive, partial match), then query with communityUid={uid}
2. ecosystems={name} — matches programs with populated ecosystem metadata
3. name={name} — text search on title, universal fallback

Deduplicate all results by id before presenting.

Community UID Resolution

Slugs are not guessable (e.g., “GEN Ukraine” → gen-ukraine-community), so fetch the full list and match by name:

# Fetch all communities (~48) and find the matching UID
curl -s "https://gapapi.karmahq.xyz/v2/communities?limit=100"
# Response: { "payload": [{ "uid": "0x...", "details": { "name": "GEN Ukraine", "slug": "gen-ukraine-community" } }, ...] }
# Match user query "ukraine" against details.name (case-insensitive partial match)
# Use the matched uid in: communityUid={uid}

Query Defaults

Always include:

isValid=accepted&limit=10&sortField=updatedAt&sortOrder=desc

Override sortField and sortOrder when the user asks about deadlines — use sortField=endsAt&sortOrder=asc.

Making the Request

Use curl via Bash to call the API. Build the URL from the mapped parameters:

curl -s "https://gapapi.karmahq.xyz/v2/program-registry/search?isValid=accepted&limit=10&sortField=updatedAt&sortOrder=desc&ecosystems=Ethereum"

For ecosystem searches, run all three queries in parallel (community UID, ecosystems, name) and deduplicate by id before presenting results. See Ecosystem Search Strategy above.

Parse the JSON response and format results as described below.

Result Format

Include the program type in each result. Adapt the detail line based on type:

Found 42 programs (showing top 10):

1. **Optimism Grants** [grant] — Optimism
   Retroactive and proactive funding for Optimism builders
   Budget: $10M | Status: Active
   Apply: https://app.charmverse.io/...

2. **ETHDenver 2026** [hackathon] — Ethereum
   Annual Ethereum hackathon and conference
   Dates: Mar 1–7, 2026 | Deadline: Feb 15, 2026
   Apply: https://ethdenver.com/apply

3. **Rust Smart Contract Audit** [bounty] — Solana
   Audit Solana program for vulnerabilities
   Reward: $5,000 | Difficulty: Advanced
   Apply: https://superteam.fun/...

Showing 10 of 42. Ask for more or narrow your search.

Field Mapping

• Name: metadata.title (fall back to name)
• Type label: type in brackets: [grant], [hackathon], [bounty], [accelerator], [vc_fund], [rfp]
• Ecosystem: metadata.ecosystems joined with , (fall back to communities[0].name)
• Description: metadata.description truncated to ~120 chars

Type-Specific Detail Line

• grant: Budget: {programBudget} | Status: {status}
• hackathon: Dates: {startsAt}–{endsAt} | Deadline: {deadline}
• bounty: Reward: {programBudget} | Difficulty: {difficulty if available}
• accelerator: Stage: {stage if available} | Deadline: {deadline}
• vc_fund: Check size: {minGrantSize}–{maxGrantSize} | Stage: {stage if available}
• rfp: Budget: {programBudget} | Org: {organizations[0]} | Deadline: {deadline}
• fallback: Budget: {programBudget} | Status: {status}

Common Fields

• Deadline: deadline (top-level) formatted as Mon DD, YYYY (or “Rolling” if null)
• Apply link: submissionUrl (top-level), fall back to metadata.socialLinks.grantsSite or metadata.website or metadata.socialLinks.website (first non-empty)

Edge Cases