---
title: "Signals, newest first (what the caller may see)"
method: GET
path: "/v1/signals"
tags: ["signals"]
---

# Signals, newest first (what the caller may see)

`GET /v1/signals`

## Request

- Base URL: `https://api.lpsignal.app`
- URL: `https://api.lpsignal.app/v1/signals`
- Auth: one of:
  - none
  - HTTP bearer

Risk alerts are live for everyone; opportunities (net_apr, burst, hot_pool, launch) live with a paid key, else 24 h after they fire; smart_lp with Pro. Page newest-first with `before` (the `next` id), or by `offset` (with `total`) when sorting by return/outcome.

## Query parameters

- `kind` 'net_apr' | 'burst' | 'hot_pool' | 'launch' | 'tvl_outflow' | 'depeg' | 'smart_lp'
- `kinds` string
- `source` 'default' | 'rules' | 'subscribed'
- `before` string
- `sort` 'time' | 'return' | 'outcome'
- `order` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `signals` Signal[]
    - `id` string
    - `kind` 'net_apr' | 'burst' | 'hot_pool' | 'launch' | 'tvl_outflow' | 'depeg' | 'smart_lp'
    - `firedAt` string, date-time
    - `chain` 'ethereum' | 'bsc' | 'base' | 'arbitrum' | 'optimism' | 'polygon' | 'robinhood'
    - `pool` string
    - `pair` string
    - `dex` string
    - `fee` integer, nullable: fee tier in millionths; null for a dynamic-fee launch pool
    - `rangeBp` integer
    - `entryTick` integer
    - `tickLower` integer
    - `tickUpper` integer
    - `rule` object, nullable
      - `id` string
      - `name` string
    - `outcome` object, nullable
      - `status` 'done' | 'inexact'
      - `netApr` number, nullable
      - `feeApr` number, nullable
      - `ilApr` number, nullable
      - `evaluatedAt` string
  - `next` string, nullable
  - `total` integer

## Other responses

- `400`: invalid request
- `401`: missing or invalid API key

---

[API](https://skmtc.dev/lpsignal/apis/lpsignal-api.md) · [All operations](https://skmtc.dev/lpsignal/apis/lpsignal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lpsignal/apis/lpsignal-api/revisions/5fb8c06b1930?raw)
