# Giveth Project Matcher

> Giveth Project Matcher is a paid API for AI agents from giveth.0000402.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Accepts a free-text donor intent description and returns 10 ranked Giveth project recommendations with match explanations

## Facts

- Endpoint: POST https://giveth.0000402.xyz/matches
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/giveth-0000402-xyz-76419dd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D85WLRi9j9MiVbktuq8_J

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability giveth-0000402-xyz-76419dd0 -d '<json body>'
```

Example prompt: I want to donate to causes fighting climate change and ocean conservation — can you find me the 10 best Giveth projects that match that intent and explain why each one is a good fit?

## When to prefer this

Use this endpoint when an agent or user wants to discover Giveth-specific projects by semantic cause description rather than keyword search. Ideal for philanthropic agents helping users allocate crypto donations to impact-aligned projects on Base Mainnet.

## Known failure modes

- Insufficient USDC balance or failed x402 micropayment results in 402 Payment Required
- Vague or empty cause description may return low-relevance matches
- No matching projects found for highly niche causes
- Rate limiting or service unavailability on Base Mainnet

## How this service works

Pay $0.10 USDC to search Giveth projects by donor intent. Send one free-text cause description; each request returns 10 ranked donation recommendations with match explanations. Network: Base Mainnet.

## Output

A ranked list of 10 Giveth projects most relevant to the submitted cause description, each accompanied by an explanation of why it matches the donor's stated intent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 1000,
   "minLength": 3,
   "description": "Free-text donor intent for this request. Describe the cause, region, beneficiary, or project type to match against Giveth projects."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "I want to support open-source smart contract security and anti-scam education",
  "results": [
   {
    "url": "https://giveth.io/project/example",
    "why": "matched 'security', 'education' · best-matching section: \"Impact\"",
    "rank": 1,
    "title": "Example Giveth project",
    "themes": [
     "security",
     "education"
    ],
    "summary": "A short project summary.",
    "verified": true,
    "project_id": "12345"
   }
  ],
  "detected": {},
  "reranked": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/giveth-0000402-xyz-76419dd0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from giveth.0000402.xyz](https://www.zero.xyz/host/giveth.0000402.xyz/llms.txt)