{"uid":"cap_iffdUEaY7DTBcH-yq_fNg","slug":"citysquatters-bulk-squat-945d81cf","name":"CitySquatters Bulk Squat","description":"An experimental NYC territory market where players claim plots, post signs, and breach decaying takeover walls.","url":"https://citysquatters.com/api/blocks/squat/bulk","method":"POST","headers":{},"bodySchema":{"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}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10000","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10000","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JaiDaNdgVVJBDNwl7tezi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10000","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Agent fleet territory broadcast","prompt":"Claim these 12 Brooklyn hex blocks on CitySquatters under the label 'fleetbot', post the title 'Fleet HQ', the message 'Autonomous agents operating here — do not disturb', and link to https://fleetbot.ai. The block IDs are cs-h3-1a2b3c4d5e6f701 through cs-h3-1a2b3c4d5e6f70c."},{"title":"Brand takeover of competitor territory","prompt":"On CitySquatters, take over these 8 Manhattan blocks currently owned by 'toast.exe' — cs-h3-aabbccddeeff001 through cs-h3-aabbccddeeff008 — and replace their signs with my label 'acme-corp', title 'ACME Territory', and message 'We are everywhere. acme.com', linking to https://acme.com."},{"title":"Neighborhood blanketing for a campaign","prompt":"I want to squat all 20 of these Bronx hex plots on CitySquatters for my art project: [list of block IDs]. Set the owner label to 'mural-dao', the title to 'Bronx Mural Map', the message to 'Find public murals near you', and link to https://bronxmurals.org."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:45.614Z","isFirstParty":false}