---
title: "Get wallet behaviour segment and quality score"
method: POST
path: "/segmentation/wallet-segment"
tags: ["Behaviour Prediction API"]
---

# Get wallet behaviour segment and quality score

`POST /segmentation/wallet-segment`

Classifies a wallet address into a quality segment (A, B, or C) based on its on-chain behaviour history, and returns a 0–100 quality score for finer-grained ranking.

Use this endpoint to distinguish high-value users from low-value or low-intent users at the moment they connect to your protocol — without requiring any off-chain identity data.

**Subscription:** Enterprise.

**Supported networks:** `ETH`, `BNB`, `BASE`, `HAQQ`, `SOLANA` .

**Further reading:** [Web3 Behavioral User Analytics Guide](https://chainaware.ai/blog/chainaware-web3-behavioral-user-analytics-guide/)

## Request body

- WalletSegmentRequestBody
  - `walletAddress` string, required — The wallet address to classify.
  - `network` 'ETH' | 'BNB' | 'BASE' | 'HAQQ' | 'SOLANA', required — Blockchain network to query.

## Response `200`

Wallet segment and quality score

- WalletSegmentResponse
  - `message` string — Result status message.
  - `walletAddress` string — Blockchain wallet address analyzed.
  - `walletQuality` integer — Calculated wallet quality score from 0 to 100 derived from segment, protocol diversity, balance history, and wallet behavior.
  - `categories` object[] — Wallet activity categories grouped by interaction domain.
    - `Category` string
    - `Count` integer
  - `riskProfile` object[] — Balance-age weighted willingness-to-take-risk indicators.
    - `Category` string
    - `Balance_age` number, float
  - `segmentInfo` string — Serialized JSON containing protocol engagement flags used for segment classification.
  - `experience` object — Wallet experience score based on protocol depth and activity maturity.
    - `Type` string
    - `Value` integer
  - `intention` object — Predicted next wallet actions.
    - `Type` string
    - `Value` object
      - `Prob_Lend` string
      - `Prob_Trade` string
      - `Prob_Game` string
      - `Prob_NFT` string
      - `Prob_Stake_ETH` string
      - `Prob_Borrow` string
      - `Prob_Gamble` string
      - `Prob_Stake` string
      - `Prob_Yield_Farm` string
      - `Prob_Leveraged_Stake` string
      - `Prob_Leveraged_Stake_ETH` string
      - `Prob_Leveraged_Lend` string
      - `Prob_Leverage_Long_ETH` string
      - `Prob_Leverage_Long` string
  - `protocols` object[] — Protocols the wallet has interacted with ordered by usage frequency.
    - `Protocol` string
    - `Count` integer
  - `userDetails` object — Core wallet metrics used for segmentation.
    - `wallet_age_days` integer
    - `total_balance_usd` number, float
    - `transaction_count` integer
    - `wallet_rank` integer
  - `recommendation` object — Product fit or engagement recommendations based on wallet segment.
    - `Type` string
    - `Value` string[]
  - `sanctionData` object[] — Sanctions screening associated with this wallet.
    - `category` string, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `url` string, nullable
    - `isSanctioned` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Bad request — missing or invalid fields in the request body
- `401` — Unauthorised — API key missing or invalid
- `404` — Wallet not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/chainaware/apis/chainaware-enterprise-api.md) · [All operations](https://skmtc.dev/chainaware/apis/chainaware-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainaware/chainaware-enterprise-api/revisions/a045ee3672fc/schema)