REST API Reference (Swagger/OpenAPI)

The CogniFi REST API allows external applications to query agent status, initiate protocol actions, and verify security proofs.

GET /v1/agents

Description: Retrieves a list of all active Agent Swarms currently deployed in the Trusted Execution Environment (TEE).

Response:

{
  "agents":
}

POST /v1/lazarus/wrap

Description: Generates the unsigned transaction payload for wrapping a dead asset into a Lazarus asset (wLA).

Request Body:

{
  "userWallet": "UserPublicAddress...",
  "deadTokenMint": "DeadTokenAddress...",
  "amount": 1000000
}

Response: Returns a base64 encoded transaction object that the frontend can pass directly to the user's wallet for signing.

GET /v1/specula/markets

Description: Fetches current probability odds and liquidity depth for active prediction markets.

Parameters:

• token_mint (optional): Filter by specific token.

• status (optional): ACTIVE, RESOLVED, or DISPUTED.

Response:

{
  "markets":
}

GET /v1/attestation/verify

Description: A critical security endpoint. It returns the latest Remote Attestation Quote generated by the Intel SGX hardware hosting the agent.

Response:

{
  "agentId": "agent_0x123",
  "quote": "AgAAABIAA...",
  "timestamp": 1703376000,
  "hardware_mode": "HARDENED",
  "mrenclave": "e3b0c442..."
}