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_URLhttps://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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tradia-0.1.1.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tradia-0.1.1-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file tradia-0.1.1.tar.gz.

File metadata

  • Download URL: tradia-0.1.1.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for tradia-0.1.1.tar.gz
Algorithm Hash digest
SHA256 87fd9839c44516931b0f82d2ff90de567e78dc8d87ba1ef6e1cfb67f1c516cd3
MD5 bdbfdf8fc79ba923dc8c91c8647560f5
BLAKE2b-256 6fe94d5b2efca04ed7426186e1ebb80f79dde2354ae944c3c19368b421b71115

See more details on using hashes here.

File details

Details for the file tradia-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: tradia-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for tradia-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f6a41e3da58f4e809f63b601a191bd2856fa92fea403c4501b5fea1eb4e143e1
MD5 633066d878e0bd661f2144c4a19b96eb
BLAKE2b-256 562292b0c40041d37d81aa7a5c22eb9ebf961081302938564c5a5794ec8ecd7d

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 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