Every endpoint, one command away.

The CLI ships in the Go module as a command. With Go installed, one line puts it on your PATH.

$ go install github.com/datasportsapi/datasportsapi-go/cmd/dsa@latest
$ dsa --help

dsa login asks for your key, checks it with a single call and keeps it in the operating system's keychain. --api-key and DATASPORTSAPI_API_KEY both win over the stored key, which suits CI.

$ dsa login    # prompts for the key, verifies it, stores it in the keychain
$ dsa logout   # removes it again

# CI: no login needed
$ DATASPORTSAPI_API_KEY=dsa_live_… dsa sports list

dsa <group> <action> exists for every endpoint in the docs. Path parameters are arguments, query parameters are flags with the API's own names.

$ dsa livescores list --sport football -o table
$ dsa fixtures lineups 480112
$ dsa leagues standings 17 --season 76986 -o csv > table.csv
$ dsa search query "real madrid" --fields id,type,name -o table

JSON envelope by default; JSON lines, an aligned table or CSV for the rows of data. --fields picks columns with dot paths and --all follows the pages for you.

$ dsa teams fixtures 42 --type recent --all -o jsonl

#  -o json    the { data, meta } envelope (default)
#  -o jsonl   one row of data per line
#  -o table   aligned columns for reading
#  -o csv     for spreadsheets
#  --fields id,home.name   choose columns
#  --all  --max-pages 5    walk the pages

Point dsa watch at one or more channels to print frames as JSON lines, or add --state to print the merged fixture after every change. Ticket, reconnect and replay are handled for you.

$ dsa watch livescores sport:tennis       # frames as JSON lines
$ dsa watch fixture:480112 --state        # merged fixture after each change

Channels, frames and replay rules are in the WebSocket guide. Without a Business key the stream answers 403 ws_not_available.

Errors go to stderr with the API's status and code, and the command exits non-zero, so shell scripts can stop on them. The same retry rule as the SDKs applies; --base-url or DATASPORTSAPI_BASE_URL points the CLI elsewhere.

$ dsa fixtures win-probability 480112 || echo "no access on this plan"

# options on every command
#  --api-key dsa_live_…       instead of the keychain
#  --base-url https://api.datasportsapi.com
#  --timeout 30s  --max-retries 2

Base URL resolution: the option or flag first, then DATASPORTSAPI_BASE_URL, then https://api.datasportsapi.com.