Agents - ActumX

Overview

Agents are Solana wallet keypairs that can be used to sign transactions and interact with the Solana blockchain. Each agent has a unique public key and an encrypted private key.

List Agents

curl https://api.actumx.app/v1/agents \
  -H "x-api-key: actumx_live_abc123..."

const response = await fetch('https://api.actumx.app/v1/agents', {
  headers: {
    'x-api-key': 'actumx_live_abc123...'
  }
});
const data = await response.json();

Response

array

List of agent objects

Show Agent object

string

Unique agent identifier with agent_ prefix

string

Display name for the agent

string

Solana public key (base58 encoded)

string

ISO 8601 timestamp of creation

number

Current balance in SOL

number

Current balance in lamports

string

Network identifier (e.g., “solana”)

string | null

Balance fetch error if any

{
  "agents": [
    {
      "id": "agent_abc123",
      "name": "My Trading Bot",
      "publicKey": "7xKzL3kQyH...",
      "createdAt": "2024-03-01T10:00:00Z",
      "balanceSol": 1.5,
      "balanceLamports": 1500000000,
      "network": "solana",
      "error": null
    }
  ]
}

Create Agent

Creates a new Solana wallet agent with a generated keypair.

curl -X POST https://api.actumx.app/v1/agents \
  -H "x-api-key: actumx_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Trading Bot"
  }'

const response = await fetch('https://api.actumx.app/v1/agents', {
  method: 'POST',
  headers: {
    'x-api-key': 'actumx_live_abc123...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'My Trading Bot'
  })
});
const data = await response.json();

Request Body

string

required

Display name for the agent

Minimum length: 2 characters
Maximum length: 80 characters

Response

string

Unique identifier for the created agent

string

Display name of the agent

string

Solana public key (base58 encoded)

string

Base64-encoded private key

This is only shown once. Store it securely immediately.

string

ISO 8601 timestamp

number

Initial balance in SOL (typically 0)

number

Initial balance in lamports

string

Network identifier

string

Security warning about storing the private key

{
  "agentId": "agent_abc123",
  "name": "My Trading Bot",
  "publicKey": "7xKzL3kQyH...",
  "privateKey": "base64_encoded_key...",
  "createdAt": "2024-03-01T10:00:00Z",
  "balanceSol": 0,
  "balanceLamports": 0,
  "network": "solana",
  "error": null,
  "warning": "Store this private key now. It is shown only once."
}

Fund Agent on Devnet

Request an airdrop of SOL to an agent’s wallet on Solana Devnet. This is useful for testing.

curl -X POST https://api.actumx.app/v1/agents/agent_abc123/fund-devnet \
  -H "x-api-key: actumx_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "amountSol": 1.0
  }'

const response = await fetch('https://api.actumx.app/v1/agents/agent_abc123/fund-devnet', {
  method: 'POST',
  headers: {
    'x-api-key': 'actumx_live_abc123...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amountSol: 1.0
  })
});
const data = await response.json();

Path Parameters

string

required

The ID of the agent to fund

Request Body

number

Amount of SOL to request (default: 1.0)

Minimum: 0.01 SOL
Maximum: 2 SOL

Response

string

Agent identifier

string

Network name (“solana-devnet”)

number

Amount of SOL requested

string

Transaction signature

string

Solana Explorer URL for the transaction

string

Agent’s public key

number

Updated balance in SOL

number

Updated balance in lamports

{
  "agentId": "agent_abc123",
  "network": "solana-devnet",
  "amountSol": 1.0,
  "signature": "5j7Kx...",
  "explorerUrl": "https://explorer.solana.com/tx/5j7Kx...?cluster=devnet",
  "publicKey": "7xKzL3kQyH...",
  "balanceSol": 1.0,
  "balanceLamports": 1000000000,
  "network": "solana",
  "error": null
}

Error Response

If the airdrop fails (e.g., rate limit exceeded), you’ll receive a 400 response:

{
  "error": "failed to fund agent on devnet"
}

Devnet airdrops are rate-limited by Solana. If you encounter errors, wait a few minutes before retrying.

Error Codes

Status	Error	Description
401	`unauthorized`	Missing or invalid API key
404	`agent_not_found`	Agent doesn’t exist or not owned by authenticated user
400	Error message	Devnet funding failed (e.g., rate limit)

​Overview

​List Agents

​Response

​Create Agent

​Request Body

​Response

​Fund Agent on Devnet

​Path Parameters

​Request Body

​Response

​Error Response

​Error Codes

Overview

List Agents

Response

Create Agent

Request Body

Response

Fund Agent on Devnet

Path Parameters

Request Body

Response

Error Response

Error Codes