Subnet 33 Jobs API

What this is

Submit a job, pay per call in USDC, get the result back. You don't need an account or an API key. Jobs are processed by miners on Bittensor subnet 33, but you don't need TAO or any Bittensor tooling. All you need is a standard EVM wallet with USDC on Base.

Task types

Prices shown are for NORMAL priority. Your quote always gives the exact amount.

Skill generation

Send a description of up to 1,000 characters and set declaredSize to its length. The result is a bundle of up to 5 curated skills with assertions, so you can pick the one that fits best.

POST /jobs-api/v1/jobs
{
  "quoteId": "quote_...",
  "jobType": "skillGeneration",
  "category": "SKILL_GENERATION",
  "payload": {
    "description": "Summarize a GitHub pull request diff into release notes grouped by feature area"
  }
}

Tagging

Set jobType: "tagging", pick a category, and get back {"tags": [...]}. declaredSize is your content's character count, up to 1,000,000.

• WEBSITE, NAMED_ENTITY_RECOGNITION, CITY_COUNCIL_NOTES: send {"content": "..."}.
• CONVERSATION: send {"turns": [[speaker, line], ...]}, or a flat list of lines if you don't have speakers.

How a request flows

1. Quote. POST /jobs-api/v1/quote with jobType, category, and declaredSize. You get back a quoteId and the USDC price.
2. Pay & submit. POST /jobs-api/v1/jobs with the quoteId and payload. Your x402 client handles the 402 payment handshake automatically. You get back a jobId and a token.
3. Poll. GET /jobs-api/v1/jobs/{jobId} with Authorization: Bearer <token> until the status is complete or failed. Results are kept for 30 days.

Priority & extra tags

The optional priority field trades cost for turnaround: LOW 0.9×, NORMAL 1.0× (default), HIGH 1.2×, X_HIGH 2.0×.

For tagging jobs, the optional extraTags: true flag has more miners process the job for broader tag coverage, at 1.5× the price. It stacks with priority, so X_HIGH with extraTags costs 3.0×.

Both are locked in at quote time. Send the same values when you submit the job.

Getting started with x402

You need an EVM wallet, USDC on Base, and an x402 client. The reference SDKs (Python, TypeScript, Go) wrap your HTTP client and handle the 402 sign-and-retry automatically.

import httpx
from eth_account import Account
from x402 import x402Client
from x402.http.clients.httpx import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client

account = Account.from_key("0x...your private key...")
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account), networks=["base"])

API = "https://your-deployment.example"

async def submit():
    async with (
        httpx.AsyncClient(base_url=API) as plain,
        x402HttpxClient(x402_client=client, base_url=API) as paid,
    ):
        # 1. Get a quote (no payment required).
        quote = (await plain.post("/jobs-api/v1/quote", json={
            "jobType": "tagging",
            "declaredSize": 256,
            "category": "WEBSITE",
        })).json()

        # 2. Submit the paid job. x402HttpxClient handles the 402 handshake.
        job = (await paid.post("/jobs-api/v1/jobs", json={
            "quoteId": quote["quoteId"],
            "jobType": "tagging",
            "category": "WEBSITE",
            "payload": {"content": "<page text>"},
        })).json()

        # 3. Poll for the result.
        result = (await plain.get(
            f"/jobs-api/v1/jobs/{job['jobId']}",
            headers={"Authorization": f"Bearer {job['token']}"},
        )).json()
        print(result)

Full endpoint and schema reference: Swagger UI · openapi.json

Payment transparency

Every paid job is one USDC transfer on Base to a single ReadyAI wallet, which anyone can check on Basescan: 0x85B4…627C.

75% of enrichment revenue goes to alpha buybacks. Every API call, from enterprise customers or Jobs submissions, funds open-market buybacks of SN33 alpha, all verifiable on-chain.

Resources

Support