Agents

Agents are AI-driven entities you can create, train, and deploy. They analyze data, execute tasks, and adapt in real time.

List all agents

get

Retrieve a paginated list of all AI agents, with optional filters for limit and page.

Query parameters

limitintegerOptional

Number of agents to return per page

Default: 20

pageintegerOptional

Page number

Default: 1

Responses

get

HTTPcURLJavaScriptPython

GET /v1/agents HTTP/1.1
Host: api.aver.co
Accept: */*

[
  {
    "id": "agent_12345",
    "name": "MarketAnalyzerAgent",
    "description": "Analyzes crypto markets and optimizes trading strategies.",
    "functions": "function analyzeMarket(data) { /* ... */ }",
    "status": "idle"
  }
]

Create an agent

post

Create a new AI agent to be trained and deployed on the Aver platform.

Body

namestringRequired

descriptionstringOptional

functionsstringOptional

Responses

post

HTTPcURLJavaScriptPython

POST /v1/agents HTTP/1.1
Host: api.aver.co
Content-Type: application/json
Accept: */*
Content-Length: 132

{
  "name": "MyFirstAgent",
  "description": "This agent analyzes crypto markets.",
  "functions": "function analyzeMarket(data) { /* ... */ }"
}

{
  "id": "agent_12345",
  "name": "MarketAnalyzerAgent",
  "description": "Analyzes crypto markets and optimizes trading strategies.",
  "functions": "function analyzeMarket(data) { /* ... */ }",
  "status": "idle"
}

Fetch agent by ID

get

Retrieve details of a specific agent by its unique ID.

Path parameters

idstringRequired

The unique identifier of the agent.

Responses

get

HTTPcURLJavaScriptPython

GET /v1/agents/{id} HTTP/1.1
Host: api.aver.co
Accept: */*

{
  "id": "agent_12345",
  "name": "MarketAnalyzerAgent",
  "description": "Analyzes crypto markets and optimizes trading strategies.",
  "functions": "function analyzeMarket(data) { /* ... */ }",
  "status": "idle"
}

Update an agent

patch

Update the metadata of an existing agent. You can edit the name, description, or associated functions.

Path parameters

idstringRequired

The unique identifier of the agent.

Body

namestringOptional

descriptionstringOptional

functionsstringOptional

Responses

patch

HTTPcURLJavaScriptPython

PATCH /v1/agents/{id} HTTP/1.1
Host: api.aver.co
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "name": "text",
  "description": "text",
  "functions": "text"
}

{
  "id": "agent_12345",
  "name": "MarketAnalyzerAgent",
  "description": "Analyzes crypto markets and optimizes trading strategies.",
  "functions": "function analyzeMarket(data) { /* ... */ }",
  "status": "idle"
}

Delete an agent

delete

Permanently remove an agent from the platform by ID.

Path parameters

idstringRequired

The unique identifier of the agent.

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v1/agents/{id} HTTP/1.1
Host: api.aver.co
Accept: */*

No content

Train an agent

post

Initiate the training process for a specific agent using provided data or parameters.

Path parameters

idstringRequired

The unique identifier of the agent to train.

Body

trainingDatastringOptional

Location or references to the training dataset.

hyperparametersobjectOptional

Hyperparameter configurations for the training process.

Responses

post

HTTPcURLJavaScriptPython

POST /v1/agents/{id}/train HTTP/1.1
Host: api.aver.co
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "trainingData": "text",
  "hyperparameters": {}
}

{
  "agentId": "text",
  "status": "in-progress",
  "progress": 45
}

Get training status

get

Retrieve the current status (in-progress, completed, failed) of an agent's training.

Path parameters

idstringRequired

The unique identifier of the agent.

Responses

get

HTTPcURLJavaScriptPython

GET /v1/agents/{id}/train/status HTTP/1.1
Host: api.aver.co
Accept: */*

{
  "agentId": "text",
  "status": "in-progress",
  "progress": 45
}

Deploy an agent

post

Deploy a trained agent to the blockchain or a supported environment for live usage.

Path parameters

idstringRequired

The unique identifier of the agent.

Responses

post

HTTPcURLJavaScriptPython

POST /v1/agents/{id}/deploy HTTP/1.1
Host: api.aver.co
Accept: */*

{
  "agentId": "text",
  "deploymentId": "text",
  "message": "Agent successfully deployed to mainnet."
}

Retrieve agent logs

get

Fetch the logs generated by a deployed agent, including any blockchain interactions or function calls.

Path parameters

idstringRequired

The unique identifier of the agent.

Query parameters

limitintegerOptional

Limit the number of log entries.

Default: 50

Responses

get

HTTPcURLJavaScriptPython

GET /v1/agents/{id}/logs HTTP/1.1
Host: api.aver.co
Accept: */*

[
  {
    "timestamp": "2025-01-06T12:34:56Z",
    "message": "Agent executed function analyzeMarket"
  }
]

Execute a function on the agent

post

Run one of the agent’s associated functions with your specified input data.

Path parameters

idstringRequired

The unique identifier of the agent.

Body

functionNamestringRequired

Name of the function to execute.

inputDataobjectOptional

Any data required by the function.

Responses

post

HTTPcURLJavaScriptPython

POST /v1/agents/{id}/execute HTTP/1.1
Host: api.aver.co
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "functionName": "text",
  "inputData": {}
}

{
  "result": {},
  "message": "Function executed successfully."
}