Veltro API

Veltro is non-custodial USDC payment infrastructure for Web3 organizations, on Base, Arbitrum, Optimism, Polygon, and Ethereum. This is the reference for the public REST API (/api/v1/*) — the same API the Veltro AI agent itself uses under the hood.

:::tip Non-custodial by design Veltro never holds your funds and never signs a transaction on your behalf. Every POST endpoint that moves money returns unsigned calldata ({ to, data, value }) or a hosted checkout URL — you (or your own wallet-holding system) sign and broadcast it. Veltro cannot touch your funds even if it wanted to. :::

Base URL

https://www.veltro.online/api/v1

Quickstart

1. Create an API key from your dashboard → API keys. Keys look like vltro_live_... and carry read, write, or admin scopes.
2. Call any endpoint with Authorization: Bearer <key>.

cURL

curl -X POST https://www.veltro.online/api/v1/payment-links \
  -H "Authorization: Bearer vltro_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_usd": 100,
    "description": "Invoice #42",
    "destination_address": "0xYourWalletAddress"
  }'

JavaScript

const res = await fetch("https://www.veltro.online/api/v1/payment-links", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VELTRO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    amount_usd: 100,
    description: "Invoice #42",
    destination_address: "0xYourWalletAddress",
  }),
});
const { data } = await res.json();

Python

import os, requests

res = requests.post(
    "https://www.veltro.online/api/v1/payment-links",
    headers={"Authorization": f"Bearer {os.environ['VELTRO_API_KEY']}"},
    json={
        "amount_usd": 100,
        "description": "Invoice #42",
        "destination_address": "0xYourWalletAddress",
    },
)
data = res.json()["data"]

Every response is JSON, wrapped as { "data": ... } on success or { "error": ... } on failure. See Errors & rate limits for the full status-code table.

What you can do

Resource	What it does
Payment links	Create/list hosted USDC payment pages
Invoices	Line-item invoices with an auto-generated payment link
Subscriptions	Recurring USDC billing plans
Donations	Public donation jars
Payouts	Batch or equal-split USDC payouts to multiple recipients
Treasury	Read your linked wallet addresses
Insights	Aggregate counts across your account
Collect checkout	Headless checkout for embedding in your own app (public-safe key)
Chat	Talk to the Veltro AI agent programmatically — it can call every tool above for you

:::info Free to start Every plan includes a monthly API call quota — Free starts at 100 calls/month, no card required. See pricing. :::

Next: Authentication → · Errors & rate limits →