Build the bot. Keep the key.

From key to first call in a minute.

Create a key in the app (API tab), inject it from your secret manager into the process environment, and authenticate every request with a bearer header. Your key is a secret: send it only over HTTPS in the header, never in a URL or query string.

# 1. Inject LOSURIA_API_KEY from your secret manager for this process only.
#    Do not write it to a plaintext file or commit it.
      # Set LOSURIA_API_KEY in this process from your secret manager before running the bot.

# 2. install the dependencies for reads, Solana relay, and EVM signing
pip install requests web3 pynacl base58

# 3. run the read-only demo — it moves nothing
python3 losuria_bot.py

import os, requests

KEY  = os.environ["LOSURIA_API_KEY"]
BASE = "https://app.losuria.com"
H    = {"Authorization": "Bearer " + KEY}

st = requests.get(BASE + "/api/v1/status", headers=H).json()
print(st["key_id"], st.get("tier"))

A local command line for the same signed rails.

Install the current LOSURIA CLI v0.6.0 for read-only API diagnostics, unsigned Solana builder preparation, bounded bot plans and offline contract-call inspection. The verified release includes the canonical bot entry point, so losuria bot works after the one-line install. It uses the same owner-bound platform contract as the app; it never stores a wallet key, signs a transaction or broadcasts one.

# HTTPS bootstraps; the installer verifies the signed release before install.
curl -fsSL https://losuria.com/losuria-install.sh | sh
losuria
losuria --version
# Optional: enter the key once at a hidden prompt.
losuria api configure
losuria api doctor

You sign. We pick the block.

The current execution path holds no Wallet-owner key. There is no API session to arm or budget cap to configure: each amount is inside its Owner signature. An EVM executor allowance may be reusable, but cannot move value without one of those signatures.

Intelligence: facts you can build on.

Opens on an active Pro or Whale plan. It serves what launched and lets you inspect your own activity — and read handlers cannot move value: they hold no wallet signer or session key. Judgement and signing stay in your own code. The paid Intelligence allowance is 2,000 requests per UTC day on Pro and 20,000 on Whale; reading its meter does not consume that allowance. Signed orders, automation and relays remain Whale-gated; their execution and safety lanes are separate, so an Intelligence meter cannot block cancellation, recovery or legitimate execution. Per-key and per-route anti-abuse buckets protect every lane independently. Money-moving access remains subject to the documented owner-signature, fee and safety checks. For clarity, money-moving access will be enabled only when the documented safety requirements are met. The launch proof page shows recorded launches with their deployment transaction, without signup.

The full surface.

Every endpoint is authenticated with your bearer key. Bodies and responses are JSON. Base URL: https://app.losuria.com.

Strategies, copy-paste.

These use the Losuria client from the starter bot. Tune the filters, sizes and RPC to your own strategy — they are starting points, not a turnkey money machine.

Solana swap · explicit amount, owner-wallet signature

For a direct swap, build one fee-bearing transaction for an explicit mint and amount, sign it locally, and let LOSURIA verify the fee before relay. For background execution, create a conditional on-chain order whose amount, deadlines, pool protections and exits are fixed by the same owner signature.

Non-custodial swap · sign locally, LOSURIA relays

LOSURIA builds the fee-bearing transaction, your bot signs it locally, and LOSURIA verifies the 1% before broadcasting. No cap, no custody.

WSOL = "So11111111111111111111111111111111111111112"
USDC = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
MIN_OUT = int(os.environ["LOSURIA_SOL_MIN_OUT"])  # from your RPC quote
POOL = os.environ["LOSURIA_SOL_POOL"]  # from the same RPC quote

ok, res = lo.swap_solana(WSOL, USDC, POOL, amount=2_000_000, min_out_floor=MIN_OUT, slippage_bps=100)
print("relayed" if ok else "rejected", res)

First-block EVM on your BYO chain

import os

token = os.environ["LOSURIA_BASE_TOKEN"]
amount = int(os.environ.get("LOSURIA_AMOUNT_WEI", "2000000000000000"))
code, result = lo.snipe("base", token, amount)
print(result)  # the owner signature is bounded to this token and amount

Owner-signed orders

import os

token = os.environ["LOSURIA_BASE_TOKEN"]
amount = int(os.environ.get("LOSURIA_AMOUNT_WEI", "2000000000000000"))
code, made = lo.snipe("base", token, amount)
if code == 200:
    print("signed order accepted", made)
else:
    print("refused", made)

Predictable under load. Safe under failure.

The execution API uses a per-key anti-abuse bucket: 25 requests/second, burst 300. Independent edge ceilings apply by route: reads 250/600, quotes 50/100, credential issuance 1/30, signed submissions 2/20, and safety 10/120 (steady RPS/burst). GET /api/v1/status returns the current per-key budget as rate_limit. These are anti-abuse controls, not billing; safety actions and order cancellation remain outside commercial execution usage.

code, result = lo.snipe("base", token, amount)
if code == 200:
    print("signed order accepted", result)
elif code == 429:
    # Do not resend blindly. Check the authoritative order state first.
    print("orders", lo.orders())
else:
    print("failed", result.get("error"), result.get("error_id"))

One percent, enforced, not negotiable.

One file from first call to first strategy.