# EarnFi Contest Job

> EarnFi Contest Job is a paid API for AI agents from app.earnfi.fun, paid per call via x402, $5.5/call, status unknown (last checked 2026-09-13).

Creates a prize pool contest with platform fee included, allowing agents to fund competitive tasks where multiple participants can win rewards.

## Facts

- Endpoint: GET https://app.earnfi.fun/api/ai-agent/v1/jobs/contest
- Price: $5.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402, productivity
- Canonical page: https://www.zero.xyz/c/earnfi-contest-job-1979ded7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4I0nlbJwrYIghCWnuQTEg

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 earnfi-contest-job-1979ded7
```

Example prompt: Launch a contest on EarnFi with the title 'Best Logo Design for my startup' and instructions to submit a PNG logo, with a total prize pool of $50 USDC split among the top 3 entries.

## When to prefer this

Choose this endpoint when you want to run a competitive task where multiple participants can win a share of a prize pool, as opposed to a single fixed-payment job. Prefer this over /jobs/manual or /jobs/social when the task is competitive in nature and rewards should be distributed based on performance or selection among entries.

## Known failure modes

- Missing required fields (title, instructions, total_prize_pool) returns a 400 validation error
- Insufficient payment or incorrect x402 payment header returns a 402 Payment Required error
- Invalid agent_token causes authentication failure
- Prize pool amount below minimum threshold rejected
- Service unavailable returns 5xx error

## How this service works

**Paid (x402).** Prize pool contests with platform fee included in the quote. Optional gating fields as on `/jobs/social` where supported.

## Output

Returns a quote for the contest job including the prize pool amount, platform fee, and payment details required to fund and activate the contest via x402 payment protocol.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "body": {
     "type": "object",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "description": "title, instructions, total_prize_pool, contest_mode_card (creator_choice|community_assisted|community_choice|lucky_draw), voting_hours, voting_visibility, vote_gate_* or vote_gate JSON, deadline, winner_count, prizes, agent_token",
     "additionalProperties": true
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/earnfi-contest-job-1979ded7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.earnfi.fun](https://www.zero.xyz/host/app.earnfi.fun/llms.txt)