---
title: "Large ERC-20 transfers observed on Base"
method: GET
path: "/v1/whales/signals"
tags: ["Market"]
---

# Large ERC-20 transfers observed on Base

`GET /v1/whales/signals`

## Request

- Base URL: `https://api.m2msentinel.com`
- URL: `https://api.m2msentinel.com/v1/whales/signals`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in header `PAYMENT-SIGNATURE`

Sourced from eth_getLogs over a bounded recent block range and valued using live pool prices. ERC-20 Transfer events only.

## Response `200`

Observed signals with the exact query window

- WhaleResponse
  - `status` string
  - `signals` object[]
    - `txHash` string
    - `blockNumber` integer
    - `logIndex` integer
    - `tokenAddress` string
    - `tokenSymbol` string
    - `sender` string
    - `receiver` string
    - `amount` number
    - `amountUsd` integer
    - `priceUsdUsedForValuation` number
  - `query` object
    - `fromBlock` integer
    - `toBlock` integer
    - `blocksScanned` integer
    - `minimumUsd` number
    - `tokensQueried` string[]
    - `tokensReadable` string[]
    - `degraded` boolean
  - `provenance` Provenance: Where a value came from and how old it is. Present on every data response.
    - `source` string
    - `endpoint` string
    - `trustLevel` 'HIGH_TRUST_PRIMARY' | 'QUORUM_PUBLIC' | 'DEGRADED_LOW_TRUST'
    - `agreement` integer: Providers that returned the selected result.
    - `sampled` integer: Providers that answered at all.
    - `retrievedAt` string, date-time
    - `ageSeconds` integer
    - `network` string
    - `note` string, nullable

## Other responses

- `401`: Missing or invalid credential, or a credential was supplied in the query string
- `402`: No credential supplied for a payable route, or the issuance-anchored 31-day credit allowance is exhausted
- `429`: A plan burst limit or bounded public/intent retry limit was exceeded
- `503`: The upstream data source is unavailable. No value is returned rather than an estimated one.

---

[API](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign.md) · [All operations](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign/llms.txt) · [OpenAPI document](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign/revisions/2dadd4e704fd?raw)