SDKs & Libraries

TypeScript / JavaScript SDK

The official Valta SDK for TypeScript and JavaScript is the primary client library for interacting with the Valta API. It supports Node.js 18+, Deno, Bun, and modern browsers with full TypeScript type definitions included out of the box.

Installation

Or using other package managers:

Quick Start

Initialize the client with your API key and start making requests immediately:

import { ValtaClient } from "valta-sdk";

const valta = new ValtaClient({
  apiKey: process.env.VALTA_API_KEY,
});

Create an Agent

Every agent gets its own wallet the moment it's created — no separate wallet creation step.

const agent = await valta.agents.create({
  name: "Treasury Manager",
  type: "financial",
});

console.log(agent.id); // "agent_7f3k..."

Check Balance

Retrieve the current balance for an agent's wallet.

const wallet = await valta.wallets.get(agent.id);
console.log(wallet.balance); // 142.50

const balance = await valta.wallets.getBalance(agent.id);
console.log(balance); // 142.50

Freeze an Agent

Stop an agent's financial access immediately — pending spend halts, new spend is blocked until you unfreeze it.

await valta.agents.freeze(agent.id);
// { success: true, agentId: "agent_7f3k...", status: "frozen" }

List Transactions

Fetch a paginated list of transactions for an agent's wallet.

const txns = await valta.wallets.listTransactions(agent.id, { limit: 25 });

for (const txn of txns.data) {
  console.log(txn.id, txn.amount, txn.description);
}

Python SDK

The official Python SDK is currently in development and will support Python 3.9+. It will provide the same full-featured interface as the TypeScript SDK, including async/await support via asyncio and synchronous wrappers.

# Coming soon
pip install valta

Email developer@valta.co to be notified when the Python SDK enters beta.

Other Languages

SDKs for Go, Ruby, and PHP are on the roadmap. In the meantime, you can integrate with Valta using the REST API directly. All endpoints accept and return JSON, and authentication is handled via Bearer tokens in the Authorization header.

Need Help?

If you run into issues or have questions about the SDK, reach out via our support channels or open an issue on GitHub. We aim to respond within 24 hours.