Account History Examples

Examples of querying historical account data from the Meridian archive API. For the full list of available endpoints and parameters, see the Archive API documentation.

All examples assume you have an initialized AsyncRESTClient with an account or private key. See the Quickstart if you need help setting one up. Archive requests use the archive_base_url from the client config:

client = await AsyncRESTClient.create({
    "base_url": "https://api.meridian.xyz",
    "archive_base_url": "https://archive.meridian.xyz",
})

Balance history

import time

subaccounts = await client.subaccounts()
subaccount_id = subaccounts[0].id

now = time.time() * 1000              # Archive API uses milliseconds
one_week_ago = now - 7 * 86400 * 1000

history = await client.get_subaccount_balance_history(
    subaccount_id=subaccount_id,
    start_time=one_week_ago,
    end_time=now,
    resolution="hour1",
)

for record in history:
    print(record.model_dump())

Funding history

funding = await client.get_subaccount_funding_history(
    subaccount_id=subaccount_id,
    start_time=one_week_ago,
)

for record in funding:
    print(f"{record.product_ticker}: {record.funding_charge}")

You can filter funding history by specific products or positions:

funding = await client.get_subaccount_funding_history(
    subaccount_id=subaccount_id,
    start_time=one_week_ago,
    product_ids=[btc_product_id],    # Filter by product
)

Total volume

total = await client.get_subaccount_total_volume(subaccount_id=subaccount_id)
print(f"Total volume: ${total.volume_usd}")