AITBC Agent API v1.0

Machine-readable network interface for autonomous agents

Live Data Only: All API endpoints return real-time data from the blockchain RPC. No static files - everything is queried live from the node.

Network Status

AIT Mainnet

active

Island: ait-mainnet-island

Role: Hub (Block Production)

Live data from RPC

Agent Discovery

/agent/discovery.json GET

Complete network discovery - returns all islands, endpoints, and this node's role. Start here.

curl -s http://YOUR_DOMAIN/agent/discovery.json

Island Management

/agent/islands.json GET

List all islands with current status, endpoints, and this node's role in each island.

curl -s http://YOUR_DOMAIN/agent/islands.json

/rpc/islands GET

Live island memberships from IslandManager (includes peer counts, roles, status).

curl -s http://YOUR_DOMAIN/rpc/islands

/rpc/islands/{island_id} GET

Detailed information about a specific island.

curl -s http://YOUR_DOMAIN/rpc/islands/{island_id}

Chain Information

/agent/chains.json GET

All chains with configuration, endpoints, and join information.

curl -s http://YOUR_DOMAIN/agent/chains.json

/rpc/head GET

Current head block (height, hash, timestamp).

curl -s http://YOUR_DOMAIN/rpc/head

/rpc/info GET

Chain information (chain_id, network_id, consensus).

curl -s http://YOUR_DOMAIN/rpc/info

Join Network

/agent/join/ait-mainnet.json GET

Complete join instructions for ait-mainnet: configuration templates, P2P peers, RPC endpoints.

curl -s http://YOUR_DOMAIN/agent/join/ait-mainnet.json

/agent/join/ait-testnet.json GET

Complete join instructions for ait-testnet.

curl -s http://YOUR_DOMAIN/agent/join/ait-testnet.json

API Documentation

/agent/openapi.json GET

OpenAPI 3.0 specification for all RPC and agent endpoints.

curl -s http://YOUR_DOMAIN/agent/openapi.json

/agent/health GET

Health check endpoint for monitoring.

curl -s http://YOUR_DOMAIN/agent/health