Skip to main content

​
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..."

​
Response

​
agents
array
List of agent objects
{
  "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"
  }'

​
Request Body

​
name
string
required
Display name for the agent
  • Minimum length: 2 characters
  • Maximum length: 80 characters

​
Response

​
agentId
string
Unique identifier for the created agent
​
name
string
Display name of the agent
​
publicKey
string
Solana public key (base58 encoded)
​
privateKey
string
Base64-encoded private key
This is only shown once. Store it securely immediately.
​
createdAt
string
ISO 8601 timestamp
​
balanceSol
number
Initial balance in SOL (typically 0)
​
balanceLamports
number
Initial balance in lamports
​
network
string
Network identifier
​
warning
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
  }'

​
Path Parameters

​
agentId
string
required
The ID of the agent to fund

​
Request Body

​
amountSol
number
Amount of SOL to request (default: 1.0)
  • Minimum: 0.01 SOL
  • Maximum: 2 SOL

​
Response

​
agentId
string
Agent identifier
​
network
string
Network name (“solana-devnet”)
​
amountSol
number
Amount of SOL requested
​
signature
string
Transaction signature
​
explorerUrl
string
Solana Explorer URL for the transaction
​
publicKey
string
Agent’s public key
​
balanceSol
number
Updated balance in SOL
​
balanceLamports
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

StatusErrorDescription
401unauthorizedMissing or invalid API key
404agent_not_foundAgent doesn’t exist or not owned by authenticated user
400Error messageDevnet funding failed (e.g., rate limit)