Skip to main content

Overview

The Camino Treasury API allows you to programmatically manage wallets, track transactions, prepare deposits and withdrawals, estimate yield, and configure webhooks for your organization.

View OpenAPI Spec

View the full OpenAPI specification

Base URL

https://api.caminotreasury.com/v1

Authentication

All API endpoints require an API key passed in the x-api-key header. You can generate API keys from the Camino Treasury dashboard. Each key is scoped to a single organization — all data returned by the API is isolated to that organization.
curl https://api.caminotreasury.com/v1/wallets \
  -H "x-api-key: your-api-key"
Requests without a valid API key will receive a 401 Unauthorized response. Expired or revoked keys are also rejected.

Rate Limiting

All endpoints are rate-limited to 100 requests per 60 seconds per API key (or per IP address if no key is provided). Rate limit headers are included in every response:
HeaderDescription
X-RateLimit-LimitMaximum requests per window (100)
X-RateLimit-RemainingRequests remaining in the current window
Retry-AfterSeconds to wait before retrying (only on 429)

Permissions

API access is scoped to the organization associated with your API key. All wallet, transaction, and webhook data is isolated per organization.

Endpoints

Wallets

MethodEndpointDescription
GET/walletsList all wallets
POST/walletsRegister a new wallet
DELETE/wallets/{address}Remove a wallet

Balances

Balance endpoints are scoped by chain ID.
MethodEndpointDescription
GET/{chainId}/balances/{address}Get all token balances for a wallet

Transactions

Transaction endpoints are scoped by chain ID.
MethodEndpointDescription
GET/{chainId}/transactionsList transactions (filter by status, type; cursor pagination)
POST/{chainId}/transactionsSubmit a transaction for tracking
GET/{chainId}/transactions/{hash}Get a transaction with its on-chain receipt

Deposit

MethodEndpointDescription
POST/{chainId}/deposit/preparePrepare transaction steps to deposit stablecoins into C0

Withdraw

MethodEndpointDescription
POST/{chainId}/withdraw/preparePrepare transaction steps to withdraw C0 to stablecoins

Yield

MethodEndpointDescription
GET/{chainId}/yield/estimateGet yield projection for a wallet’s C0 balance

Webhooks

MethodEndpointDescription
GET/webhooksList all webhooks
POST/webhooksRegister a new webhook
DELETE/webhooks/{id}Remove a webhook