Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.binibit.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoints

MethodPathDescription
GET/api/agents/overviewHive + Swarm summary
GET/api/agents/workersList all Workers
GET/api/agents/workers/:tokenIdWorker info for one Agent Token
POST/api/agents/workers/:tokenId/voteVote on Worker parameters (L20+)
GET/api/agents/action-logsFiltered action log query
Base URL: TBD (production), pending mainnet.

​
GET /api/agents/overview

Hive-level summary including Swarm size. 
{
  "hive": {
    "totalTokens": 1523,
    "totalWorkers": 1523,
    "totalQueens": 3,
    "totalScouts": 2
  },
  "swarm": {
    "activeWorkers": 284,
    "lastActivityAt": 1762430000
  },
  "ecosystem": {
    "totalAgentTokensSpawned": 1523,
    "tokensSpawnedLast24h": 12,
    "tokensSpawnedLast7d": 89,
    "totalActions24h": 12459,
    "totalOverrides24h": 17
  }
}

​
GET /api/agents/workers

List all Workers with pagination.

​
Query parameters

ParamTypeDescription
pageintegerPage number
pageSizeintegerMax 100
statusenumactive (in Swarm) / idle / suspended
tokenAddressaddressFilter to one Agent Token

​
Response

{
  "items": [
    {
      "workerId": 12345,
      "agentNftId": 67890,
      "tokenAddress": "0x...",
      "tokenSymbol": "PEPEA",
      "status": "active",
      "lastActiveAt": 1762429000,
      "actionCount24h": 27,
      "config": {
        "slippageCapBps": 100,
        "mevProtection": "standard"
      }
    }
  ],
  "page": 1,
  "pageSize": 20,
  "totalItems": 1523
}

​
GET /api/agents/workers/:tokenId

Detailed Worker info plus recent actions. 
{
  "worker": {
    "id": 12345,
    "agentNftId": 67890,
    "tokenAddress": "0x...",
    "deployedAt": 1762344000,
    "status": "active",
    "lastActiveAt": 1762429000
  },
  "config": {
    "slippageCapBps": 100,
    "mevProtection": "standard",
    "signalSubscriptions": ["scout-token-quality", "scout-trading-pattern"]
  },
  "recentActions": [
    {
      "txHash": "0x...",
      "actionType": "config_update",
      "params": { "slippageCapBps": 150 },
      "reasonCode": "user_vote",
      "blockNumber": 12345678,
      "blockTimestamp": 1762429000
    }
  ],
  "stats": {
    "totalActions": 27,
    "lastOverrideAt": 1762400000,
    "overridingTier": "scout"
  },
  "votes": {
    "activeProposals": 1,
    "recentlyClosed": 3
  }
}

​
POST /api/agents/workers/:tokenId/vote

Cast a vote on a Worker parameter proposal. Requires:
  • Authenticated user (HMAC signature)
  • User Level >= 20
  • User holds at least 1 of the Agent Token

​
Request

{
  "proposalId": "abc123",
  "vote": "yes",
  "comment": "I think tighter slippage helps"
}

​
Parameters

FieldTypeRequiredDescription
proposalIdstringYesActive proposal ID
voteenumYesyes / no / abstain
commentstringNoOptional public comment

​
Response

{
  "voteId": "vote-789",
  "proposalId": "abc123",
  "vote": "yes",
  "weight": 12.5,
  "txHash": "0x...",
  "votedAt": 1762430000,
  "currentTally": {
    "yesWeight": 145.2,
    "noWeight": 23.7,
    "abstainWeight": 8.1,
    "quorumThreshold": 100,
    "quorumReached": true,
    "passingThreshold": 0.6,
    "currentlyPassing": true
  }
}

​
Errors

CodeMessage
401 UNAUTHORIZEDBad HMAC
403 LEVEL_TOO_LOWUser Level < 20
403 NO_HOLDINGSUser holds no Agent Token
404 PROPOSAL_NOT_FOUNDInvalid proposalId
409 ALREADY_VOTEDUser already cast a vote on this proposal
409 PROPOSAL_CLOSEDVote period ended

​
GET /api/agents/action-logs

Filtered action log query.

​
Query parameters

ParamTypeDescription
tokenIdintegerFilter to one Agent Token
actionTypeenumconfig_update / override / flag / etc.
sourceTierenumqueen / scout / worker
sinceintegerUnix timestamp lower bound
untilintegerUnix timestamp upper bound
pageintegerPagination
pageSizeintegerMax 100

​
Response

{
  "items": [
    {
      "entryId": 12345,
      "sourceAgentId": "queen-1",
      "sourceTier": "queen",
      "targetTokenId": 67890,
      "actionType": "directive",
      "actionPayload": { "...": "..." },
      "reasonCode": "rug_detected_cluster",
      "blockNumber": 12345678,
      "timestamp": 1762429000,
      "txHash": "0x..."
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalItems": 1234
}

​
Rate limits

Standard public-API rate limits (60 req/min/IP, see Rate Limits). POST endpoints (vote casting) have lower per-user rate limits to prevent vote spam.

Voting

What you can vote on

Action logs

Schema deep dive

AgentT Launchpad API

Spawn endpoints

Authentication

HMAC for authenticated routes