ERC20 Exchange Flows

This endpoint returns the flows of ERC20 tokens into exchange wallets for as far back as we track. Please note that the transfer generally occurs after a certain amount of time from the contract created time. We constantly keep updating new exchange wallets, which means that there can be slight modification in values especially for recent data points. The update is done in periodic and automatic way: Tuesday 00:00 UTC every week. Supported exchanges can be found in the /erc20/status/entity-list endpoint. In addition to that, we support the following aggregated exchanges:

Supported Aggregated Exchanges

Name

Exchange

Supported ERC20 Tokens

All Exchanges

all_exchange

All Tokens

Spot Exchanges

spot_exchange

All Tokens

Derivative Exchanges

derivative_exchange

All Tokens

Note: This endpoint does not support Point-In-Time (PIT) accuracy due to periodic updates to wallet address clustering. Historical data may change as new exchange wallets are discovered, added, and validated.

Reserve

get

This endpoint returns the full historical on-chain ERC20 token balance of exchanges.

Authorizations

AuthorizationstringRequired

For each API request, include this HTTP header: Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required. You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.

Query parameters

tokenstringRequired

A ERC20 token from the table that we support. See here

Example: link

exchangestringRequired

An exchange from the table that we support. Please check the supported exchanges for each token from here.

Example: binance

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.

Example: 20191001T100000

toanyOptional

This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The amount of ERC20 token on a given exchange on this window.

application/json

get/erc20/exchange-flows/reserve

curl "https://api.cryptoquant.com/v1/erc20/exchange-flows/reserve?token=link&exchange=binance&window=day&from=20191001&limit=2"

200

The amount of ERC20 token on a given exchange on this window.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "reserve": null,
        "reserve_usd": null
      },
      {
        "date": "2019-10-01",
        "reserve": null,
        "reserve_usd": null
      }
    ]
  }
}

Netflow

get

The difference between coins flowing into exchanges and flowing out of exchanges. Netflow usually helps us to figure out an increase of idle coins waiting to be traded in a certain time frame.

Authorizations

AuthorizationstringRequired

Query parameters

tokenstringRequired

A ERC20 token from the table that we support. See here

Example: link

exchangestringRequired

An exchange from the table that we support. Please check the supported exchanges for each token from here.

Example: binance

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

netflow_total

application/json

get/erc20/exchange-flows/netflow

curl "https://api.cryptoquant.com/v1/erc20/exchange-flows/netflow?token=link&exchange=binance&window=day&from=20191001&limit=2"

200

netflow_total

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "netflow_total": null
      },
      {
        "date": "2019-10-01",
        "netflow_total": null
      }
    ]
  }
}

Inflow

get

This endpoint returns the inflow of ERC20 token into exchange wallets for as far back as we track. The average inflow is the average transaction value for transactions flowing into exchange wallets on a given day.

Authorizations

AuthorizationstringRequired

Query parameters

tokenstringRequired

A ERC20 token from the table that we support. See here

Example: link

exchangestringRequired

An exchange from the table that we support. Please check the supported exchanges for each token from here.

Example: binance

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

inflow_total, inflow_top10, inflow_mean

application/json

get/erc20/exchange-flows/inflow

curl "https://api.cryptoquant.com/v1/erc20/exchange-flows/inflow?token=link&exchange=binance&window=day&from=20191001&limit=2"

200

inflow_total, inflow_top10, inflow_mean

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "inflow_total": null,
        "inflow_top10": null,
        "inflow_mean": null
      },
      {
        "date": "2019-10-01",
        "inflow_total": null,
        "inflow_top10": null,
        "inflow_mean": null
      }
    ]
  }
}

Outflow

get

This endpoint returns the outflow of ERC20 token into exchange wallets for as far back as we track. The average outflow is the average transaction value for transactions flowing into exchange wallets on a given day.

Authorizations

AuthorizationstringRequired

Query parameters

tokenstringRequired

A ERC20 token from the table that we support. See here

Example: link

exchangestringRequired

An exchange from the table that we support. Please check the supported exchanges for each token from here.

Example: binance

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

outflow_total, outflow_top10, outflow_mean

application/json

get/erc20/exchange-flows/outflow

curl "https://api.cryptoquant.com/v1/erc20/exchange-flows/outflow?token=link&exchange=binance&window=day&from=20191001&limit=2"

200

outflow_total, outflow_top10, outflow_mean

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "outflow_total": null,
        "outflow_top10": null,
        "outflow_mean": null
      },
      {
        "date": "2019-10-01",
        "outflow_total": null,
        "outflow_top10": null,
        "outflow_mean": null
      }
    ]
  }
}

Transactions Count

get

This endpoint returns the number of transactions flowing in/out of ERC20 token exchanges.

Authorizations

AuthorizationstringRequired

Query parameters

tokenstringRequired

A ERC20 token from the table that we support. See here

Example: link

exchangestringRequired

An exchange from the table that we support. Please check the supported exchanges for each token from here.

Example: binance

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

transactions_count_inflow, transactions_count_outflow

application/json

get/erc20/exchange-flows/transactions-count

curl "https://api.cryptoquant.com/v1/erc20/exchange-flows/transactions-count?token=link&exchange=binance&window=day&from=20191001&limit=2"

200

transactions_count_inflow, transactions_count_outflow

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "transactions_count_inflow": null,
        "transactions_count_outflow": null
      },
      {
        "date": "2019-10-01",
        "transactions_count_inflow": null,
        "transactions_count_outflow": null
      }
    ]
  }
}

Addresses Count

get

This endpoint returns the number of addresses involved in inflow/outflow transactions.

Authorizations

AuthorizationstringRequired

Query parameters

tokenstringRequired

A ERC20 token from the table that we support. See here

Example: link

exchangestringRequired

An exchange from the table that we support. Please check the supported exchanges for each token from here.

Example: binance

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The number of addresses evoking inflow/outflow transactions to exchange wallets

application/json

get/erc20/exchange-flows/addresses-count

curl "https://api.cryptoquant.com/v1/erc20/exchange-flows/addresses-count?token=link&exchange=binance&window=day&from=20191001&limit=2"

200

The number of addresses evoking inflow/outflow transactions to exchange wallets

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "addresses_count_inflow": null,
        "addresses_count_outflow": null
      },
      {
        "date": "2019-10-01",
        "addresses_count_inflow": null,
        "addresses_count_outflow": null
      }
    ]
  }
}

PreviousERC20 Entity Status

NextERC20 Market Data

Last updated 7 months ago

Was this helpful?