---
title: "Add a Trade Detection subscription"
method: POST
path: "/snapTrade/tradeDetection/subscriptions"
tags: ["Experimental endpoints"]
---

# Add a Trade Detection subscription

`POST /snapTrade/tradeDetection/subscriptions`

Adds or restores a Trade Detection subscription for a connected brokerage account.
This endpoint requires `userId` and `userSecret` in addition to the partner signature.

## Query parameters

- `userId` string, required — SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.
- `userSecret` string, required — SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the [rotate user secret endpoint](/reference/Authentication/Authentication_resetSnapTradeUserSecret).

## Request body

- object
  - `account_id` string, uuid, required — Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
  - `check_interval_seconds` integer, required — How often the subscribed account should be checked for new trades. Must match an active Trade Detection plan.

## Response `200`

Restored an existing cancelled Trade Detection subscription

- TradeDetectionSubscription — An active Trade Detection subscription for a brokerage account.
  - `account_id` string, uuid, required — Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
  - `cost` string, required — Monthly subscription cost as a decimal string.
  - `check_interval_seconds` integer, required — How often the subscribed account is checked for new trades.

## Other responses

- `201` — Created a new Trade Detection subscription
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Feature not enabled
- `404` — Not Found
- `500` — Unexpected Error

---

[API](https://skmtc.net/passiv/apis/snaptrade.md) · [All operations](https://skmtc.net/passiv/apis/snaptrade/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/passiv/snaptrade/revisions/259274f1e845/schema)