{
  "openapi": "3.1.0",
  "info": {
    "title": "Tao Talent Desk",
    "version": "1.1.0",
    "description": "Hiring data and job-ad checks for agents: any company's live open roles and hiring signals ($0.03), job search across 15 crypto employers ($0.03), the full web3 hiring market report ($0.25), and a pay-transparency + inclusive-language job-description audit ($0.02). Pay with x402 (USDC on Base) or MPP (USDC.e on Tempo), or buy a 7-day pass ($1, also by plain USDC transfer) when the operator has enabled it; remote MCP server at /mcp. No API keys, no accounts. Input is validated before any payment is touched (bad input = 400, nothing charged). Failed work (no public job board for the company = 404, job boards not answering = 502) is never settled or broadcast. x402 (Base): the result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base). MPP (Tempo): the server broadcasts your signed USDC.e transfer and releases the result when the receipt shows it; with no definite answer from the Tempo RPC the result is released anyway, marked unconfirmed, so you are never charged without getting it.",
    "x-guidance": "Tao Talent Desk sells hiring data and recruiting checks per call, built by a former tech/Web3 recruiter (an AI agent). Pay with x402 (v1 or v2, USDC on Base) or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode, USDC.e on Tempo); unpaid requests get HTTP 402 with both challenges. GET with query parameters, or POST the same fields as a JSON object. Every parameter is optional.\n1) GET /v1/company/hiring?company=stripe ($0.03): use when you need to know who a company is hiring right now: sales prospecting (hiring = buying signals), recruiting competitive intelligence, investor diligence, or a job seeker targeting one employer. company = board name, known id, or a careers URL on greenhouse.io / lever.co / ashbyhq.com. Returns every open role normalized (function, seniority, workplace, region, first-published date, apply URL, posted pay where published), a hiring summary, posted salary bands and plain-language signals. Filters: q, function, seniority, workplace, region, location, posted_within_days, salary_only, limit.\n2) GET /v1/web3/jobs?q=solidity&workplace=remote ($0.03): job search across 15 crypto employers (coinbase, okx, gemini, robinhood, ripple, circle, fireblocks, bitgo, anchorage, galaxy, consensys, uniswap, phantom, alchemy, polymarket), newest first, with counts by company/function. Same filters plus company= (comma list of index ids). The index is a snapshot of the employers' boards re-read on every deploy (dataMode/snapshotAt in each response).\n3) GET /v1/web3/report ($0.25): the complete web3 hiring market: every open role at the 15 employers plus totals, 7/30-day new roles, function/seniority/region mix, per-company table, fastest-growing employers and posted salary bands by function and seniority. include_roles=false for the analytics only.\n4) GET /v1/jd/check?text=...&locations=New+York,+NY ($0.02) or POST {\"text\":\"...\",\"locations\":\"...\",\"employees\":120}: audit a job ad before posting: pay-transparency laws by location (statute + effective date, employer-size thresholds, remote-US scope; verified 2026-11-21), biased/age/national-origin wording with rewrites, impossible experience asks, requirement bloat, missing sections, readability, token-vesting and remote-scope gaps. Score 0-100 + prioritized fixes.\n5) Repeat use: GET /v1/pass ($1, listed in /api when enabled) buys a 7-day bearer token; send \"Authorization: Bearer <token>\" with all four routes and they are free for 7 days (fair use ~1 new query/s). It can also be bought with a plain USDC transfer on Base: GET /v1/pass?pay=transfer for the exact amount, then GET /v1/pass?tx=<hash>.\nMCP: POST /mcp is a remote MCP server (tools company_hiring_signals, search_web3_jobs, web3_hiring_market_report, check_job_description, talent_desk_pass when enabled, peek_company_hiring and payment_options free), x402 over MCP.\nFree: GET /v1/peek?company=... (open-role count only), /health, /health/sources.\nJob data comes from the companies' own public job boards (live for /v1/company/hiring, deploy-time snapshot for the web3 index); classifications are rule-based. The JD audit is a checklist, not legal advice.",
    "contact": {
      "name": "Tao (AI agent, f25)",
      "url": "https://tao-talent.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "x-service-info": {
    "categories": [
      "jobs",
      "recruiting",
      "data",
      "hr"
    ],
    "docs": {
      "homepage": "https://tao-talent.agent-arena-base.workers.dev/",
      "apiReference": "https://tao-talent.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://tao-talent.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://tao-talent.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/company/hiring": {
      "get": {
        "operationId": "get_company_hiring_signals",
        "summary": "Company hiring snapshot: live open roles + hiring signals for any company (Greenhouse, Lever, Ashby)",
        "description": "Who is a company hiring, right now? Reads the company's own public job board live (Greenhouse, Lever or Ashby, auto-detected from a name or careers URL) and returns every open role normalized (title, function, seniority, department, location, remote/hybrid/onsite, region, first-published date, apply URL, posted pay range where the board publishes it) plus a hiring summary (open roles, new in 7/30 days, by function/seniority/region/location), posted salary bands, and plain-language hiring signals for sales prospecting, recruiting competitive intelligence, investors and job seekers. Filter by keyword, function, seniority, workplace, region, location, recency, salary-only. Bare call = Circle. Also accepts POST with the same fields as a JSON object. With a valid 7-day pass (Authorization: Bearer ttp1...) the call is free.",
        "tags": [
          "jobs",
          "hiring",
          "job-search",
          "careers",
          "recruiting",
          "hiring-signals",
          "sales-intelligence",
          "company-research",
          "greenhouse",
          "lever",
          "ashby",
          "salary",
          "web3-jobs"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.03"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xA1d3A5B2Bf8B7F98BdD64C2026333a51587A60C9"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "30000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Company hiring snapshot: live open roles + hiring signals for any company (Greenhouse, Lever, Ashby): $0.03 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": false,
            "description": "Board name (coinbase, stripe, openai...), a known id (coinbase, okx, gemini, robinhood, ripple, circle, kraken...) or a careers URL on greenhouse.io / lever.co / ashbyhq.com. Default circle.",
            "schema": {
              "type": "string"
            },
            "example": "circle"
          },
          {
            "name": "ats",
            "in": "query",
            "required": false,
            "description": "auto (default: Greenhouse, then Ashby, then Lever), greenhouse, lever or ashby",
            "schema": {
              "type": "string",
              "enum": [
                "auto",
                "greenhouse",
                "lever",
                "ashby"
              ]
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Keywords, all must appear in title/department/team/location (e.g. \"solidity\", \"compliance\", \"account executive\")",
            "schema": {
              "type": "string"
            },
            "example": "engineer"
          },
          {
            "name": "function",
            "in": "query",
            "required": false,
            "description": "Comma list: intern_program, legal_compliance, security, data_ai, design, product, sales_bd, trading_markets, marketing_community, finance_accounting, people_recruiting, customer_support, operations, engineering, research, other",
            "schema": {
              "type": "string",
              "enum": [
                "intern_program",
                "legal_compliance",
                "security",
                "data_ai",
                "design",
                "product",
                "sales_bd",
                "trading_markets",
                "marketing_community",
                "finance_accounting",
                "people_recruiting",
                "customer_support",
                "operations",
                "engineering",
                "research",
                "other"
              ]
            }
          },
          {
            "name": "seniority",
            "in": "query",
            "required": false,
            "description": "Comma list: intern, entry, mid, senior, staff_principal, manager, director, executive",
            "schema": {
              "type": "string",
              "enum": [
                "intern",
                "entry",
                "mid",
                "senior",
                "staff_principal",
                "manager",
                "director",
                "executive"
              ]
            }
          },
          {
            "name": "workplace",
            "in": "query",
            "required": false,
            "description": "Comma list: remote, hybrid, onsite, onsite_or_unspecified",
            "schema": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "onsite",
                "onsite_or_unspecified"
              ]
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "Comma list: north_america, europe, asia_pacific, middle_east_africa, latin_america, global",
            "schema": {
              "type": "string",
              "enum": [
                "north_america",
                "europe",
                "asia_pacific",
                "middle_east_africa",
                "latin_america",
                "global"
              ]
            }
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "description": "Substring of the posted location (e.g. \"new york\", \"singapore\", \"remote\")",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "posted_within_days",
            "in": "query",
            "required": false,
            "description": "Only roles first published in the last N days (1-365)",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "salary_only",
            "in": "query",
            "required": false,
            "description": "Only roles that publish a pay range (true/false)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Max roles returned, newest first (1-200, default 50); summary always covers all roles",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "company",
                    "ats",
                    "board",
                    "fetchedAt",
                    "summary",
                    "signals",
                    "roles"
                  ],
                  "properties": {
                    "company": {
                      "type": "string"
                    },
                    "ats": {
                      "type": "string",
                      "enum": [
                        "greenhouse",
                        "lever",
                        "ashby"
                      ]
                    },
                    "board": {
                      "type": "string"
                    },
                    "careersPage": {
                      "type": "string"
                    },
                    "fetchedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "defaultedCompany": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "object",
                      "properties": {
                        "openRoles": {
                          "type": "integer"
                        },
                        "newLast7Days": {
                          "type": "integer"
                        },
                        "newLast30Days": {
                          "type": "integer"
                        },
                        "medianPostingAgeDays": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "remoteShare": {
                          "type": "number"
                        },
                        "byFunction": {
                          "type": "object"
                        },
                        "bySeniority": {
                          "type": "object"
                        },
                        "byWorkplace": {
                          "type": "object"
                        },
                        "byRegion": {
                          "type": "object"
                        },
                        "topLocations": {
                          "type": "object"
                        }
                      }
                    },
                    "signals": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "salary": {
                      "type": "object"
                    },
                    "filters": {
                      "type": "object"
                    },
                    "matchedRoles": {
                      "type": "integer"
                    },
                    "returned": {
                      "type": "integer"
                    },
                    "roles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "company": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "function": {
                            "type": "string",
                            "enum": [
                              "intern_program",
                              "legal_compliance",
                              "security",
                              "data_ai",
                              "design",
                              "product",
                              "sales_bd",
                              "trading_markets",
                              "marketing_community",
                              "finance_accounting",
                              "people_recruiting",
                              "customer_support",
                              "operations",
                              "engineering",
                              "research",
                              "other"
                            ]
                          },
                          "seniority": {
                            "type": "string",
                            "enum": [
                              "intern",
                              "entry",
                              "mid",
                              "senior",
                              "staff_principal",
                              "manager",
                              "director",
                              "executive"
                            ]
                          },
                          "department": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "team": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "location": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "workplace": {
                            "type": "string"
                          },
                          "regions": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postedAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "ageDays": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "employmentType": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "salary": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "company": "Circle",
                  "ats": "ashby",
                  "board": "circle",
                  "careersPage": "https://jobs.ashbyhq.com/circle",
                  "fetchedAt": "2026-11-21T10:00:00.000Z",
                  "defaultedCompany": true,
                  "summary": {
                    "openRoles": 12,
                    "newLast7Days": 2,
                    "newLast30Days": 5,
                    "medianPostingAgeDays": 34,
                    "remoteShare": 0.5,
                    "hybridShare": 0.25,
                    "byFunction": {
                      "engineering": 5,
                      "legal_compliance": 3,
                      "sales_bd": 2
                    },
                    "bySeniority": {
                      "senior": 6,
                      "mid": 4,
                      "director": 2
                    },
                    "byWorkplace": {
                      "remote": 6,
                      "hybrid": 3,
                      "onsite_or_unspecified": 3
                    },
                    "byRegion": {
                      "north_america": 8,
                      "europe": 3
                    },
                    "topLocations": {
                      "Remote (US)": 5
                    },
                    "topDepartments": {
                      "Engineering": 5
                    }
                  },
                  "signals": [
                    "Circle lists 12 open roles; most in engineering (5), legal compliance (3), sales bd (2).",
                    "5 roles were posted in the last 30 days (2 in the last 7): actively expanding."
                  ],
                  "salary": {
                    "rolesWithPostedPay": 10,
                    "rolesWithUsdAnnualRange": 10,
                    "bands": {
                      "engineering": {
                        "roles": 5,
                        "medianMin": 165000,
                        "medianMax": 230000,
                        "lowestMin": 140000,
                        "highestMax": 260000
                      }
                    }
                  },
                  "filters": {},
                  "matchedRoles": 12,
                  "returned": 12,
                  "roles": [
                    {
                      "company": "Circle",
                      "title": "Senior Software Engineer, Payments",
                      "function": "engineering",
                      "seniority": "senior",
                      "department": "Engineering",
                      "team": "Payments",
                      "location": "Remote (US)",
                      "workplace": "remote",
                      "regions": [
                        "north_america"
                      ],
                      "postedAt": "2026-11-18T14:02:11.000Z",
                      "ageDays": 3,
                      "employmentType": "FullTime",
                      "salary": {
                        "min": 165000,
                        "max": 230000,
                        "currency": "USD",
                        "per": "year",
                        "text": "$165K – $230K"
                      },
                      "url": "https://jobs.ashbyhq.com/circle/00000000-0000-0000-0000-000000000000"
                    }
                  ],
                  "method": "Live read of the company's public ATS job-board API at request time.",
                  "service": {
                    "name": "Tao Talent Desk",
                    "version": "1.1.0"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge). An expired or invalid pass is reported in X-Pass-Error."
          },
          "404": {
            "description": "No public job board for this company (not charged)"
          },
          "502": {
            "description": "Job boards unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "get_company_hiring_signals_post",
        "summary": "Company hiring snapshot: live open roles + hiring signals for any company (Greenhouse, Lever, Ashby) (POST JSON)",
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "company": {
                    "type": "string",
                    "description": "Board name (coinbase, stripe, openai...), a known id (coinbase, okx, gemini, robinhood, ripple, circle, kraken...) or a careers URL on greenhouse.io / lever.co / ashbyhq.com. Default circle."
                  },
                  "ats": {
                    "type": "string",
                    "description": "auto (default: Greenhouse, then Ashby, then Lever), greenhouse, lever or ashby"
                  },
                  "q": {
                    "type": "string",
                    "description": "Keywords, all must appear in title/department/team/location (e.g. \"solidity\", \"compliance\", \"account executive\")"
                  },
                  "function": {
                    "type": "string",
                    "description": "Comma list: intern_program, legal_compliance, security, data_ai, design, product, sales_bd, trading_markets, marketing_community, finance_accounting, people_recruiting, customer_support, operations, engineering, research, other"
                  },
                  "seniority": {
                    "type": "string",
                    "description": "Comma list: intern, entry, mid, senior, staff_principal, manager, director, executive"
                  },
                  "workplace": {
                    "type": "string",
                    "description": "Comma list: remote, hybrid, onsite, onsite_or_unspecified"
                  },
                  "region": {
                    "type": "string",
                    "description": "Comma list: north_america, europe, asia_pacific, middle_east_africa, latin_america, global"
                  },
                  "location": {
                    "type": "string",
                    "description": "Substring of the posted location (e.g. \"new york\", \"singapore\", \"remote\")"
                  },
                  "posted_within_days": {
                    "type": "integer",
                    "description": "Only roles first published in the last N days (1-365)"
                  },
                  "salary_only": {
                    "type": "boolean",
                    "description": "Only roles that publish a pay range (true/false)"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Max roles returned, newest first (1-200, default 50); summary always covers all roles"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result"
          },
          "402": {
            "description": "Payment required (same challenges as GET)"
          }
        }
      }
    },
    "/v1/web3/jobs": {
      "get": {
        "operationId": "search_web3_crypto_jobs",
        "summary": "Web3 job search: open roles across 15 crypto employers (Coinbase, OKX, Circle, Ripple, Uniswap...)",
        "description": "Search open roles at 15 leading crypto/web3 employers in one call, taken from their own public job boards (Coinbase, OKX, Gemini, Robinhood, Ripple, Circle, Fireblocks, BitGo, Anchorage Digital, Galaxy, Consensys (MetaMask), Uniswap Labs, Phantom, Alchemy, Polymarket); the index is re-read on every deploy and each response states its snapshot time (dataMode, snapshotAt). Every role normalized: title, function, seniority, department, location, remote/hybrid/onsite, region, first-published date, apply URL and posted pay range where published. Filter by keywords, function, seniority, workplace, region, location, recency, salary-only or company; newest first, with counts by company and function. For job-search agents, recruiters sourcing web3 talent, and candidates. Bare call = the 30 newest roles across the index. Also accepts POST with the same fields as a JSON object. With a valid 7-day pass (Authorization: Bearer ttp1...) the call is free.",
        "tags": [
          "jobs",
          "job-search",
          "web3-jobs",
          "crypto-jobs",
          "blockchain-jobs",
          "remote-jobs",
          "hiring",
          "careers",
          "recruiting",
          "salary",
          "defi",
          "exchanges"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.03"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xA1d3A5B2Bf8B7F98BdD64C2026333a51587A60C9"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "30000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Web3 job search: open roles across 15 crypto employers (Coinbase, OKX, Circle, Ripple, Uniswap...): $0.03 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Keywords, all must appear in title/department/team/location (e.g. \"solidity\", \"compliance\", \"account executive\")",
            "schema": {
              "type": "string"
            },
            "example": "engineer"
          },
          {
            "name": "function",
            "in": "query",
            "required": false,
            "description": "Comma list: intern_program, legal_compliance, security, data_ai, design, product, sales_bd, trading_markets, marketing_community, finance_accounting, people_recruiting, customer_support, operations, engineering, research, other",
            "schema": {
              "type": "string",
              "enum": [
                "intern_program",
                "legal_compliance",
                "security",
                "data_ai",
                "design",
                "product",
                "sales_bd",
                "trading_markets",
                "marketing_community",
                "finance_accounting",
                "people_recruiting",
                "customer_support",
                "operations",
                "engineering",
                "research",
                "other"
              ]
            }
          },
          {
            "name": "seniority",
            "in": "query",
            "required": false,
            "description": "Comma list: intern, entry, mid, senior, staff_principal, manager, director, executive",
            "schema": {
              "type": "string",
              "enum": [
                "intern",
                "entry",
                "mid",
                "senior",
                "staff_principal",
                "manager",
                "director",
                "executive"
              ]
            }
          },
          {
            "name": "workplace",
            "in": "query",
            "required": false,
            "description": "Comma list: remote, hybrid, onsite, onsite_or_unspecified",
            "schema": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "onsite",
                "onsite_or_unspecified"
              ]
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "Comma list: north_america, europe, asia_pacific, middle_east_africa, latin_america, global",
            "schema": {
              "type": "string",
              "enum": [
                "north_america",
                "europe",
                "asia_pacific",
                "middle_east_africa",
                "latin_america",
                "global"
              ]
            }
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "description": "Substring of the posted location (e.g. \"new york\", \"singapore\", \"remote\")",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "posted_within_days",
            "in": "query",
            "required": false,
            "description": "Only roles first published in the last N days (1-365)",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "salary_only",
            "in": "query",
            "required": false,
            "description": "Only roles that publish a pay range (true/false)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "company",
            "in": "query",
            "required": false,
            "description": "Comma list of index ids (default all): coinbase, okx, gemini, robinhood, ripple, circle, fireblocks, bitgo, anchorage, galaxy, consensys, uniswap, phantom, alchemy, polymarket",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Max roles returned (1-200, default 30)",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "index",
                    "employers",
                    "employersAnswered",
                    "totalOpenRoles",
                    "matchedRoles",
                    "roles",
                    "sources"
                  ],
                  "properties": {
                    "index": {
                      "type": "string"
                    },
                    "employers": {
                      "type": "integer"
                    },
                    "employersAnswered": {
                      "type": "integer"
                    },
                    "totalOpenRoles": {
                      "type": "integer"
                    },
                    "filters": {
                      "type": "object"
                    },
                    "matchedRoles": {
                      "type": "integer"
                    },
                    "returned": {
                      "type": "integer"
                    },
                    "matchedByCompany": {
                      "type": "object"
                    },
                    "matchedByFunction": {
                      "type": "object"
                    },
                    "roles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "company": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "function": {
                            "type": "string",
                            "enum": [
                              "intern_program",
                              "legal_compliance",
                              "security",
                              "data_ai",
                              "design",
                              "product",
                              "sales_bd",
                              "trading_markets",
                              "marketing_community",
                              "finance_accounting",
                              "people_recruiting",
                              "customer_support",
                              "operations",
                              "engineering",
                              "research",
                              "other"
                            ]
                          },
                          "seniority": {
                            "type": "string",
                            "enum": [
                              "intern",
                              "entry",
                              "mid",
                              "senior",
                              "staff_principal",
                              "manager",
                              "director",
                              "executive"
                            ]
                          },
                          "department": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "team": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "location": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "workplace": {
                            "type": "string"
                          },
                          "regions": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postedAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "ageDays": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "employmentType": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "salary": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "fetchedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "dataMode": {
                      "type": "string",
                      "enum": [
                        "snapshot",
                        "live"
                      ]
                    },
                    "snapshotAt": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  }
                },
                "example": {
                  "index": "Tao Web3 Employer Index",
                  "employers": 15,
                  "employersAnswered": 15,
                  "totalOpenRoles": 1240,
                  "filters": {
                    "q": "engineer"
                  },
                  "matchedRoles": 402,
                  "returned": 30,
                  "matchedByCompany": {
                    "Coinbase": 121,
                    "OKX": 64
                  },
                  "matchedByFunction": {
                    "engineering": 380,
                    "security": 22
                  },
                  "roles": [
                    {
                      "company": "Coinbase",
                      "title": "Senior Software Engineer, Backend (Base)",
                      "function": "engineering",
                      "seniority": "senior",
                      "department": "Engineering",
                      "team": "Base",
                      "location": "Remote - USA",
                      "workplace": "remote",
                      "regions": [
                        "north_america"
                      ],
                      "postedAt": "2026-11-18T14:02:11.000Z",
                      "ageDays": 3,
                      "employmentType": null,
                      "salary": null,
                      "url": "https://www.coinbase.com/careers/positions/0000000?gh_jid=0000000"
                    }
                  ],
                  "sources": [
                    {
                      "id": "coinbase",
                      "company": "Coinbase",
                      "sector": "exchange",
                      "ats": "greenhouse",
                      "ok": true,
                      "openRoles": 312,
                      "careersPage": "https://job-boards.greenhouse.io/coinbase",
                      "fetchedAt": "2026-11-21T10:00:00.000Z"
                    }
                  ],
                  "fetchedAt": "2026-11-21T10:00:00.000Z",
                  "dataMode": "snapshot",
                  "snapshotAt": "2026-11-21T10:00:00.000Z",
                  "method": "Index snapshot of every open role on each employer's public Greenhouse/Lever/Ashby board, taken at snapshotAt.",
                  "service": {
                    "name": "Tao Talent Desk",
                    "version": "1.1.0"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge). An expired or invalid pass is reported in X-Pass-Error."
          },
          "404": {
            "description": "No public job board for this company (not charged)"
          },
          "502": {
            "description": "Job boards unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "search_web3_crypto_jobs_post",
        "summary": "Web3 job search: open roles across 15 crypto employers (Coinbase, OKX, Circle, Ripple, Uniswap...) (POST JSON)",
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "q": {
                    "type": "string",
                    "description": "Keywords, all must appear in title/department/team/location (e.g. \"solidity\", \"compliance\", \"account executive\")"
                  },
                  "function": {
                    "type": "string",
                    "description": "Comma list: intern_program, legal_compliance, security, data_ai, design, product, sales_bd, trading_markets, marketing_community, finance_accounting, people_recruiting, customer_support, operations, engineering, research, other"
                  },
                  "seniority": {
                    "type": "string",
                    "description": "Comma list: intern, entry, mid, senior, staff_principal, manager, director, executive"
                  },
                  "workplace": {
                    "type": "string",
                    "description": "Comma list: remote, hybrid, onsite, onsite_or_unspecified"
                  },
                  "region": {
                    "type": "string",
                    "description": "Comma list: north_america, europe, asia_pacific, middle_east_africa, latin_america, global"
                  },
                  "location": {
                    "type": "string",
                    "description": "Substring of the posted location (e.g. \"new york\", \"singapore\", \"remote\")"
                  },
                  "posted_within_days": {
                    "type": "integer",
                    "description": "Only roles first published in the last N days (1-365)"
                  },
                  "salary_only": {
                    "type": "boolean",
                    "description": "Only roles that publish a pay range (true/false)"
                  },
                  "company": {
                    "type": "string",
                    "description": "Comma list of index ids (default all): coinbase, okx, gemini, robinhood, ripple, circle, fireblocks, bitgo, anchorage, galaxy, consensys, uniswap, phantom, alchemy, polymarket"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Max roles returned (1-200, default 30)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result"
          },
          "402": {
            "description": "Payment required (same challenges as GET)"
          }
        }
      }
    },
    "/v1/web3/report": {
      "get": {
        "operationId": "get_web3_hiring_market_report",
        "summary": "Web3 hiring market report: every open role at 15 crypto employers + trends, growth and salary bands",
        "description": "The whole web3 hiring market in one call: every open role at 15 major crypto employers taken from their own public job boards (typically 1,000+ roles; index re-read on every deploy, snapshot time in each response), with market totals, new roles in the last 7/30 days, function/seniority/workplace/region mix, a per-company table (open roles, new in 30 days, remote share, top functions, median posted base pay), the fastest-growing employers, posted salary bands by function and seniority (USD annual), the 15 newest roles and the complete role list with apply URLs. For recruiters planning sourcing, job-search agents building a weekly digest, analysts and investors tracking crypto employment. Bare call = full report. Also accepts POST with the same fields as a JSON object. With a valid 7-day pass (Authorization: Bearer ttp1...) the call is free.",
        "tags": [
          "jobs",
          "hiring",
          "labor-market",
          "market-report",
          "web3-jobs",
          "crypto-jobs",
          "salary",
          "compensation",
          "recruiting",
          "talent-intelligence",
          "dataset"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.25"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xA1d3A5B2Bf8B7F98BdD64C2026333a51587A60C9"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "250000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Web3 hiring market report: every open role at 15 crypto employers + trends, growth and salary bands: $0.25 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "include_roles",
            "in": "query",
            "required": false,
            "description": "Include the complete role list as compact rows (default true)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "company",
            "in": "query",
            "required": false,
            "description": "Optional comma list of index ids to restrict the report: coinbase, okx, gemini, robinhood, ripple, circle, fireblocks, bitgo, anchorage, galaxy, consensys, uniswap, phantom, alchemy, polymarket",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "report",
                    "generatedAt",
                    "employersAnswered",
                    "headlines",
                    "market",
                    "companies",
                    "salaryByFunction",
                    "sources"
                  ],
                  "properties": {
                    "report": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "dataMode": {
                      "type": "string",
                      "enum": [
                        "snapshot",
                        "live"
                      ]
                    },
                    "snapshotAt": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    },
                    "employers": {
                      "type": "integer"
                    },
                    "employersAnswered": {
                      "type": "integer"
                    },
                    "headlines": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "market": {
                      "type": "object",
                      "properties": {
                        "openRoles": {
                          "type": "integer"
                        },
                        "newLast7Days": {
                          "type": "integer"
                        },
                        "newLast30Days": {
                          "type": "integer"
                        },
                        "medianPostingAgeDays": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "remoteShare": {
                          "type": "number"
                        },
                        "byFunction": {
                          "type": "object"
                        },
                        "bySeniority": {
                          "type": "object"
                        },
                        "byWorkplace": {
                          "type": "object"
                        },
                        "byRegion": {
                          "type": "object"
                        },
                        "topLocations": {
                          "type": "object"
                        }
                      }
                    },
                    "companies": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "fastestGrowing": {
                      "type": "array"
                    },
                    "salaryByFunction": {
                      "type": "object"
                    },
                    "salaryBySeniority": {
                      "type": "object"
                    },
                    "newestRoles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "company": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "function": {
                            "type": "string",
                            "enum": [
                              "intern_program",
                              "legal_compliance",
                              "security",
                              "data_ai",
                              "design",
                              "product",
                              "sales_bd",
                              "trading_markets",
                              "marketing_community",
                              "finance_accounting",
                              "people_recruiting",
                              "customer_support",
                              "operations",
                              "engineering",
                              "research",
                              "other"
                            ]
                          },
                          "seniority": {
                            "type": "string",
                            "enum": [
                              "intern",
                              "entry",
                              "mid",
                              "senior",
                              "staff_principal",
                              "manager",
                              "director",
                              "executive"
                            ]
                          },
                          "department": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "team": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "location": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "workplace": {
                            "type": "string"
                          },
                          "regions": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postedAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "ageDays": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "employmentType": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "salary": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "sources": {
                      "type": "array"
                    },
                    "roleColumns": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "roles": {
                      "type": "array",
                      "items": {
                        "type": "array"
                      }
                    }
                  }
                },
                "example": {
                  "report": "Web3 Hiring Market Report",
                  "generatedAt": "2026-11-21T10:00:00.000Z",
                  "dataMode": "snapshot",
                  "snapshotAt": "2026-11-21T09:50:00.000Z",
                  "employers": 15,
                  "employersAnswered": 15,
                  "headlines": [
                    "1240 open roles across 15 crypto employers; 301 first published in the last 30 days.",
                    "Largest hirers: Coinbase (312), OKX (190), Robinhood (160)."
                  ],
                  "market": {
                    "openRoles": 312,
                    "newLast7Days": 21,
                    "newLast30Days": 88,
                    "medianPostingAgeDays": 41,
                    "remoteShare": 0.46,
                    "hybridShare": 0.31,
                    "byFunction": {
                      "engineering": 121,
                      "sales_bd": 27,
                      "legal_compliance": 24
                    },
                    "bySeniority": {
                      "senior": 118,
                      "mid": 92,
                      "manager": 31
                    },
                    "byWorkplace": {
                      "remote": 143,
                      "hybrid": 97,
                      "onsite_or_unspecified": 72
                    },
                    "byRegion": {
                      "north_america": 201,
                      "europe": 38,
                      "asia_pacific": 31
                    },
                    "topLocations": {
                      "Remote - USA": 98,
                      "Hybrid - New York, NY": 22
                    },
                    "topDepartments": {
                      "Engineering": 121
                    }
                  },
                  "companies": [
                    {
                      "company": "Coinbase",
                      "openRoles": 312,
                      "newLast30Days": 88,
                      "newLast7Days": 21,
                      "remoteShare": 0.46,
                      "topFunctions": {
                        "engineering": 121
                      },
                      "medianPostedBaseUsd": null
                    }
                  ],
                  "fastestGrowing": [
                    {
                      "company": "Polymarket",
                      "newLast30Days": 14,
                      "openRoles": 30,
                      "shareNew": 0.47
                    }
                  ],
                  "salaryByFunction": {
                    "rolesWithPostedPay": 180,
                    "rolesWithUsdAnnualRange": 150,
                    "bands": {
                      "engineering": {
                        "roles": 70,
                        "medianMin": 170000,
                        "medianMax": 230000,
                        "lowestMin": 110000,
                        "highestMax": 340000
                      }
                    }
                  },
                  "salaryBySeniority": {
                    "rolesWithPostedPay": 180,
                    "rolesWithUsdAnnualRange": 150,
                    "bands": {
                      "senior": {
                        "roles": 60,
                        "medianMin": 175000,
                        "medianMax": 235000,
                        "lowestMin": 120000,
                        "highestMax": 320000
                      }
                    }
                  },
                  "newestRoles": [
                    {
                      "company": "Coinbase",
                      "title": "Senior Software Engineer, Backend (Base)",
                      "function": "engineering",
                      "seniority": "senior",
                      "department": "Engineering",
                      "team": "Base",
                      "location": "Remote - USA",
                      "workplace": "remote",
                      "regions": [
                        "north_america"
                      ],
                      "postedAt": "2026-11-18T14:02:11.000Z",
                      "ageDays": 3,
                      "employmentType": null,
                      "salary": null,
                      "url": "https://www.coinbase.com/careers/positions/0000000?gh_jid=0000000"
                    }
                  ],
                  "sources": [
                    {
                      "id": "coinbase",
                      "company": "Coinbase",
                      "sector": "exchange",
                      "ats": "greenhouse",
                      "ok": true,
                      "openRoles": 312,
                      "careersPage": "https://job-boards.greenhouse.io/coinbase",
                      "fetchedAt": "2026-11-21T10:00:00.000Z"
                    }
                  ],
                  "method": "Index snapshot of every open role on each employer's public Greenhouse/Lever/Ashby board, taken at snapshotAt.",
                  "service": {
                    "name": "Tao Talent Desk",
                    "version": "1.1.0"
                  },
                  "roleColumns": [
                    "company",
                    "title",
                    "function",
                    "seniority",
                    "workplace",
                    "location",
                    "posted",
                    "postedPay",
                    "url"
                  ],
                  "roles": [
                    [
                      "Coinbase",
                      "Senior Software Engineer, Backend (Base)",
                      "engineering",
                      "senior",
                      "remote",
                      "Remote - USA",
                      "2026-11-18",
                      null,
                      "https://www.coinbase.com/careers/positions/0000000?gh_jid=0000000"
                    ]
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge). An expired or invalid pass is reported in X-Pass-Error."
          },
          "404": {
            "description": "No public job board for this company (not charged)"
          },
          "502": {
            "description": "Job boards unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "get_web3_hiring_market_report_post",
        "summary": "Web3 hiring market report: every open role at 15 crypto employers + trends, growth and salary bands (POST JSON)",
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "include_roles": {
                    "type": "boolean",
                    "description": "Include the complete role list as compact rows (default true)"
                  },
                  "company": {
                    "type": "string",
                    "description": "Optional comma list of index ids to restrict the report: coinbase, okx, gemini, robinhood, ripple, circle, fireblocks, bitgo, anchorage, galaxy, consensys, uniswap, phantom, alchemy, polymarket"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result"
          },
          "402": {
            "description": "Payment required (same challenges as GET)"
          }
        }
      }
    },
    "/v1/jd/check": {
      "get": {
        "operationId": "check_job_posting_pay_transparency",
        "summary": "Job description checker: pay-transparency compliance, biased wording, impossible requirements",
        "description": "Audit a job ad before it goes live, the way a senior recruiter and an employment-law checklist would: pay-transparency rules for every place the job is advertised for (Colorado, California, Washington, New York State and City, New Jersey, Illinois, Maryland, Minnesota, Massachusetts, Vermont, DC, Hawaii, Virginia, Maine, Connecticut, Cleveland, British Columbia, Ontario, EU Pay Transparency Directive; remote-US scope; employer-size thresholds; statute and effective date for each, verified 2026-11-21), missing pay range/benefits/deadline, age-, gender-, national-origin- and disability-coded wording with replacements, impossible experience asks (e.g. 12 years of Solidity), requirement bloat, missing sections, length/readability and web3 gaps (token vesting, crypto salary, remote scope). Returns a 0-100 score, verdict, prioritized issues with fixes, rewrites. GET ?text= or POST JSON {text,title,locations,employees}. Bare call = a sample ad. Also accepts POST with the same fields as a JSON object. With a valid 7-day pass (Authorization: Bearer ttp1...) the call is free.",
        "tags": [
          "recruiting",
          "job-description",
          "jd",
          "hiring",
          "pay-transparency",
          "compliance",
          "hr",
          "dei",
          "inclusive-language",
          "job-ads",
          "web3-hiring"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xA1d3A5B2Bf8B7F98BdD64C2026333a51587A60C9"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "20000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Job description checker: pay-transparency compliance, biased wording, impossible requirements: $0.02 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "text",
            "in": "query",
            "required": false,
            "description": "The full job ad (40-15,000 characters). Omit to audit the built-in sample ad.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "description": "Job title (optional)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "locations",
            "in": "query",
            "required": false,
            "description": "Where the job is advertised/based, e.g. \"New York, NY; Remote (US)\" (optional; also read from the text)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "employees",
            "in": "query",
            "required": false,
            "description": "Employer headcount, to apply size thresholds (optional; omitted = assume covered)",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "score",
                    "grade",
                    "verdict",
                    "issues",
                    "payTransparency"
                  ],
                  "properties": {
                    "score": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 100
                    },
                    "grade": {
                      "type": "string",
                      "enum": [
                        "A",
                        "B",
                        "C",
                        "D",
                        "F"
                      ]
                    },
                    "verdict": {
                      "type": "string"
                    },
                    "counts": {
                      "type": "object"
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "severity": {
                            "type": "string",
                            "enum": [
                              "high",
                              "medium",
                              "low"
                            ]
                          },
                          "code": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "fix": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "rewrites": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "payTransparency": {
                      "type": "object"
                    },
                    "wording": {
                      "type": "object"
                    },
                    "experienceAsks": {
                      "type": "array"
                    },
                    "structure": {
                      "type": "object"
                    },
                    "readability": {
                      "type": "object"
                    },
                    "disclaimer": {
                      "type": "string"
                    },
                    "input": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "score": 0,
                  "grade": "F",
                  "verdict": "fix before posting",
                  "counts": {
                    "high": 7,
                    "medium": 7,
                    "low": 5
                  },
                  "issues": [
                    {
                      "severity": "high",
                      "code": "pay_transparency_us_nyc",
                      "message": "New York City: ad is missing pay range (NYC Human Rights Law, Local Law 32 of 2022, in force since 2022-11-01, employers with 4+ employees).",
                      "fix": "Add a good-faith base pay range (min-max) for the role, per location if pay differs.",
                      "source": "https://www.nyc.gov/site/cchr/media/pay-transparency.page"
                    }
                  ],
                  "rewrites": [
                    {
                      "found": "digital native",
                      "replaceWith": "fluent with modern web tools",
                      "kind": "age",
                      "why": "Implies a younger age group (age-discrimination risk under the ADEA and similar laws)."
                    }
                  ],
                  "payTransparency": {
                    "jurisdictionsDetected": [
                      "us_nyc",
                      "us_ny"
                    ],
                    "remoteUsRole": true,
                    "payRangesFound": [],
                    "benefitsDescribed": false,
                    "applicationDeadlineStated": false,
                    "employees": "not given (assumed covered)",
                    "laws": [],
                    "lawsVerified": "2026-11-21"
                  },
                  "wording": {
                    "masculineCoded": [
                      "aggressive",
                      "competitive",
                      "driven",
                      "fearless"
                    ],
                    "feminineCoded": []
                  },
                  "experienceAsks": [
                    {
                      "text": "12+ years of Solidity experience",
                      "years": 12,
                      "technology": "Solidity",
                      "publicSince": 2015,
                      "impossible": "Solidity has only existed publicly since 2015 (11 years); asking 12 rules out every real candidate."
                    }
                  ],
                  "structure": {
                    "sections": {
                      "responsibilities": true,
                      "requirements": true,
                      "compensation": true,
                      "benefits": false,
                      "about_company": true,
                      "location_policy": true,
                      "hiring_process": false,
                      "eeo": false
                    },
                    "requirementBullets": 6
                  },
                  "readability": {
                    "words": 100,
                    "sentences": 15,
                    "avgWordsPerSentence": 6.7,
                    "fleschReadingEase": 48.6,
                    "longSentences": 0
                  },
                  "disclaimer": "Automated checklist by an AI recruiter, not legal advice.",
                  "input": {
                    "title": "Senior Solidity Engineer (Rockstar)",
                    "locations": "New York, NY; Remote (US)",
                    "employees": null,
                    "characters": 700,
                    "defaultedToExample": true
                  },
                  "service": {
                    "name": "Tao Talent Desk",
                    "version": "1.1.0"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge). An expired or invalid pass is reported in X-Pass-Error."
          },
          "404": {
            "description": "No public job board for this company (not charged)"
          },
          "502": {
            "description": "Job boards unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "check_job_posting_pay_transparency_post",
        "summary": "Job description checker: pay-transparency compliance, biased wording, impossible requirements (POST JSON)",
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The full job ad (40-15,000 characters). Omit to audit the built-in sample ad."
                  },
                  "title": {
                    "type": "string",
                    "description": "Job title (optional)"
                  },
                  "locations": {
                    "type": "string",
                    "description": "Where the job is advertised/based, e.g. \"New York, NY; Remote (US)\" (optional; also read from the text)"
                  },
                  "employees": {
                    "type": "integer",
                    "description": "Employer headcount, to apply size thresholds (optional; omitted = assume covered)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result"
          },
          "402": {
            "description": "Payment required (same challenges as GET)"
          }
        }
      }
    },
    "/v1/pass": {
      "get": {
        "operationId": "buy_talent_desk_pass",
        "summary": "7-day Talent Desk pass: unlimited hiring data + job-ad checks (fair use)",
        "description": "One payment, 7 days of every paid route here: returns a bearer token that makes /v1/company/hiring, /v1/web3/jobs, /v1/web3/report and /v1/jd/check (and the MCP tools) free for 7 days. For recruiting, job-search and sales-prospecting agents that look up several companies or job ads a day: cheaper than paying per call above about 34 company lookups (or 4 market reports) a week. Fair use: about one new query per second. Also payable by MPP (Tempo) or a plain USDC transfer on Base (?pay=transfer). No parameters needed.",
        "tags": [
          "subscription",
          "prepaid",
          "pass",
          "day-pass",
          "jobs",
          "hiring",
          "recruiting",
          "hiring-signals",
          "sales-intelligence",
          "job-search",
          "ai-agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xA1d3A5B2Bf8B7F98BdD64C2026333a51587A60C9"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "7-day Talent Desk pass: unlimited hiring data + job-ad checks (fair use): $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "pay",
            "in": "query",
            "required": false,
            "description": "transfer = return an exact-amount quote for a plain USDC transfer on Base instead of the x402/MPP challenge",
            "schema": {
              "type": "string",
              "enum": [
                "transfer"
              ]
            }
          },
          {
            "name": "tx",
            "in": "query",
            "required": false,
            "description": "Hash of your plain USDC transfer on Base (exact quoted amount, within 6h): returns the pass",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pass": {
                      "type": "object",
                      "properties": {
                        "token": {
                          "type": "string"
                        },
                        "issued_at": {
                          "type": "string"
                        },
                        "expires_at": {
                          "type": "string"
                        },
                        "valid_days": {
                          "type": "number"
                        },
                        "via": {
                          "type": "string"
                        },
                        "covers": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "how_to_use": {
                          "type": "string"
                        },
                        "fair_use": {
                          "type": "string"
                        }
                      }
                    },
                    "web3HiringPulse": {
                      "type": [
                        "object",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "pass": {
                    "token": "ttp1.EXAMPLE-ONLY.this-is-not-a-valid-token",
                    "issued_at": "2026-11-21T12:00:00.000Z",
                    "expires_at": "2026-11-28T12:00:00.000Z",
                    "valid_days": 7,
                    "via": "x402",
                    "covers": [
                      "/v1/company/hiring",
                      "/v1/web3/jobs",
                      "/v1/web3/report",
                      "/v1/jd/check"
                    ],
                    "how_to_use": "Send the header \"Authorization: Bearer <token>\" with GET or POST /v1/company/hiring, /v1/web3/jobs, /v1/web3/report, /v1/jd/check (any parameters), or pass it as arguments.pass to the MCP tools (POST /mcp), for 7 days. No further payment.",
                    "fair_use": "Covers /v1/company/hiring, /v1/web3/jobs, /v1/web3/report, /v1/jd/check (GET or POST, any parameters) and the matching MCP tools for 7 days from purchase. Fair use: about one new query per second per pass; an identical query repeated within 10 minutes may get the cached result. The pass is a bearer token: anyone holding it can use it, so keep it private. No refunds after delivery (the operator cannot move funds); if the purchase fails, nothing is charged."
                  },
                  "web3HiringPulse": {
                    "snapshotAt": "2026-11-21T10:13:11.024Z",
                    "headlines": [
                      "1197 open roles across 15 crypto employers; 370 first published in the last 30 days.",
                      "Largest hirers: OKX (388), Coinbase (252), Robinhood (163)."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge). Or add ?pay=transfer for a plain USDC transfer quote on Base, then ?tx=<hash>."
          },
          "404": {
            "description": "No public job board for this company (not charged)"
          },
          "502": {
            "description": "Job boards unavailable (not charged)"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "operationId": "mcp",
        "summary": "Remote MCP server (Streamable HTTP, JSON-RPC 2.0, JSON responses). Tools: company_hiring_signals, search_web3_jobs, web3_hiring_market_report, check_job_description, talent_desk_pass (when enabled), peek_company_hiring (free), payment_options (free). Payment is x402 over MCP inside tool results; this endpoint never answers HTTP 402.",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    },
    "/v1/peek": {
      "get": {
        "summary": "Free: open-role count for a company board",
        "security": [],
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/sources": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}