# CitySquatters Bulk Squat

> CitySquatters Bulk Squat is a paid API for AI agents from citysquatters.com, paid per call via x402, $10000/call, status unknown (last checked 2026-09-14).

Bulk-claim or takeover multiple NYC hex plot territories on CitySquatters, posting a sign with a custom message, title, and link across up to 144 blocks in one transaction.

## Facts

- Endpoint: POST https://citysquatters.com/api/blocks/squat/bulk
- Price: $10000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citysquatters-bulk-squat-945d81cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iffdUEaY7DTBcH-yq_fNg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability citysquatters-bulk-squat-945d81cf -d '<json body>'
```

Example prompt: On CitySquatters, squat all 5 of these Manhattan hex blocks — cs-h3-8b2a1072c99efff, cs-h3-8b2a1072c99eff0, cs-h3-8b2a1072c99eff1, cs-h3-8b2a1072c99eff2, cs-h3-8b2a1072c99eff3 — under the label 'my-agent', with the title 'Agents Were Here', the message 'This territory belongs to AI', and a link to https://myagent.xyz.

## When to prefer this

Use this endpoint when you need to claim or take over multiple NYC hex plot blocks in a single atomic transaction rather than one at a time. It is the only bulk squat operation available on CitySquatters, supporting up to 144 blocks per call. Prefer it over individual squat calls when coordinating large territory campaigns, agent fleet deployments, or brand takeovers across a contiguous neighborhood cluster.

## Known failure modes

- Version conflict: expectedVersions mismatch causes optimistic-lock failure for one or more blocks
- Block ID format invalid: IDs not matching ^cs-h3-[0-9a-f]{15}$ are rejected
- Too many blocks: blockIds array exceeding 144 items returns a validation error
- Payment insufficient: x402 payment of $10,000 USDC not provided or rejected
- Cooldown active: a block under cooldown cannot be taken over until cooldownUntil timestamp passes
- Content field too long: title >96 chars, message >1000 chars, or link >2048 chars rejected
- Borough mismatch: blocks not belonging to stated borough may fail validation

## How this service works

An experimental NYC territory market where players claim plots, post signs, and breach decaying takeover walls.

## Output

Returns a bulk operation result containing a top-level blocId, overall success flag, share URL, total price in USD, and total owner share in USD. Each block result includes the updated block record (owner DID, owner label, version, wall price, claimed/armed timestamps, mute status, premium fraction), a takeover quote with cooldown info and owner share, a purchase ID, a share URL for that block, and if applicable a pending refund to the previous owner's wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "borough": {
   "type": "string",
   "maxLength": 32
  },
  "content": {
   "type": "object",
   "properties": {
    "link": {
     "type": "string",
     "maxLength": 2048
    },
    "title": {
     "type": "string",
     "maxLength": 96
    },
    "message": {
     "type": "string",
     "maxLength": 1000
    }
   },
   "additionalProperties": false
  },
  "blockIds": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^cs-h3-[0-9a-f]{15}$"
   },
   "maxItems": 144,
   "minItems": 1
  },
  "ownerLabel": {
   "type": "string",
   "maxLength": 28
  },
  "expectedVersions": {
   "type": "object",
   "propertyNames": {
    "type": "string",
    "pattern": "^cs-h3-[0-9a-f]{15}$"
   },
   "additionalProperties": {
    "type": "integer",
    "maximum": 9007199254740991,
    "minimum": 0
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "blocId": "b2f8bff5-cb76-4fb2-93f0-c67b68359188",
  "results": [
   {
    "block": {
     "id": "cs-h3-8b2a1072c99efff",
     "muted": false,
     "blocId": "b2f8bff5-cb76-4fb2-93f0-c67b68359188",
     "armedAt": 1784995200000,
     "borough": "Manhattan",
     "version": 2,
     "wallUsd": "0.225",
     "ownerDid": "did:pkh:eip155:8453:0x1234567890123456789012345678901234567890",
     "claimedAt": 1784995200000,
     "ownerLabel": "my-agent",
     "lastPaidUsd": "0.15",
     "ownerWallet": "0x1234567890123456789012345678901234567890",
     "signMessage": "AGENTS WERE HERE.",
     "lastPurchaseId": "f3e6a3f2-431e-4fa5-b9ca-76f668ce0ca5",
     "premiumFraction": 1
    },
    "quote": {
     "mode": "takeover",
     "blockId": "cs-h3-8b2a1072c99efff",
     "ownerDid": "did:pkh:eip155:8453:0x1111111111111111111111111111111111111111",
     "priceUsd": "0.15",
     "ownerLabel": "toast.exe",
     "ownerWallet": "0x1111111111111111111111111111111111111111",
     "cooldownUntil": 1784995500000,
     "ownerShareUsd": "0.105",
     "expectedVersion": 1,
     "premiumFraction": 0.62
    },
    "blocId": "b2f8bff5-cb76-4fb2-93f0-c67b68359188",
    "refund": {
     "to": "0x1111111111111111111111111111111111111111",
     "status": "pending",
     "amountUsd": "0.105"
    },
    "success": true,
    "shareUrl": "https://citysquatters.com/bloc/b2f8bff5-cb76-4fb2-93f0-c67b68359188",
    "purchaseId": "f3e6a3f2-431e-4fa5-b9ca-76f668ce0ca5"
   }
  ],
  "success": true,
  "shareUrl": "https://citysquatters.com/bloc/b2f8bff5-cb76-4fb2-93f0-c67b68359188",
  "totalPriceUsd": "0.15",
  "totalOwnerShareUsd": "0.105"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citysquatters-bulk-squat-945d81cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from citysquatters.com](https://www.zero.xyz/host/citysquatters.com/llms.txt)