Get Signal History

Retrieve past trading signals to research historical performance, backtest strategies, or audit agent decisions. Results are returned in reverse chronological order and support cursor-based pagination.

Endpoint

GET /v1/signals/history

Query parameters

integer

required

Chain ID to filter historical signals. Use 8453 for Base or 56 for BNB Chain.

string

Optional token contract address to scope the history to a single token.

integer

Start of the time range as a Unix timestamp.

integer

End of the time range as a Unix timestamp.

integer

default:"20"

Number of signals per page. Maximum is 100.

string

Opaque cursor from a previous response to fetch the next page.

Example request

curl -H "Authorization: Bearer $ELUUP_API_KEY" \
  "https://api.eluup.ai/v1/signals/history?chain=8453&token_address=0x532f27101965dd16442E59d40670FaF5eBB142E4&from=1715200000&to=1715799999&limit=5"

Response

array

Array of historical signal objects.

string

Unique signal identifier.

string

Token contract address.

string

Token symbol.

integer

Chain ID.

string

Either BUY or SELL.

float

Model confidence from 0.0 to 1.0.

float

Estimated token price in USD at the time of the signal.

integer

Unix timestamp when the signal was generated.

string

Cursor for the next page, omitted if there are no more results.

Example response

{
  "data": [
    {
      "id": "sig_9aBc2DeF8Gh",
      "token_address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
      "token_symbol": "BRETT",
      "chain_id": 8453,
      "direction": "SELL",
      "confidence": 0.79,
      "price_usd": 0.0381,
      "timestamp": 1715601000
    },
    {
      "id": "sig_3xYz1WvQ5Mn",
      "token_address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
      "token_symbol": "BRETT",
      "chain_id": 8453,
      "direction": "BUY",
      "confidence": 0.91,
      "price_usd": 0.0295,
      "timestamp": 1715587200
    }
  ],
  "next_cursor": "eyJpZCI6InNpZ18zeFl6MVd2UTVibiIsInRzIjoxNzE1NTg3MjAwfQ"
}

Overview

Signals

Agents

Trades

Wallets

Account

Get Signal History

Endpoint

Query parameters

Example request

Response

Example response

​Endpoint

​Query parameters

​Example request

​Response

​Example response

Endpoint

Query parameters

Example request

Response

Example response