On-chain Transfers

Retrieves historical transfers to/from exchanges on EVM compatible chains

All parameters are optional. Supported Exchanges:

• All exchanges available at /exchanges

Historical Exchange Transfers on major CEXes

GET https://api.coinact.gg/v1/exchange-transfer-history

Query Parameters

Name	Type	Description
symbol	String	Get liquidations for a specific cryptocurrency eg: BTC
exchange	String	see endpoint /exchanges default: ALL (every exchanges)
side	Integer	1 -> Withdrawal 2 -> Deposit
amountUsd	Float	Get transfers superior to a certain USD amount. eg: 50000.5
start	UNIX Timestamp (s)	Get transfers on a given period
end	UNIX Timestamp (s)	Get transfers on a given period
page	Integer	id of the page you want to query (default=1)
limit	Integer	Number of transfers to return (default:200 ; max: 200)

Headers

Name	Type	Description
x-api-key*	String	Your API Key

200: OK A list of transfers

```json
[
    {
        "symbol": "RNDR",
        "side": 1,
        "exchangeLabel": "OKX",
        "exchangeId": 4096,
        "fromEntity": "OKX",
        "fromLabel": "",
        "fromAddress": "0x6cC5F688a315f3dC28A7781717a9A798a59fDA7b",
        "toEntity": "0x20A3A4AE2aACB8BbCFd89dc71280DD18cD9a0Cb4",
        "toLabel": "",
        "toAddress": "0x20A3A4AE2aACB8BbCFd89dc71280DD18cD9a0Cb4",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0x12582869106852737b87d82bc36cd58f6646c48c6788acdd03e99568accfe27c",
        "chain": "Ethereum",
        "amountUsd": 33573.94,
        "amount": 6557.41,
        "threshold": 0,
        "ts": "2024-02-13T10:15:11"
    },
    {
        "symbol": "PENDLE",
        "side": 1,
        "exchangeLabel": "BINANCE",
        "exchangeId": 1,
        "fromEntity": "BINANCE",
        "fromLabel": "",
        "fromAddress": "0xB38e8c17e38363aF6EbdCb3dAE12e0243582891D",
        "toEntity": "0xb835AF52422a14C917d4b37b36c9a73d24770261",
        "toLabel": "",
        "toAddress": "0xb835AF52422a14C917d4b37b36c9a73d24770261",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0x6b8acee1a04b85f31e64f7c6e54906e1755ec35c010c46c43cc651a11a6490d6",
        "chain": "Arbitrum",
        "amountUsd": 44933.68,
        "amount": 14264.66,
        "threshold": 1,
        "ts": "2024-02-13T10:15:04"
    },
    {
        "symbol": "MNT",
        "side": 1,
        "exchangeLabel": "BYBIT",
        "exchangeId": 16,
        "fromEntity": "BYBIT",
        "fromLabel": "",
        "fromAddress": "0xf89d7b9c864f589bbF53a82105107622B35EaA40",
        "toEntity": "0x83a7196272af57AEb71d6EEe57f70F13eFD2310C",
        "toLabel": "",
        "toAddress": "0x83a7196272af57AEb71d6EEe57f70F13eFD2310C",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0x847fc22d24f774f1745d6385bd631a9a6682710e31d5c43e1882695e31fbca84",
        "chain": "Ethereum",
        "amountUsd": 10125.08,
        "amount": 14048.038,
        "threshold": 0,
        "ts": "2024-02-13T10:14:47"
    },
    {
        "symbol": "XCAD",
        "side": 2,
        "exchangeLabel": "BYBIT",
        "exchangeId": 16,
        "fromEntity": "0x70D9b9aC82B19edf81AF75F3A413ba600C22a766",
        "fromLabel": "",
        "fromAddress": "0x70D9b9aC82B19edf81AF75F3A413ba600C22a766",
        "toEntity": "BYBIT",
        "toLabel": "",
        "toAddress": "0xf89d7b9c864f589bbF53a82105107622B35EaA40",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0x3548ca50cca1aa89b07eab6df043794aa328cb248371c996f569f1e8caa54b4b",
        "chain": "Ethereum",
        "amountUsd": 858000.0,
        "amount": 650000.0,
        "threshold": 4,
        "ts": "2024-02-13T10:14:47"
    },
    {
        "symbol": "OM",
        "side": 1,
        "exchangeLabel": "BINANCE",
        "exchangeId": 1,
        "fromEntity": "BINANCE",
        "fromLabel": "",
        "fromAddress": "0x21a31Ee1afC51d94C2eFcCAa2092aD1028285549",
        "toEntity": "0x17f844fE99D90e03659952b70788f33df8435bB3",
        "toLabel": "",
        "toAddress": "0x17f844fE99D90e03659952b70788f33df8435bB3",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0xd88ba4786f8ae46e4809b9b6a0cebb9a01aabff25c17378cf5a3e7a3a1bd836f",
        "chain": "Ethereum",
        "amountUsd": 590849.7,
        "amount": 1951067.924,
        "threshold": 4,
        "ts": "2024-02-13T10:14:35"
    },
    {
        "symbol": "MATIC",
        "side": 2,
        "exchangeLabel": "BYBIT",
        "exchangeId": 16,
        "fromEntity": "0xc5a31F36a91aB543324440015C36728f91A7976b",
        "fromLabel": "",
        "fromAddress": "0xc5a31F36a91aB543324440015C36728f91A7976b",
        "toEntity": "BYBIT",
        "toLabel": "",
        "toAddress": "0xf89d7b9c864f589bbF53a82105107622B35EaA40",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0xc554a9a88f2c7c03f9e4fbeb884ecff23bb31818b89598765b4fb437124e8298",
        "chain": "Polygon",
        "amountUsd": 26464.21,
        "amount": 30064.83,
        "threshold": 0,
        "ts": "2024-02-13T10:13:58"
    },
    {
        "symbol": "RNDR",
        "side": 1,
        "exchangeLabel": "BINANCE",
        "exchangeId": 1,
        "fromEntity": "BINANCE",
        "fromLabel": "",
        "fromAddress": "0x21a31Ee1afC51d94C2eFcCAa2092aD1028285549",
        "toEntity": "0x8ED1376aC0C525fd7187759438F8fde93A0b1bf0",
        "toLabel": "",
        "toAddress": "0x8ED1376aC0C525fd7187759438F8fde93A0b1bf0",
        "isExchToExch": false,
        "isDepositWalletToExchange": false,
        "txId": "0xe85534b6c79bb3db6d1d90d5287e68bc36ccc44192b979855ff79e7fdc2af952",
        "chain": "Ethereum",
        "amountUsd": 25593.66,
        "amount": 4998.761,
        "threshold": 0,
        "ts": "2024-02-13T10:13:35"
    },
    {
```

400: Bad Request An error indicating why the request is invalid

{
    "error": [
        {
            "loc": [
                "symbol"
            ],
            "msg": "Invalid symbol format",
            "type": "value_error"
        }
    ]
}

Usage Example:

Query ETH transfers that happened on a given period no matter the exchange

import json
import requests
from urllib.parse import urljoin

COINACT_API_URL = "https://api.coinact.gg/v1/"
ENDPOINT = "exchange-transfer-history"
HEADERS = {"x-api-key": "YOUR API KEY"}

def get_transfers(session, start, end, page):
    params = {
        'symbol': 'ETH',
        'start': start,
        'end': end,
        'page': page
    }
    response = session.get(urljoin(COINACT_API_URL, ENDPOINT), headers=HEADERS, params=params)
    return json.loads(response.content)

def fetch_all_transfers(start, end):
    transfers = []
    page = 1
    with requests.Session() as session:
        while True:
            results = get_transfers(session, start, end, page)
            if not results:
                break
            transfers.extend(results)
            page += 1
    return transfers

if __name__ == "__main__":
    start_timestamp = '1704123127'
    end_timestamp = '1705347127'
    all_transfers= fetch_all_transfers(start_timestamp, end_timestamp)
    print(all_transfers)
    print(len(all_transfers))