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
}'
Related packages
| 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)
| File | Size | Uploaded | |
|---|---|---|---|
| tradia-0.1.1.tar.gz | 5.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|