Skip to main content
GET
/
flows
/
top
Python
import os
from datetime import date
from artemis import Artemis

client = Artemis()
response = client.flow.get_top(
    api_key=os.environ["ARTEMIS_API_KEY"],
    breakdown="chains",
    end_date=date(2026, 2, 1),
    flow_type="netflow",
    source_chains="ethereum,arbitrum,base",
    start_date=date(2026, 1, 1),
)
print(response.netflow)
{
  "inflow": {
    "ethereum": 88869217.4,
    "arbitrum": 79059259.03,
    "base": 35071676.44
  },
  "netflow": {
    "ethereum": -20650296.17,
    "arbitrum": -5265571.05,
    "base": 25915867.22
  },
  "outflow": {
    "ethereum": 109519513.58,
    "arbitrum": 84324830.08,
    "base": 9155809.21
  }
}

Documentation Index

Fetch the complete documentation index at: https://artemis.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
startDate
string<date>
required

Start date in YYYY-MM-DD format

​
endDate
string<date>
required

End date in YYYY-MM-DD format

​
granularity
enum<string>
default:DAY

Time-bucket granularity for returned series.

Available options:
DAY,
WEEK,
MONTH,
QUARTER,
YEAR
​
sourceChains
string
required

Comma-separated list of blockchain identifiers. Use full chain names for best compatibility.

​
breakdown
enum<string>
required

Breakdown type for the flow data

Available options:
chains
​
flowType
enum<string>
required

Type of flow to retrieve

Available options:
netflow,
inflow,
outflow
​
limit
integer
default:20

Optional parameter. May cause issues with certain sourceChains combinations.

​
APIKey
string
required

Your Artemis API key

Response

200 - application/json

Flows data based on flowType parameter

Response containing flow data by chain. Properties present depend on flowType parameter.

​
netflow
object

Object where keys are chain names and values are flow amounts

​
inflow
object

Object where keys are chain names and values are flow amounts

​
outflow
object

Object where keys are chain names and values are flow amounts