---
title: "Get Arkham entity balance changes"
method: POST
path: "/intelligence/entity-balance-changes"
tags: ["Intelligence"]
---

# Get Arkham entity balance changes

`POST /intelligence/entity-balance-changes`

Get Arkham entity balance changes. $0.40 per call.

## Request body

- object
  - `balanceMax` union — Maximum balance threshold in USD to filter entities.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `balanceMin` union — Minimum balance threshold in USD to filter entities.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `chains` union — List of chains to filter by.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `entityIds` union — List of specific entity IDs to filter by.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `entityTags` union — List of entity tags to include. Requires elevated access; requests using this parameter without it may return 403.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `entityTypes` union — List of entity types to filter by.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `interval` union, required — Time interval for balance change calculation. One of '7d', '14d', or '30d'.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `limit` union, required — Number of results to return per page. Required; must be between 1 and 100.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `negatedEntityTags` union — List of entity tags to exclude. Requires elevated access; requests using this parameter without it may return 403.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `offset` union — Number of results to skip from the beginning.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `orderBy` union, required — Field to sort results by. One of: balanceUsd, balanceUsdChange, balanceUsdPctChange, balanceUnit, balanceUnitChange, ba…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `orderDir` union, required — Sort direction: 'asc' for ascending or 'desc' for descending.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `pricingIds` union — List of CoinGecko pricing IDs to filter by.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean

## Response `200`

Successful response

- unknown[]
  - unknown

## Other responses

- `400` — Fatal for the request as written: validation failed or required JSON body fields are missing. Fix the request; do not retry it unchanged. Payment is not settled.
- `402` — Payment challenge, not an application error. Read the base64 x402 v2 challenge from PAYMENT-REQUIRED, sign it, and retry the same request with PAYMENT-SIGNATURE. If a post-payment 402 omits PAYMENT-REQUIRED, verification failed: read the new challenge, re-sign, and retry once.
- `404` — The upstream Arkham resource does not exist. Fatal for the same input. Payment is not settled.
- `429` — Per-wallet endpoint rate limit exceeded. Retry with at least 1 second of backoff; keep heavy endpoints at no more than 1 request per second.
- `5XX` — Arkham failed or timed out, including 502 and 504 responses. Retry with backoff. x402 payments and MPP transaction credentials are not settled for failed requests; MPP hash credits are redeemed at admission and are not refunded automatically.

---

[API](https://skmtc.net/arkm/apis/arkham-x402.md) · [All operations](https://skmtc.net/arkm/apis/arkham-x402/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkm/arkham-x402/versions/7830c19a58c4/schema)