API Reference

Build with the VALTA API

Base URL

https://valta.co/api/v1

All endpoints require Bearer token authentication

Authentication

Request Header

Authorization: Bearer YOUR_API_KEY

Get your API key from the Dashboard → API Keys

Endpoints

POST/v1/agents

Create a new agent identity with its own wallet

GET/v1/agents/{id}/wallet

Get an agent's wallet balance

POST/v1/wallet/transfer

Transfer funds between wallets

POST/v1/spend

Spend against an agent's wallet, checked against its policy

POST/v1/policies/{agentId}

Set or update spending policy for an agent

GET/v1/transactions

Get transaction history

GET/v1/audit

Retrieve the hash-chained audit trail

Quick Start

Create an Agent

curl -X POST https://valta.co/api/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-ai-agent",
    "type": "financial"
  }'

Response

{
  "success": true,
  "agent": {
    "id": "agent_abc123xyz",
    "name": "my-ai-agent",
    "type": "financial",
    "status": "active",
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

Rate Limits

Free100 req/day

Builder1,000 req/day

Startup10,000 req/day

Full Documentation →

VALTA — Lagos, Nigeria · Remote-first