Skip to main content

Tradia

Agentic trading intelligence — trade proposals, risk checks, journals, portfolio/performance reports, market analysis, backtests, and public accountability updates.

Part of Talocode. Cloud product under /v1/tradia/*.

Package pip install tradia
Import from tradia import TradiaClient
Auth TALOCODE_API_KEY
Base URL TALOCODE_BASE_URL → https://api.talocode.site
npm @talocode/tradia
Repo github.com/talocode/tradia
License MIT

Why Tradia?

Retail and agentic traders need structured decision objects, not chat logs:

  • Propose trades with thesis / levels
  • Risk-check size and invalidation
  • Journal outcomes
  • Report portfolio & performance
  • Evaluate signals and markets
  • Export markdown / JSON for accountability

Credits apply on Talocode Cloud (see host pricing; examples historically ~15–25 credits for propose / evaluate / portfolio report).

Not financial advice. Software for analysis workflows only.


Install

pip install -U tradia

Python 3.10+, stdlib HTTP client.


Quickstart

import os
from tradia import TradiaClient

client = TradiaClient(api_key=os.environ["TALOCODE_API_KEY"])

print(client.health())

# High-level agent plan
plan = client.agent_plan(symbol="XAUUSD", strategy="trend_continuation")
print(plan)

# Explicit trade proposal
proposal = client.trade_propose(
    market="forex",
    symbol="XAUUSD",
    account_balance=10000,
    risk_percent=1,
    entry=1950,
    stop_loss=1940,
    take_profit=1970,
    strategy="trend_continuation",
)

# Risk, journal, reports
client.risk_check(**proposal.get("result", proposal) if isinstance(proposal, dict) else {})
client.trade_journal(symbol="XAUUSD", outcome="win", notes="Followed plan")
client.portfolio_report(account_balance=10000)
client.performance_analyze(period="30d")

# Market / signals
client.market_analyze(symbol="XAUUSD", timeframe="H1")
client.signal_evaluate(symbol="XAUUSD", direction="long")

# Accountability & exports
card = client.accountability_card(summary="Weekly review")
md = client.export_markdown(card)
js = client.export_json(card)

Keyword args are forwarded as JSON to the API (camelCase conversion may be applied by the host). Prefer the shapes documented on docs.talocode.site for your deployed version.

Environment

Variable Default
TALOCODE_API_KEY —
TALOCODE_BASE_URL https://api.talocode.site

Client methods

Method Purpose
health() Service health
agent_plan(**kwargs) End-to-end agent planning
market_analyze(**kwargs) Market context
signal_evaluate(**kwargs) Signal scoring
risk_check(**kwargs) Risk validation
trade_propose(**kwargs) Structured trade proposal
trade_journal(**kwargs) Journal entry
portfolio_report(**kwargs) Portfolio snapshot
performance_analyze(**kwargs) Performance analytics
public_update_generate(**kwargs) Public-facing update text
backtest_simulate(**kwargs) Lightweight simulation
accountability_card(**kwargs) Accountability card payload
export_markdown(data) / export_json(data) Export helpers

CLI

export TALOCODE_API_KEY=...

tradia health
tradia propose --data '{
  "symbol":"XAUUSD",
  "strategy":"trend_continuation",
  "accountBalance":10000,
  "riskPercent":1,
  "entry":1950,
  "stopLoss":1940,
  "takeProfit":1970
}'

Package Role
tradia This package
talocode Unified cloud client
talocode-tera General LLM capabilities
talocode-searchlane News / research for macro context

Talocode ecosystem

Project Role
Tradia Trading intelligence (this product)
StackLane Cloud keys & credits
Tera AI capabilities
SignalLane Growth / signal products (sibling)
SearchLane Web research

docs.talocode.site · github.com/talocode

License

MIT © Talocode

Metadata

Release files for tradia 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tradia 0.1.1
File Size Uploaded
tradia-0.1.1.tar.gz 5.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tradia 0.1.1
File Interpreter ABI Platform
tradia-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 11.5 kB

Release files / tradia-0.1.1.tar.gz

Download URL tradia-0.1.1.tar.gz
Size 5.5 kB
Tags Source
SHA-256 checksum
How to use checksums
87fd9839c44516931b0f82d2ff90de567e78dc8d87ba1ef6e1cfb67f1c516cd3
BLAKE2b-256 checksum
How to use checksums
6fe94d5b2efca04ed7426186e1ebb80f79dde2354ae944c3c19368b421b71115
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / tradia-0.1.1-py3-none-any.whl

Download URL tradia-0.1.1-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f6a41e3da58f4e809f63b601a191bd2856fa92fea403c4501b5fea1eb4e143e1
BLAKE2b-256 checksum
How to use checksums
562292b0c40041d37d81aa7a5c22eb9ebf961081302938564c5a5794ec8ecd7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page