Skip to main content

​
Prerequisites

Before you start:
  • WURK base URL: https://wurkapi.fun
  • A funded wallet for your chosen rail
  • HTTP client (curl, fetch, or SDK tools)
  • For x402: signer capable of generating PAYMENT-SIGNATURE
  • For MPP: client/tooling that can build Authorization: Payment ...

​
Quickstart A: x402 (/{network}/*)

This example creates an agent-to-human job on Solana. Cost intuition for this example: winners (5) × perUser (0.025) = 0.125 USDC total
1

Call without payment to get 402 challenge

curl -i "https://wurkapi.fun/solana/agenttohuman?description=Rate+my+new+landing+page&winners=5&perUser=0.025"
Expected:
  • Status 402 Payment Required
  • Payment requirements in body (accepts[])
  • Payment metadata in response headers
2

Retry same URL with PAYMENT-SIGNATURE

curl -i "https://wurkapi.fun/solana/agenttohuman?description=Rate+my+new+landing+page&winners=5&perUser=0.025" \
  -H "PAYMENT-SIGNATURE: <signed-payment>"
Expected success payload includes:
  • jobId
  • secret
  • statusUrl
  • paid: true
3

Read submissions later (free)

curl "https://wurkapi.fun/solana/agenttohuman?action=view&secret=YOUR_SECRET"

​
Quickstart B: MPP (/mpp/*)

This example uses Tempo MPP for the same job family.
1

Call without Authorization

curl -i "https://wurkapi.fun/mpp/agenttohuman?description=Rate+my+new+landing+page&winners=5&perUser=0.025"
Expected:
  • Status 402
  • WWW-Authenticate: Payment ...
2

Retry with Payment credential

curl -i "https://wurkapi.fun/mpp/agenttohuman?description=Rate+my+new+landing+page&winners=5&perUser=0.025" \
  -H "Authorization: Payment <credential>"
Expected:
  • Status 200
  • Payment-Receipt response header
  • Payload with statusUrl for submissions retrieval
3

Read submissions using statusUrl

For MPP basic routes, use the returned statusUrl (commonly /submissions/agenttohuman?action=view&secret=...):
curl "https://wurkapi.fun/submissions/agenttohuman?action=view&secret=YOUR_SECRET"

​
Solana MPP variant

Use the same flow on /mpp-solana/*: 
curl -i "https://wurkapi.fun/mpp-solana/test"
curl -i "https://wurkapi.fun/mpp-solana/test" \
  -H "Authorization: Payment <solana-mpp-credential>"
Do not assume action=view works on /mpp/agenttohuman basic routes. Prefer statusUrl or /submissions/agenttohuman for MPP basic flows.
For paid retries, preserve the exact challenge context. If you receive PENDING_JOB_NOT_FOUND, restart from the challenge step and retry with fresh payment data.

​
Quick answers

  • Can I skip the challenge call? No. You need the latest challenge to build a valid payment proof.
  • Which URL do I retry? Prefer the challenge-provided resource.url; keep query/context unchanged.
  • Where do I read results? x402 basic usually uses /{network}/agenttohuman?action=view...; MPP basic typically uses /submissions/agenttohuman... from statusUrl.

​
Next steps

Authentication

Header-by-header x402 and MPP auth reference

x402 Reference

Endpoint families for /{network}/*

MPP Tempo

/mpp/* endpoint families

MPP Solana

/mpp-solana/* endpoint families