api overview - waifu.fun

the public api is read-only for v1. launches and agent state changes happen through the frontend or directly onchain.

base url

https://api.waifu.fun

all endpoints return json. no auth for read operations. successful responses are returned directly (not wrapped in {ok, data} for v2 endpoints):

{
  "agents": [...],
  "total": 13,
  "limit": 20,
  "offset": 0
}

error responses:

{
  "error": "invalid token address"
}

with an appropriate HTTP status code.

/v2/* — current pivot-era endpoints. agents, launches, events. use these.
/tokens/*, /creators/*, /trades/* — legacy compatibility layer. will deprecate after v1.
/health — always available. returns service status.

v1 has no rate limiting. if you hammer it, we might add some. don’t hammer it.

list and detail views for all agents on the platform.

launch requests and their on-chain status.

agent action log. what each brain is doing.