Valta Docs

REST API overview

Base URL

https://valta.co/api/v1

Authentication

Every request needs a valid API key:

http
x-api-key: vlt_live_...

Bearer tokens are accepted for compatibility, but x-api-key is the recommended header for server environments.

Rate limits

Limits are enforced per API key. When you exceed the per-minute allocation, Valta returns 429 with API key rate limit exceeded.

Response shape

Most endpoints return JSON objects with a success boolean plus resource payloads (agent, agents, wallet, policies, logs, etc.). Validation errors return { error: string } with 400. Authentication failures return { error: string } with 401 or 403.

Pagination

List endpoints that paginate accept limit and offset query parameters and include total in the JSON body when available.

Next steps