Quickstart

1. Create an API key

Sign in to the Desk Console, open API keys, and click Create key. The full key is shown once — copy it somewhere safe. It looks like:

tzk_b083b68c06cf1330c0fd9eaa93b33c1055d31b66424fc5a25b2897b90a7842f5

2. Send a signal

curl -X POST https://api.traderz.dev/v1/signals \
  -H "Authorization: Bearer $TRADERZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "source": "binance",
        "type": "crypto",
        "symbol": "ETH/USDT",
        "side": "open",
        "direction": "long",
        "price": 3450.5
      }'

A successful call returns 201 Created:

{ "id": "019ebac868e4b0d9db93cc0daccca63d", "received_at": 1781250156772, "deduped": false }

3. Make it idempotent (recommended)

Include a client_signal_id so safe retries never create duplicates:

  -d '{ "source":"binance", "type":"crypto", "symbol":"ETH/USDT", "side":"open",
        "client_signal_id":"trade-8842-open" }'

Re-sending the same client_signal_id returns 200 OK with "deduped": true and the original signal’s id. See Idempotency.

4. Rotate or revoke

Create additional keys (e.g. one per bot) and revoke any key from the console at any time — revoked keys stop authenticating immediately.