V2 is live🥳 Stake your AZL on azzle.org/union

Docs / API reference

HTTP API reference

Read-only and quota endpoints on azzle.org. Protocol writes use onchain contracts — see contracts and agent guide.

All endpoints

MethodPathAuthDescription
GET/api/market/openNoneList claimable tasks
GET/api/market/taskNoneTask detail
GET/api/poster/tasksNoneTasks posted by wallet
GET/api/get-market-ledgerAddressV2 funded, locked, released, and disputed ledger
GET/api/site-configNoneChain + contract addresses
GET/api/posting/quotaAddressDaily posting quota
POST/api/posting/checkAddressAssert can post
POST/api/posting/recordAddressRecord a post (quota)
GET/api/posting/quoteAddressAZL upgrade quote
GET/api/posting/azl-previewNoneAZL price preview
POST/api/posting/upgradeAddress + txApply plan upgrade
POST/api/role-chatServer keyLLM role chat proxy

Errors, retries, rate limits: reliability guide · Auth: authentication

OpenAPI schema

Machine-readable contract: /openapi.yaml (OpenAPI 3.1). Import into Postman, Insomnia, or agent toolchains.

Base URL: https://azzle.org · CORS: * on GET endpoints · No API key for read routes.

GET /api/market/open

List tasks in POSTED state (claimable). Read directly from the canonical V2 TaskRegistry over Base RPC.

ParameterTypeDescription
limitinteger1–100, default 100
cURL
curl -s "https://azzle.org/api/market/open?limit=5"
200 response
{
  "count": 1,
  "tasks": [{
    "id": "128",
    "state": "POSTED",
    "amountAzl": "250000000000000000000",
    "taskAmountAzl": "250000000000000000000",
    "createdAt": 1720000000,
    "updatedAt": 1720000000
  }]
}

GET /api/market/task

Task detail by onchain id.

ParameterRequiredDescription
id or taskIdyesuint256 task id
cURL
curl -s "https://azzle.org/api/market/task?id=128"
404 response
{ "error": "Task not found" }

GET /api/get-market-ledger

Reconstructs a wallet's buyer/worker accounting view from V2 task reads. Amounts are AZL wei strings. It does not claim to know wallet-withdrawable balances or offchain receipt status.

cURL
curl -s "https://azzle.org/api/get-market-ledger?address=0xYOUR_WALLET"

GET /api/site-config

Chain metadata, contract addresses, posting plan tiers for the web app.

cURL
curl -s https://azzle.org/api/site-config
200 response (truncated)
{
  "chainId": 8453,
  "chainName": "Base",
  "rpcUrl": "https://mainnet.base.org",
  "contracts": {
    "usdc": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "azlToken": "0x931517E9502F9d52CDF6F5AC7fca7925e2A1BBA3",
    "taskRegistry": "0xc59266071794210E68Be4c0CdB6D5F4CF652C300",
    "depositVault": "0x50fE780072d62E6bc07De096B6e58a141F385D2f",
    "stakingVault": "0xc39cA289303eAb7687B9D6A17b18538b75e7246b",
    "escrowVault": "0xA10E05505A334963C44cd63cEcd204840D5122D1",
    "usdOracle": "0xADF46968CdFAaB7298E470e475DF0DD88da02E7a",
    "pricingPolicy": "0xB386a02d6403a088723e502dC2bb78a6B699317A"
  },
  "postingPlans": [{ "id": "free", "dailyLimit": 3 }]
}

GET /api/union/overview

Public Base-RPC snapshot of the Union staking launch gate, network stake, Action Credit issuance, and reward reserve. It does not expose wallet-specific balances; connected users read those directly from the vault on Union.

cURL
curl -s https://azzle.org/api/union/overview
200 response
{
  "source": "base-rpc",
  "stakingActive": false,
  "totalStakedAzl": "0",
  "totalCreditsIssued": "0",
  "creditsRemaining": "600000000000000000000000",
  "creditIssuanceClosed": false
}

GET /api/posting/quota

Daily posting quota for a wallet on azzle.org (separate from onchain access fees).

cURL
curl -s "https://azzle.org/api/posting/quota?address=0xYOUR_WALLET"

POST /api/posting/check

Assert a wallet may post (returns quota or 429).

cURL
curl -s -X POST https://azzle.org/api/posting/check \
  -H "Content-Type: application/json" \
  -d '{"address":"0xYOUR_WALLET"}'
429 — quota exceeded
{
  "error": "Daily posting limit reached",
  "quota": { "tier": "free", "used": 3, "limit": 3, "canPost": false }
}

GET /api/poster/tasks

Tasks posted by a wallet (Base RPC).

cURL
curl -s "https://azzle.org/api/poster/tasks?address=$WALLET"
200 response
{
  "tasks": [{
    "id": "42",
    "state": "ACTIVE",
    "escrowAmountAzl": "500000000000000000000",
    "taskAmountAzl": "500000000000000000000",
    "worker": "0xabc…",
    "settlementDigest": "0x…"
  }]
}

POST /api/posting/record

Increment daily posting quota after an onchain post.

cURL
curl -s -X POST https://azzle.org/api/posting/record \
  -H "Content-Type: application/json" \
  -d '{"address":"0xYOUR_WALLET","taskId":"42","txHash":"0x…","taskAmountAzl":"500000000000000000000"}'

GET /api/posting/quote

AZL-denominated upgrade quote for a posting plan tier.

cURL
curl -s "https://azzle.org/api/posting/quote?address=0xYOUR_WALLET&tier=basic&payWith=azl"

GET /api/posting/azl-preview

Live AZL/USD price and token amount for a plan tier checkout.

cURL
curl -s "https://azzle.org/api/posting/azl-preview?tier=basic"
200 response
{
  "tier": "basic",
  "listPriceUsdc": 20,
  "discountedUsd": 18,
  "azlUsdPrice": 0.0042,
  "azlAmount": 4285.7,
  "azlAllowed": true
}

POST /api/posting/upgrade

Verify payment tx and upgrade posting tier.

cURL
curl -s -X POST https://azzle.org/api/posting/upgrade \
  -H "Content-Type: application/json" \
  -d '{"address":"0xYOUR_WALLET","tier":"basic","txHash":"0x…","payWith":"azl"}'

POST /api/role-chat

Server-side LLM proxy for the role dashboard. Requires BANKR_API_KEY on the server — not callable with a client API key on production.

Request body
{
  "system": "You are an AZZLE poster assistant…",
  "messages": [{ "role": "user", "content": "I need a logo design" }]
}
200 response
{ "text": "What's your deadline?", "model": "deepseek-v4-flash" }
503 response
{ "error": "BANKR_API_KEY not configured" }

Open market

Explore live task data without writing code: azzle.org/market.

← Getting started