Documentation

Concepts, conventions, and API reference. Read what you need.

Reference pages

API reference

Bearer-authenticated REST for Pro accounts: endpoints, response envelopes, error codes, rate limits, and quickstarts in JavaScript and Python. Read the API reference.

Scenario simulator

What the simulator assumes, how the P10, P50, and P90 paths are generated, and how to read the cone without over-reading it. Read the scenario docs.

Getting started

Sign up for a free account at /auth/signup. Add a position from /positions, set an exit plan, and commit one rule so SellSignal checks it every day and pings you when a target hits. Analysis is there whenever you want a second opinion; the first 3 analyses every day are free.

Concepts

A plan is a multi-target ladder. Each target has a price, a weight, and a state (open, hit, or missed). When the spot drifts more than 5% from the price at generation, plans are marked stale and we recommend regenerating.

A commitment is one rule from that plan that you promise to follow. The daily check tests every committed target against the market once a day, and a decision ping asks you to sell, hold, or change the plan when one hits. Every answer you give, kept or broken, is written to your ledger.

Analysis is the supporting research: CoinGecko price and volume history over 7, 30, 90, and 365 days, 30-day OHLCV candles, on-chain top-holder concentration, global market metrics, the fear and greed index, DefiLlama protocol fundamentals, and CryptoCompare social sentiment, synthesized by a frontier LLM into an evidence-backed read. The read carries the model's own confidence field, 0 to 100, reporting how complete that data was and how well the signals agreed. It is not a probability and not a forecast.

API quickstart

Bearer-authenticated REST, Pro tier only. Generate a key in Settings.

curl -X POST https://www.sellsignal.app/api/v1/analysis \
  -H "Authorization: Bearer $SS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "exit_plan",
    "symbol": "BTC",
    "position": { "entryPrice": 62000, "quantity": 1.0 }
  }'

See the full API reference. Rate limit: 100 requests per minute per key.

Documentation | SellSignal