Get Large Transactions
1. Overview & Typical Use
Returns large transactions for a specified account filtered by token, type, and amount, supporting filtering by transfer type (incoming, outgoing, swap, liquidity operations, etc.).
- Typical use: large transaction monitoring, DeFi operation tracking, fund movement alerts.
- When not to use: to query fund flow distribution, use “Get Account Transfer Amount Distribution”; to query chain-wide stablecoin large transactions, use “Get Stablecoin Large Transactions”.
2. Endpoint & Authentication
GET /api/deep/account/token/bigAmount
For Base URL and authentication, see Common Network & Authentication.
This endpoint requires an API Key; calls without a Key return 401.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Account address to query |
relatedToken | string | Yes | — | Related token address (Base58) |
types | string | Yes | — | Transfer types (comma-separated): 0 all, 1 incoming, 2 outgoing, 3 swap, 4 add liquidity, 5 remove liquidity, 6 deposit, 7 borrow, 8 repay, 9 withdraw |
txUsd | string | No | — | USD amount range, comma-separated, e.g. 1,10 |
txAmount | string | No | — | Token quantity range, comma-separated, e.g. 100,10000 |
relatedAddress | string | No | — | Filter by related address |
startTime | integer | No | — | Start time (Unix timestamp in seconds), maximum interval: 6 months |
endTime | integer | No | — | End time (Unix timestamp in seconds), maximum interval: 6 months |
limit | integer | No | 100 | Number of results, maximum 100 |
sortBy | string | No | time | Sort field: time, amount, usd |
asc | boolean | No | false | Whether to sort ascending |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total number of matches | — |
code | integer | Required | Status code; 0 means success | — |
data | array | Required | Transaction list | — |
contractMap | object | Optional | Address → whether the address is a contract (boolean) | — |
contractInfo | object | Optional | Involved contract address → label info (value schema below) | — |
chartRefreshTime | integer | Optional | Chart data refresh timestamp; code-derived from Greason v5 scan (reproducing sample pending) | Unix seconds |
contractInfo[<addr>] object schema (8 fields):
| Field | Type | Required | Description |
|---|---|---|---|
tag1 | string | Required | Primary label (project name / contract name / exchange name) |
tag1Url | string | Required | URL of the primary label (may be an empty string) |
name | string | Required | Formal contract / project name |
isToken | boolean | Required | Whether it is a token contract (true / false) |
vip | boolean | Required | Whether it is a VIP entity (true / false) |
risk | boolean | string | Required | Risk label; most endpoints return boolean, some return a string risk type (blacklist / fraud, etc.) |
publicTagDesc | string | Required | Public label description; empty string for most accounts |
publicTag | string | Optional | Public label (e.g. "USDT Token" / "Binance"); returned only for well-known entities or certain endpoints |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
amount | number | Required | Transaction quantity | Token units |
amountUsd | number | Required | Transaction amount | USD |
contractAddress | string | Required | Token contract address | — |
dateTime | integer | Required | Transaction time | Millisecond timestamp |
fromAddress | string | Required | Sender address | — |
fromAddressTag | string | Optional | Sender label | — |
toAddress | string | Required | Recipient address | — |
toAddressTag | string | Optional | Recipient label | — |
hash | string | Required | Transaction hash | — |
transferType | string | Required | Transfer type code | — |
externalContractAddress | string | Optional | External contract address (for DeFi operations) | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- API Key Required: returns 401 if not provided.
- Missing required parameters: when
address,relatedToken, ortypesis absent, empty data is returned without an error. - Time range exceeds 6 months: silently truncated.
- Empty result is not an error: no matches returns
200+data: []as a normal response.
Last updated on: