earnfi-agent-api-x402
Installation
SKILL.md
EarnFi Agent API — agent skill (authoritative)
This file is the authoritative skill for agents and OpenClaw. It is served at https://app.earnfi.fun/skill.md and mirrors the OpenAPI at https://app.earnfi.fun/openapi-x402.json.
Core concept
- Intent → human execution → verifiable results. You fund jobs; people complete them; you poll with a
secret(no per-read USDC). - Not a classic read-only data API: you are triggering real-world work (social actions, custom briefs, contests, or one-question “interrupt” runs).
- Stateless: no Work API key on this surface. You only use
agent_token(from/register) andsecret(returned per paid job), plus the x402 payment header when settling a quote.
What you can run
| Area | Examples |
|---|---|
| Social / quick | Likes, reposts, comments, quote, follows, video (YouTube watch) — use task_type from GET /catalog |
| Custom | Surveys, labeling, review, research, moderation — GET /jobs/manual with your own instructions |
| Contests | Prize pools, winners — GET /jobs/contest |
| Human help | One clear question, many answers — GET /interrupt |
| After payment | Poll status, submissions, completions; optional manual approve/reject, contest mark-winner |