Skip to content
VestiarionDocs

Overview

Overview

What Vestiarion is, and what its API and webhooks give an integration.

Vestiarion is an autonomous treasury agent for stablecoin businesses on Arc. It pays invoices in USDC or EURC, and contractor milestones in USDC, through Circle, within guardrails: it never pays a high-risk counterparty, never exceeds a payment limit, and keeps a liquidity buffer. Every decision it makes is recorded, with its reasoning, in an Ed25519-signed, hash-chained ledger. The API gives your integration read access to one workspace: its ledger, invoices, counterparties, milestones, treasury and insights. Webhooks push each new ledger entry to your endpoint as it is appended.

Try it in 5 minutes

Sample data, the agent deciding, a payment you approve, and the signed ledger, with no wallet or keys.

Quickstart

Create an API key and make your first two requests.

When the model and the policy disagree

Production decisions beside the written policy's answer to the same facts: where they differed in the first week, and where code refused the model.

Go live on Arc testnet

Using the app: create the wallets, fund them and take the agent live.

API reference

Every v1 endpoint with its parameters, response and errors.

Webhooks

Each ledger entry pushed to your HTTPS endpoint, signed.

AI integration

Markdown views, llms.txt and the OpenAPI document for coding agents.

Changelog

Changes to the API and webhooks, newest first.

What you can build

  • A bot that reports held payments. List invoices and milestones with status=held, and post each one with its agentReasoning: the agent's own account of why it did not pay.
  • An accounting sync. Page through invoices with direction=payable or direction=receivable, and copy each one's status, amount, counterparty, settlement time and txHash into your books.
  • An audit mirror. Copy the ledger once, keep it current with webhooks, and check each entry's signature yourself. Verify the ledger to compare your result with Vestiarion's.
  • An invoice feed. Add invoices from your own system, such as an accounting tool or a billing script, and let the agent decide each one.
  • A treasury dashboard. Show the treasury's account balances, reserve position, obligations due within 7 and 14 days and the latest liquidity forecast. Read status first, so the dashboard shows whether payments are live or simulated.

What the API is

Every endpoint is under https://www.vestiarion.xyz/api/v1. Most read; four add records, with a key given write access: a counterparty, an invoice, a milestone or a payee link. No request moves money, approves a payment, or changes or removes a record: the agent decides what is added as it decides anything typed into the console. Each request carries a workspace API key and reaches only that key's workspace. The endpoint overview lists every endpoint, and data delivery methods compares pulling with the API to receiving webhooks.