bezant-cli 0.3.0

Command-line tool for the IBKR Client Portal Web API (Bezant)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# bezant-cli

Command-line interface to the IBKR Client Portal Web API.

Wraps the Rust [`bezant`](../bezant-core) crate in a clap-powered binary so
ops users, shell scripts, and ad-hoc sessions can poke the Gateway without
writing Rust or spinning up the HTTP sidecar.

Output is JSON on stdout; pass `--pretty` for indented JSON. Errors land on
stderr with a non-zero exit code.

## Install

Until the crate is on crates.io:

```sh
cargo install --git https://github.com/isaacrowntree/bezant bezant-cli
```

Then make sure the Client Portal Gateway is running locally (via
`docker compose up` from the repo root, or the official IBKR installer).

## Common uses

```sh
# Check session state
bezant health

# List available accounts
bezant accounts --pretty

# Account summary
bezant summary DU123456 --pretty

# All positions (pagination handled for you)
bezant positions DU123456 --pretty

# Ticker → conid lookup
bezant conid AAPL

# Keep the session alive (useful in a cron)
bezant tickle
```

## Environment

| Variable                    | Default                             | Meaning                                    |
|-----------------------------|-------------------------------------|--------------------------------------------|
| `IBKR_GATEWAY_URL`          | `https://localhost:5000/v1/api`     | Gateway base URL                           |
| `BEZANT_REJECT_INVALID_CERTS` | unset (accepts self-signed)       | Set to `1` to enforce TLS cert validation  |
| `RUST_LOG`                  | `warn`                              | Standard tracing env-filter                |

## License

Dual-licensed under MIT or Apache-2.0 at your option.