Account & billing

Manage API keys, track usage, and monitor costs.

Cost estimation

Before you start, here's what API usage costs:

Endpoint type	Cost per request	1,000 requests	10,000 requests
Standard endpoints	$0.002	$2.00	$20.00
Private company endpoints	$0.02 (10x)	$20.00	$200.00

Check the response header

Every response includes X-Request-Cost-USD showing the exact cost of that request.

---

Check pricing

GET /api/pricing

Get current API pricing. This endpoint is public — no API key required.

Example

cURL

curl "https://api.vaulto.ai/api/pricing"

JavaScript

const response = await fetch('https://api.vaulto.ai/api/pricing');
const { costPerRequestUsd, pricing } = await response.json();
console.log(`Cost per request: $${costPerRequestUsd}`);

Python

import requests

response = requests.get('https://api.vaulto.ai/api/pricing')
data = response.json()
print(f"Cost per request: ${data['costPerRequestUsd']}")

Response

{
  "pricing": {
    "unit": "per 1,000 requests",
    "amountUsd": 2.00,
    "currency": "USD"
  },
  "costPerRequestUsd": 0.002
}

---

View usage

GET /api/usage

Get your usage records. Each record shows the endpoint called, timestamp, and cost.

Parameters

Parameter	Type	Default	Description
from	string	—	Start date (ISO 8601)
to	string	—	End date (ISO 8601)
limit	integer	1000	Max records (max 10,000)

Examples

cURL

# Get last 100 requests
curl -H "x-api-key: YOUR_KEY" \
  "https://api.vaulto.ai/api/usage?limit=100"

# Get usage for a specific date range
curl -H "x-api-key: YOUR_KEY" \
  "https://api.vaulto.ai/api/usage?from=2024-01-01&to=2024-01-31"

JavaScript

// Get usage for the current month
const now = new Date();
const startOfMonth = new Date(now.getFullYear(), now.getMonth(), 1);

const response = await fetch(
  `https://api.vaulto.ai/api/usage?from=${startOfMonth.toISOString()}&limit=1000`,
  { headers: { 'x-api-key': process.env.VAULTO_API_KEY } }
);

const { records } = await response.json();
const totalCost = records.reduce((sum, r) => sum + r.costUsd, 0);
console.log(`This month: ${records.length} requests, $${totalCost.toFixed(2)}`);

Python

from datetime import datetime, timedelta

# Get last 7 days of usage
week_ago = (datetime.now() - timedelta(days=7)).isoformat()
response = requests.get(
    'https://api.vaulto.ai/api/usage',
    params={'from': week_ago, 'limit': 1000},
    headers={'x-api-key': API_KEY}
)

records = response.json()['records']
total_cost = sum(r['costUsd'] for r in records)
print(f"Last 7 days: {len(records)} requests, ${total_cost:.2f}")

Response

{
  "records": [
    {
      "id": "usage_001",
      "path": "/api/trading/valuation",
      "method": "GET",
      "timestamp": "2024-01-15T10:30:00Z",
      "costUsd": 0.002,
      "currency": "USD"
    },
    {
      "id": "usage_002",
      "path": "/api/private-companies/spacex",
      "method": "GET",
      "timestamp": "2024-01-15T10:31:00Z",
      "costUsd": 0.02,
      "currency": "USD"
    }
  ],
  "total": 2
}

Try it

Set your API key in the nav bar to try this endpoint.

---

Billing summary

GET /api/billing

Get your current billing summary including usage count, costs, and account balance.

Example

cURL

curl -H "x-api-key: YOUR_KEY" \
  "https://api.vaulto.ai/api/billing"

JavaScript

const response = await fetch('https://api.vaulto.ai/api/billing', {
  headers: { 'x-api-key': process.env.VAULTO_API_KEY }
});
const billing = await response.json();
console.log(`Balance: $${billing.balanceUsd}`);
console.log(`Usage this period: ${billing.usageCount} requests`);

Python

response = requests.get(
    'https://api.vaulto.ai/api/billing',
    headers={'x-api-key': API_KEY}
)
billing = response.json()
print(f"Balance: ${billing['balanceUsd']}")
print(f"Usage this period: {billing['usageCount']} requests")

Response

{
  "usageCount": 1250,
  "usageCostUsd": 2.50,
  "balanceUsd": 97.50,
  "pricing": {
    "unit": "per 1,000 requests",
    "amountUsd": 2.00,
    "currency": "USD"
  },
  "costPerRequestUsd": 0.002
}

Try it

Set your API key in the nav bar to try this endpoint.

---

API key management

Manage your API keys programmatically. These endpoints require a dashboard API key (different from your regular API key).

List keys

GET /api/keys

Returns your API keys with masked values.

curl -H "x-api-key: DASHBOARD_KEY" \
  "https://api.vaulto.ai/api/keys"

Response

{
  "keys": [
    {
      "id": "key_001",
      "name": "Production",
      "maskedKey": "vaulto_abc...xyz",
      "createdAt": "2024-01-01T00:00:00Z",
      "lastUsed": "2024-01-15T10:30:00Z"
    }
  ]
}

Create key

POST /api/keys

Creates a new API key. The full key is returned only once — store it securely.

curl -X POST -H "x-api-key: DASHBOARD_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My new key"}' \
  "https://api.vaulto.ai/api/keys"

Response

{
  "id": "key_002",
  "name": "My new key",
  "key": "vaulto_abc123def456...",
  "createdAt": "2024-01-15T12:00:00Z"
}

Store your key securely

The full API key is only shown once. Save it immediately in a secure location.

Revoke key

DELETE /api/keys/:id

Permanently revokes an API key. This cannot be undone.

curl -X DELETE -H "x-api-key: DASHBOARD_KEY" \
  "https://api.vaulto.ai/api/keys/key_002"

---

Insufficient balance

If your account balance is zero or insufficient, API requests return 402 Payment Required:

{
  "code": "INSUFFICIENT_BALANCE",
  "message": "Account balance is zero. Add funds in the dashboard.",
  "status": 402
}

To fix this:

1. Log in to the Dashboard
2. Navigate to Billing
3. Add funds using USDC

---

Response headers

Every billable request includes these headers:

Header	Description	Example
X-Request-Cost-USD	Cost in USD for this request	0.002
X-Request-Id	Unique request ID	req_abc123

Use X-Request-Id when contacting support about specific requests.