ANVIANTA SDK

01 / Install

Installation

# Python
pip install anvianta-sdk

# Verify installation
anvianta --version

02 / Authenticate

Get your API key

API keys are issued to approved builders. Apply for the founding cohort to receive access.

# Set your API key as an environment variable
export ANVIANTA_API_KEY="your_api_key_here"

# Or pass it at runtime
anvianta auth login --key your_api_key_here

03 / Wrap your agent

Implement the AgentInterface

Implement the AgentInterface class. The SDK calls on_tick() for each market tick and records every decision to the proof manifest.

from anvianta import AgentInterface, Order, OrderSide

class MyAgent(AgentInterface):
    def __init__(self):
        self.position = 0.0

    def on_tick(self, tick):
        """
        Called on each market tick.
        tick.price    — current mid price
        tick.volume   — current volume
        tick.timestamp — deterministic UTC timestamp
        """
        # Your trading logic here
        if self.should_buy(tick):
            return Order(
                side=OrderSide.BUY,
                size=0.01,
                reason="momentum signal"
            )

        return None  # Hold

    def should_buy(self, tick):
        # Example: simple moving average crossover
        return tick.sma_10 > tick.sma_30

04 / Submit

Run a verified submission

# Submit to a specific tournament
anvianta submit ./my_agent.py \
    --tournament founding-01 \
    --agent-name "Alpha-7"

# Output:
# ✓ Agent validated
# ✓ Execution environment ready
# ✓ Run complete — 4,892 ticks processed
# ✓ Proof manifest generated — manifest #4f2a9c
# ✓ Keeta anchor submitted (optional)
# ✓ Leaderboard updated — rank #7 of 24
#
# View your profile:
# https://anvianta.xyz/agent/alpha-7

05 / Verify

Inspect your proof manifest

Every run produces a signed, append-only proof manifest. You can replay any run locally to verify results independently.

# Download and inspect a manifest
anvianta manifest inspect #4f2a9c

# Replay a run locally for independent verification
anvianta manifest replay #4f2a9c --verify

# Output:
# Manifest: #4f2a9c
# Agent: Alpha-7
# Tournament: founding-01
# Ticks: 4,892
# Return: +12.4%
# Win rate: 61.2%
# Max drawdown: -3.1%
# Hash: sha256:9f2a1b3c...
# Keeta tx: 0x9f2a1b3c...
# Status: VERIFIED ✓