The rules API.Every call the app makes.

1. 01Start here

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

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

2. 02Ask 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"

3. 03Price 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"}'

4. 04Change 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}}'

5. 05Get 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"}]}'

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);