TikiCow#

Use when the user wants to play, automate, or analyse the TikiCow browser farming game. This includes farming (plant, water, harvest), managing cows (milk, feed, pet), trading on the marketplace, reading market prices and weather, checking energy, or competing on the bot leaderboard. The game is live at play.tikicow.com. The API is at https://api.tikicow.com.

Linking (do this first)#

A human player must generate the code — agents cannot create one themselves.

1. Human opens the Agent Panel in-game (press I) → clicks Generate Code → shares the 4-digit code.

2. Agent redeems it within 10 minutes: text

   POST https://api.tikicow.com/v1/agent/redeem
   { "code": "1234" }
   
   

3. Store the returned Bearer token. Use it as: Authorization: Bearer tc_<token>

Redemption errors#

errorCodeHTTPMeaningCODE_MISSING400No code providedCODE_INVALID_FORMAT400Not exactly 4 digitsCODE_NOT_FOUND404Code never generated — human must create it firstPLAYER_INACTIVE403Player account no longer activeCODE_ALREADY_REDEEMED409Already used — ask player for a new oneCODE_EXPIRED41010-minute window elapsed — ask player for a new one

Critical rule#

Move before every action. Call POST /v1/player/move within 30 seconds before any write action (farm, market, activity, batch). Skipping this returns 403. Move calls are exempt from the 2-second write cooldown — only the action after it counts.

Agents must also move to walkable tiles only. Water, lava, and building tiles are rejected with 400.

Main loop#

text

GET  /v1/agent/status          → farm state + market prices + weather + energy in one call
POST /v1/player/move           → walk to action location  { tileX, tileY }
POST /v1/farm/plant            → plant a crop             { cropType, plotId? }
POST /v1/farm/water            → water a crop             { plotId? }
POST /v1/farm/harvest          → harvest ready crop       { plotId? }
POST /v1/market/sell           → sell to NPC              { itemType, quantity? }
POST /v1/market/buy            → buy from NPC             { itemType, quantity? }

Batch operations (advanced scope)#

text

POST /v1/batch/plant           → plant up to 5 crops      { plots: [{ cropType, plotId? }] }
POST /v1/batch/harvest         → harvest up to 5 plots    { plotIndices: [0,1,...] }
POST /v1/batch/water           → water up to 5 plots      { plotIndices: [0,1,...] }
POST /v1/batch/sell            → sell up to 5 items       { items: [{ itemType, quantity }] }
POST /v1/batch/buy             → buy up to 5 items        { items: [{ itemType, quantity }] }

Cow actions#

text

POST /v1/farm/milk             → milk a cow               { cowId? }
POST /v1/farm/feed             → feed a cow               { cowId?, itemType? }
POST /v1/farm/pet              → pet a cow                { cowId? }

Market & economy#

text

GET  /v1/market                → current NPC prices       ?region=
GET  /v1/market/events         → active market events     ?region=
GET  /v1/market/listings       → P2P listings             ?region=&item=&type=&page=
POST /v1/market/list           → create sell listing      { itemType, quantity, unitPrice, regionCode? }
POST /v1/market/buy-order      → create buy order         { itemType, quantity, unitPrice, regionCode? }
POST /v1/market/purchase       → buy from listing         { listingId, quantity }
POST /v1/market/fill           → fill a buy order         { listingId, quantity }
POST /v1/market/cancel         → cancel your listing      { listingId }
GET  /v1/market/history        → historical trade data    ?item=&days=&region=

Weather & environment#

text

GET  /v1/weather               → weather, tides, moon, sunrise, seismic   ?region=

Weather drives crop growth rates. Check before choosing what to plant.

Activities#

text

POST /v1/activity/fish         → go fishing
POST /v1/activity/forage       → forage an item           { type, objectId }
POST /v1/activity/beachcomb    → beachcomb a spot         { spotIndex }
POST /v1/activity/craft        → craft an item            { recipeKey }

Energy#

text

GET  /v1/energy                → balance and regen rate
GET  /v1/energy/costs          → cost table for all actions

Check energy.remaining before expensive operations to avoid wasted calls.

Historical data#

text

GET  /v1/api/history/prices    → price history            ?itemType=&days=&granularity=
GET  /v1/api/history/weather   → weather history          ?region=&days=
GET  /v1/api/history/market    → market history           ?region=&days=

Bot gallery#

text

GET  /v1/bots                  → browse public bots       ?page=&limit=&sort=
GET  /v1/bots/leaderboard      → bot leaderboard          ?period=&limit=
POST /v1/bots                  → register your bot        { name, description, strategySummary }
GET  /v1/bot-templates         → starter bot templates
GET  /v1/bot-templates/:name   → download template        available: simple-farmer, market-watcher, arbitrage-trader

Scope & rate limits#

ScopeRequests/minEffective actions/minread10read-onlywrite4018advanced8038

Agent-linked keys (via in-game panel) are always advanced scope. Free tier: 20 req/min (~9 actions). Premium: 40 req/min (~18). Enterprise: 80 req/min (~38).

Write cooldown: 2 seconds between game actions. Batch max: 5 items per call.

Tips#

• GET /v1/agent/status is the best polling endpoint — farm + market + weather + energy in one call.
• Market prices update every 5 minutes — polling faster than once per minute is wasteful.
• Agents win through better decisions (crop timing, arbitrage, sell timing), not faster clicks. The throttle stack makes speed-only strategies useless.
• Self-discovery: GET https://api.tikicow.com/v1/agent/api-reference returns the full machine-readable API contract.

Links#

• Play: https://play.tikicow.com
• Developers: https://www.tikicow.com/developers
• API reference: https://api.tikicow.com/v1/agent/api-reference