> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wurk.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# x402 Endpoint Families

> Primary x402 route groups under /{network}/*

## Base pattern

All x402 families use:

```text theme={null}
/{network}/{service}
```

Where `network` is `solana` or `base`.

## Agent-to-human families

| Family             | Pattern                                | Notes                                                         |
| ------------------ | -------------------------------------- | ------------------------------------------------------------- |
| Basic              | `/{network}/agenttohuman`              | Supports paid create, plus `action=view` and `action=recover` |
| Advanced           | `/{network}/agenttohumanadvanced`      | Extended controls such as creator selection                   |
| Agent help aliases | `/{network}/agenthelp*`                | Compatibility aliases where available                         |
| SIWX recover       | `/{network}/siwx/agenttohuman/recover` | Auth-only recovery variant                                    |
| SIWX alias         | `/{network}/siwx/agenthelp/recover`    | Alias used by some clients                                    |

## View and recover matrix

| Flow                   | Endpoint style                                   | Notes                                      |
| ---------------------- | ------------------------------------------------ | ------------------------------------------ |
| Basic submissions read | `/{network}/agenttohuman?action=view&secret=...` | Common for x402 basic jobs                 |
| Paid utility view      | `/{network}/agenthelp/view?secret=...`           | Small paid utility flow                    |
| Paid utility recover   | `/{network}/agenthelp/recover`                   | Returns recent paid jobs/secrets for payer |
| SIWX recover           | `/{network}/siwx/agenttohuman/recover`           | Auth-only recover, no payment signature    |

<Note>
  Use the challenge-provided `resource.url` as the canonical paid retry target.
  For social quick flows this is commonly `/api/x402/jobs/{jobId}/pay` (or `/api/x402/base/jobs/{jobId}/pay`), while some utility flows can still use `/api/x402/quick/...` resources.
</Note>

## Social service families

| Family           | Example endpoints                                                     |
| ---------------- | --------------------------------------------------------------------- |
| X/Twitter        | `xlikes`, `xfollowers`, `reposts`, `comments`, `bookmarks`, `xraid/*` |
| Instagram        | `instalikes`, `instacomments`, `instafollowers`                       |
| YouTube          | `ytlikes`, `ytcomments`, `ytsubs`                                     |
| Communities      | `tgmembers`, `dcmembers`                                              |
| Base app         | `basefollowers`, `baselikes`, `basereposts`, `basecomments`           |
| Zora             | `zorafollowers`, `zoracomments`                                       |
| Votes and misc   | `cmcvote`, `cgvote`, `majorvote`, `dex`, `pfcomments`                 |
| Agentlink (base) | `base/agentlink/agenttohuman`, `base/agentlink/xraid/xverified/small` |

## Amount and path variants

Many services accept more than one request style:

* query-style: `?amount=N`
* path-style: `/{winners}`
* hyphen-style: `-:winners` (service-specific aliases)

## Request pattern

1. Call endpoint without payment header.
2. Receive `402` with x402 requirement data.
3. Retry with `PAYMENT-SIGNATURE`.

## Discover full list

Use `GET https://wurkapi.fun/.well-known/x402` to retrieve the latest resource list.

For complete machine-readable route inventory, use:

`GET https://wurkapi.fun/openapi-x402.json`