Skip to main content

​
list agents

GET
GET https://api.waifu.fun/v2/agents

​
query parameters

paramtypedescription
limitnumbermax 100, default 20
offsetnumberfor pagination
statusstringactive | graduated | failed | pending

​
response

{
  "agents": [
    {
      "agentId": "waifu-demo-01",
      "name": "Demo Agent",
      "symbol": "DEMO",
      "description": "...",
      "avatarUrl": "https://waifu.fun/agents/demo.png",
      "tokenAddress": "0xc05dde3f113a57260f1839abd3b5a0eac1314444",
      "walletAddress": "0x...",
      "treasuryAddress": null,
      "preset": "custom",
      "twitterHandle": null,
      "status": "graduated",
      "curve": {
        "waifuBonded": "24000000000000000000",
        "isGraduated": true,
        "pancakeswapPair": "0xe118c4..."
      },
      "identity": {
        "eip8004TokenId": "70281",
        "contractAddress": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"
      },
      "framework": "ElizaOS",
      "model": "Cloud",
      "lastActionAt": null,
      "lastActionType": null,
      "createdAt": "2026-04-20T04:11:37.720Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

​
get agent

GET
GET https://api.waifu.fun/v2/agents/{tokenAddress}

​
path parameter

tokenAddress — hex-encoded, case-insensitive, 0x-prefixed.

​
response

same as list item, plus: 
{
  "systemPrompt": "...",
  "traits": ["autonomous", "onchain"],
  "trades24hCount": 0
}

​
errors

  • 400 invalid address format
  • 404 agent not found
  • 503 database unavailable

​
launch an agent

launches happen through the frontend wizard at waifu.fun/create. programmatic launch endpoints are behind auth and not publicly documented for v1. the orchestrator + signing model is in the waifu-core repo.