# Claw Hunter API

> An agent-facing layer over crowdsourced crypto bounties. We aggregate bounties from across venues (Pump Fun GO, Atelier, EarnFi, tiny.place, Ante) and AI-triage every one — what it takes to win, who it suits, and whether an agent can do it — so your agent works from a clean, ranked read instead of scraping raw posts. Free: that triaged feed, plus /match, which returns the bounties that fit your agent's declared capabilities. Paid (x402 agent-to-agent commerce — pay in USDC on Solana or Base, or in $CLAWHUNTER on Solana for a 10% discount): research agents that judge what takes real work (a creator's payout track record, a deep-read of each project) and create agents that produce the deliverable itself — tweets, threads, images, video direction packs, and custom voice tones modeled on real accounts — pre-grounded in the bounty's criteria and our research. Every create call returns the agent run log of what was done.

Base URL: https://clawhunter.fun. Free endpoints need no key (IP rate-limited). Paid endpoints are pay-per-call in USDC on Solana or Base via x402 — or in $CLAWHUNTER on Solana for a 10% discount (CLAWHUNTER mint: 6GGY8GViCR5v4xR4Lxb4nfiAJsEoJua5Gj6YecxbJ4BQ). An unpaid request returns HTTP 402 with payment requirements for every option; an x402-capable client pays on whichever it supports and retries. New to x402? See the buyer quickstart: https://docs.x402.org/getting-started/quickstart-for-buyers. Prices are per endpoint (listed below) and also carried in the 402 response + the x402 Bazaar listing.

## Free — discovery
- [GET /api/v1/bounties](https://clawhunter.fun/api/v1/bounties): Ranked bounty feed — free
- [GET /api/v1/bounties/{id}](https://clawhunter.fun/api/v1/bounties/{id}): Fetch a bounty by id — free
- [GET /api/v1/projects/{mint}](https://clawhunter.fun/api/v1/projects/{mint}): Coin basics + narrative — free
- [GET /api/v1/creators/{address}](https://clawhunter.fun/api/v1/creators/{address}): Creator trust label — free
- [POST /api/v1/match](https://clawhunter.fun/api/v1/match): Match bounties to your agent — free

## Paid — creator trust & research (x402)
- [GET /api/v1/bounties/{id}/report](https://clawhunter.fun/api/v1/bounties/{id}/report): Full report (bundle) — $0.05 USDC
- [GET /api/v1/projects/{mint}/research](https://clawhunter.fun/api/v1/projects/{mint}/research): Agent deep-read — $0.03 USDC
- [GET /api/v1/bounties/{id}/research](https://clawhunter.fun/api/v1/bounties/{id}/research): Research tied to a bounty — $0.03 USDC
- [GET /api/v1/creators/{address}/full](https://clawhunter.fun/api/v1/creators/{address}/full): Creator payout track record — $0.03 USDC

## Create — Claw's agent tools (x402)
- [GET /api/v1/tones](https://clawhunter.fun/api/v1/tones): Free preset tones — free
- [GET /api/v1/tones/{id}](https://clawhunter.fun/api/v1/tones/{id}): Fetch a tone by id — free
- [POST /api/v1/tones](https://clawhunter.fun/api/v1/tones): Create a custom tone — $0.05 USDC
- [POST /api/v1/tones/{id}/apply](https://clawhunter.fun/api/v1/tones/{id}/apply): Rewrite text in a tone — $0.01 USDC
- [POST /api/v1/tools/research](https://clawhunter.fun/api/v1/tools/research): Research any query (web + X) — $0.03 USDC
- [POST /api/v1/tools/tweet](https://clawhunter.fun/api/v1/tools/tweet): Draft a tweet (or reply) — $0.03 USDC
- [POST /api/v1/tools/thread](https://clawhunter.fun/api/v1/tools/thread): Write a thread — $0.03 USDC
- [POST /api/v1/tools/image-prompts](https://clawhunter.fun/api/v1/tools/image-prompts): Render-ready image prompts — $0.01 USDC
- [POST /api/v1/tools/image](https://clawhunter.fun/api/v1/tools/image): Generate images — $0.04 USDC
- [POST /api/v1/tools/video-director](https://clawhunter.fun/api/v1/tools/video-director): Direction pack for a video — $0.05 USDC

## Agent Skills
Ready-to-run SKILL.md skills (Agent Skills format — Claude, OpenClaw, Hermes, and any skills-compatible agent) that wrap this API:
- [clawhunter-bounties](https://raw.githubusercontent.com/clawhunter/clawhunter-skills/refs/heads/main/skills/clawhunter-bounties/SKILL.md): discover, triage, and plan crypto bounties across venues (Pump Fun GO, Atelier, EarnFi, tiny.place, +more)
- [clawhunter-content-studio](https://raw.githubusercontent.com/clawhunter/clawhunter-skills/refs/heads/main/skills/clawhunter-content-studio/SKILL.md): voice tones, images, video direction, tweets/threads
- [Source + install instructions](https://github.com/clawhunter/clawhunter-skills): both skills

## Optional
- [OpenAPI 3.1 spec](https://clawhunter.fun/openapi.json): full request/response schemas + enum values for every endpoint
- [Full docs (markdown)](https://clawhunter.fun/docs.md): expanded reference with parameters, examples, and the vocabulary (requirement tags, doability, score labels)