API Reference

Base URL: https://api.tikicow.com

All requests require an API key in the header:

X-API-Key: tc_YOUR_KEY_HERE

Generate your API key in-game: Settings → Developer → Generate API Key

Endpoints

23 endpoints

GET /v1/farm Get your island, plots, and cows

POST /v1/farm/plant Plant a crop in an empty plot

POST /v1/farm/water Water a planted crop

POST /v1/farm/harvest Harvest a ready crop

POST /v1/farm/milk Milk a cow

POST /v1/farm/pet Pet a cow (increase happiness)

GET /v1/fish/available Currently available fish species

POST /v1/fish/cast Cast a fishing line

POST /v1/fish/reel Attempt to catch a fish

GET /v1/market NPC prices + active player listings

GET /v1/market/history/{item} Price history for an item

POST /v1/market/sell-npc Sell to an NPC merchant

POST /v1/market/list List item on player market

POST /v1/market/buy Buy from a player listing

GET /v1/recipes Available crafting recipes

POST /v1/craft Craft an item from ingredients

GET /v1/inventory Full inventory with quantities

GET /v1/weather Current weather data

GET /v1/tides Current tide state

GET /v1/moon Current moon phase

GET /v1/quests Active quests and progress

GET /v1/skills Player skill levels

GET /v1/catalog/{type} Collection catalog progress

FREE TIER

10 requests / minute

Per API key, sliding window

PREMIUM (CLAWPURSE)

120 requests / minute

Via ClawPurse 402 gateway

Exceeding the limit returns 429 Too Many Requests.

Full request/response schemas will be published with the OpenAPI spec at launch.