The rules API

Start here

What every source pays right now, and what each one depends on.

curl https://api.getventura.net/sources

Ask what a wallet is standing on

Positions of all three shapes — share tokens, lending deposits that are not wallet tokens, and held tokens priced at what selling them quotes — with what each depends on and which of your rules it breaks. Say where the holder lives, or every source fails the eligibility rule: each one names jurisdictions it is not available in.

curl "https://api.getventura.net/exposure/<wallet>?preset=conservative&jurisdiction=MX"

Price an allocation, with its reasons

Deterministic: dollars per source, why each one is there, every reason the others are not, what stays idle and why, and a timestamp for every fact it used. No optimiser, no scoring. Pass the wallet and what it already holds fills its sources' caps first — a limit is a share of everything you have, not of the money you are moving today, so the allocation tops up what is short instead of what is already full.

curl -X POST https://api.getventura.net/allocate/preview \
  -H 'Content-Type: application/json' \
  -d '{"amountUsd": 5000, "wallet": "<wallet>",
       "preset": "conservative", "jurisdiction": "MX"}'

Change a rule

Presets are bundles of rules, and every rule underneath is yours to set. An unknown key is refused rather than ignored, so a typo cannot quietly loosen a limit.

curl -X POST "https://api.getventura.net/rebalance/<wallet>?preset=max_yield&jurisdiction=MX" \
  -H 'Content-Type: application/json' \
  -d '{"rules": {"max_per_source_pct": 25, "max_exit_bps": 30}}'

Get something to sign

Each leg is built from the protocol's own API and simulated here before it is returned. You sign and send — through /rpc if you have no endpoint of your own. A leg that fails to build leaves the others signable, and the response carries both.

curl -X POST https://api.getventura.net/tx/build \
  -H 'Content-Type: application/json' \
  -d '{"wallet": "<wallet>", "jurisdiction": "MX",
       "legs": [{"source_id": "jupiter-lend-usdc", "action": "deposit", "amount": "100.00"}]}'

Typed

The client the app itself uses

@ventura/client is dependency-free and holds no keys. The consumer app is built on it and nothing else, so what you can do is exactly what the app does.

import { createClient } from "@ventura/client";

const ventura = createClient();
const me = { jurisdiction: "MX", accredited: false };

const { sources } = await ventura.sources();
const { exposure } = await ventura.exposure(wallet, me, { preset: "conservative" });
const { allocation } = await ventura.preview(5000, me, {
  preset: "balanced",
  rules: { max_per_source_pct: 25 },
});

// Unsigned and already simulated — you sign them.
const { legs } = await ventura.build(wallet, allocation.legs.map((leg) => ({
  source_id: leg.source_id,
  action: "deposit",
  amount: leg.amount_usd.toFixed(2),
})), me);