> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Insider Selling API

> Composite scores flagging shortable coins with cross-venue negative funding, OI, basis, CVD, and supporting wallet context.

Insider Selling exposes a composite 0-10 hedge-pressure score per coin built from cross-venue negative funding, funding persistence, open interest, basis, CVD, sell-side flow, and supporting wallet/supply context. Basis and CVD exist only for the futures-covered majors, so most altcoin scores carry them null and are lower bounds (read `signal_coverage`). High scores indicate hedge-like short pressure that deserves closer due diligence.

The signal updates every 30 minutes and is gated to coins where the score is strictly greater than zero, so an empty list means no qualifying pressure right now.

***

## Get insider selling data

`GET /v1/insider-selling/data`

Returns coins ranked by their composite insider selling pressure score, descending.

### Query parameters

**limit** `integer`

Maximum number of coins to return. `1` to `500`. Default `100`.

**min\_score** `number`

Filter to coins scoring at or above this threshold. `0` to `10`. Default `0`.

**coin** `string`

One coin by its CoinGecko id (e.g. `pepe`): its row exactly as the scorer wrote it, whatever its score. A coin that stopped qualifying answers `score: null` with its sub-scores and phase cleared; an id with no row answers an empty list. `limit` and `min_score` do not apply.

### Response fields

**coins** `array`

Array of scored coins, sorted by `score` descending.

**coins\[].coin\_id** `string`

Canonical coin slug.

**coins\[].symbol** `string`

Ticker symbol.

**coins\[].name** `string`

Display name.

**coins\[].score** `number | null`

Composite pressure score from `0` to `10`. Higher means stronger alignment across shortability, funding, market confirmation, flow, and supporting wallet/supply signals. If funding, price or derivatives inputs are missing, the score is a conservative lower bound rather than a measured neutral reading; missing on-chain inputs are left out and the remaining weights re-normalize, so that gap can move the score either way. `null` only on a `coin` request for a coin that stopped qualifying.

**coins\[].signal\_coverage** `number`

Weighted input completeness from `0` to `1` across funding, price, derivatives, and on-chain groups (`0.81` is 81%).

**coins\[].signal\_coverage\_status** `string`

`full` when every signal group is observed, `partial` at a `signal_coverage` of `0.5` or more, otherwise `limited`. Compare scores only with their coverage in view.

**coins\[].incomplete\_signal\_groups** `string[]`

Signal families with one or more unavailable inputs.

**coins\[].score\_interpretation** `string`

`lower-bound-partial-inputs` when a funding, price or derivatives input is missing (it scores as zero), otherwise `fully-observed`. A row missing only on-chain inputs reads `fully-observed`: those are left out and the weights re-normalize, and the gap shows in `incomplete_signal_groups`.

**coins\[].avg\_funding\_72h** `number`

Average funding rate across exchanges over the trailing 72 hours, expressed as a decimal (e.g. `-0.00012` is -0.012%).

**coins\[].funding\_magnitude** `number`

Sub-score reflecting the absolute size of negative funding.

**coins\[].funding\_persistence** `number`

Sub-score reflecting how consistently the funding stays negative.

**coins\[].wallet\_concentration** `number | null`

Supporting sub-score `[0, 1]` from the top-10 holder share of supply. `null` when no on-chain holder data is available.

**coins\[].holder\_quality\_deterioration** `number | null`

Sub-score `[0, 1]` summarizing fragile holder base, top-heavy supply, liquidity weakness, and contract/security context. `null` when none of those inputs is observed.

**coins\[].distribution\_pressure** `number`

Sub-score `[0, 1]` summarizing direct wallet/flow pressure and derivatives-confirmed selling pressure.

**coins\[].market\_confirmation** `number`

Sub-score `[0, 1]` summarizing funding, OI, basis, CVD, price path, and persistence confirmation.

**coins\[].manipulation\_phase** `string`

Current phase label such as `active-hedge-pressure`, `persistent-shorting`, or `supply-risk-supported`.

**coins\[].consecutive\_negative\_days** `integer`

Number of consecutive trading days with negative average funding.

**coins\[].return\_24h** `number`

Trailing 24h price return as a fraction (`-0.0321` is -3.21%).

**coins\[].return\_7d** `number`

Trailing 7d price return as a fraction.

**coins\[].top10\_holders\_share** `number | null`

Share of supply held by the top 10 holders, from `0` to `1`; `null` when unknown. Contract-held supply (team treasuries, vesting) and exchange hot wallets count as holders.

**coins\[].volume\_to\_liquidity\_24h** `number | null`

24h DEX volume divided by available liquidity. High values can indicate fragile churn.

**coins\[].holders\_change** `number | null`

Holder-count change since the previous successful scoring run, expressed as a decimal.

**coins\[].top10\_holders\_share\_change** `number | null`

Change in `top10_holders_share` since the previous successful scoring run: the difference of the two shares (`0.012` is a share up from `0.300` to `0.312`), not a relative change.

**coins\[].signal\_start\_date** `string`

ISO 8601 timestamp of when the negative funding streak began.

**coins\[].updated\_at** `string`

ISO 8601 timestamp of the most recent score recomputation.

**count** `integer`

Number of rows in `coins`.

**data\_as\_of** `string | null`

Latest `updated_at` timestamp represented by the returned rows, in ISO 8601 format. `null` when no valid score timestamp is available.

**stale** `boolean`

`true` when `data_as_of` is missing, invalid, or more than 1 hour old.

**freshness\_sla\_seconds** `integer`

Maximum supported score age in seconds. Currently `3600` (1 hour).

**description** `string`

Plain-language summary of the signal for client display.

**signal** `object`

Methodology metadata: `methodology`, `update_frequency`, and the list of `exchanges` monitored.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/insider-selling/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d limit=20 \
  -d min_score=4
```

```ts TypeScript theme={null}
const params = new URLSearchParams({ limit: '20', min_score: '4' })
const res = await fetch(
  `https://www.sharpe.ai/api/v1/insider-selling/data?${params}`,
  { headers: { Authorization: 'Bearer sk_live_your_key_here' } },
)
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/insider-selling/data",
    params={"limit": 20, "min_score": 4},
    headers={"Authorization": "Bearer sk_live_your_key_here"},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "data": {
    "coins": [
      {
        "coin_id": "example-token",
        "symbol": "EXMP",
        "name": "Example Token",
        "score": 8.4,
        "signal_coverage": 0.91,
        "signal_coverage_status": "partial",
        "incomplete_signal_groups": ["derivatives"],
        "score_interpretation": "lower-bound-partial-inputs",
        "avg_funding_72h": -0.00018,
        "funding_magnitude": 0.79,
        "funding_persistence": 0.88,
        "wallet_concentration": 0.91,
        "holder_quality_deterioration": 0.62,
        "distribution_pressure": 0.73,
        "market_confirmation": 0.68,
        "manipulation_phase": "active-hedge-pressure",
        "consecutive_negative_days": 12,
        "return_24h": -0.0321,
        "return_7d": -0.114,
        "signal_start_date": "2026-04-14T00:00:00Z",
        "updated_at": "2026-04-26T07:00:00Z"
      }
    ],
    "count": 1,
    "data_as_of": "2026-04-26T07:00:00Z",
    "stale": false,
    "freshness_sla_seconds": 3600,
    "description": "Insider hedge-pressure scores based on cross-venue negative funding, open interest, basis, CVD, sell-side flow, and wallet/supply context.",
    "signal": {
      "methodology": "Composite 0-10 pressure score built around observable short-hedge behavior. Negative cross-venue funding is required; OI, basis, CVD, sell-side flow, and wallet/supply context raise conviction. Exact weighting is proprietary to reduce gaming.",
      "update_frequency": "every 30 minutes",
      "exchanges": [
        "Binance", "Bybit", "OKX", "Gate.io", "Bitget", "Hyperliquid",
        "Deribit", "HTX", "BingX", "KuCoin", "MEXC"
      ]
    }
  },
  "meta": {
    "request_id": "req_insider_abc123",
    "timestamp": "2026-04-26T07:00:05Z",
    "elapsed_ms": 12
  }
}
```

The response header `X-Sharpe-Data-State` is `ok` or `stale` using the same 1-hour SLA. Stale rows remain available with HTTP `200`, but clients should treat them as historical context rather than a current trading signal. A database or query failure answers `503` (`service_unavailable`, `Retry-After: 30`) in the normal API error envelope.

***

## How the score is built

The score is a composite risk model capped at 10. It does not depend on stated unlock calendars, because unlock timing and size can be incomplete or adversarial. Instead, it requires observable short-hedge pressure and then uses multiple signal families:

* **Hedge pressure:** negative cross-venue funding, funding persistence, and exchange breadth.
* **Market confirmation:** open interest, basis, true taker-flow/CVD, short crowding, and price path.
* **Sell-side flow:** DEX flow imbalance and weakening liquidity context.
* **Supply context:** top-10 holder share, holder count, liquidity depth, and mint/freeze authority flags.

Wallet and supply signals raise conviction, but they do not independently create an insider-selling signal. We publish the signal families and validation process, but not the exact formula, weights, or thresholds. That keeps the leaderboard harder to game while still making the approach understandable to users. Coins with `score == 0` are filtered out of the response, so the `coins` array is always meaningfully populated when returned.

Unavailable derivatives, price and funding inputs contribute no risk. This intentionally keeps a partial-input score conservative, but it also means the number is a lower bound rather than directly comparable with a fully observed row. Unavailable on-chain inputs are left out instead and the remaining weights re-normalize, so an on-chain gap can move the score either way. Always inspect `signal_coverage`, `signal_coverage_status`, and `incomplete_signal_groups` alongside `score`.

Borrow and OTC deal details are treated as optional context, not required inputs. Public borrow data is inconsistent across venues and private OTC hedges are intentionally opaque, so the production score prioritizes continuously observable perp behavior.

[See the pump & dump signal](https://docs.sharpe.ai/pump-dump.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.