# GET /v1/solana/address/{address}/kind

What kind of Solana account is this address, and should a payment go to it?

## Purpose

Reads the account at `address` on finalized state with one `getMultipleAccounts` call and classifies it from its owner program, executable flag and data length. `kind` is `not_found` (no account; still a 200 answer), `wallet` (System Program, 0 bytes; `on_curve` is false for a program-derived address), `nonce` (System Program, 80 bytes), `token_account` (with `token_owner`, `mint`, `token_program` and `is_ata`), `mint` (with `token_program`), `token_multisig`, `program` (executable), `stake`, `vote` or `other` (with `owner_program`). Fields that do not apply to the kind are null. Payment hints: pay_token_owner (name the wallet `token_owner`, not this token account, as the recipient), not_a_payment_destination, program_owned_destination, pda_wallet. Every figure is read at finalized commitment, so it can lag the tip of the chain by about 13 seconds; `meta.slot` is the lowest context slot of the reads behind the answer.

## When to use

Before sending SOL or tokens to an address: to learn whether it is a wallet, a token account (and whose), a mint, a program or another program-owned account.

## When not to use

To check one transfer end to end with amounts and fees (use `/v1/solana/transfer-readiness`), or to read balances (none are returned).

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `address` | path | yes | Solana address to classify. | A base58 string that decodes to exactly 32 bytes (a Solana public key); anything else is a 400 | `Ffeie177PRngys3SwNH44AYdT9yExm63GAmTXHdmL1k1` |

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/solana/address/Ffeie177PRngys3SwNH44AYdT9yExm63GAmTXHdmL1k1/kind"
```

## Response example (200)

```json
{
  "kind": "token_account",
  "on_curve": null,
  "token_owner": "fr6yQkDmWy6R6pecbUsxXaw6EvRJznZ2HsK5frQgud8",
  "mint": "2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo",
  "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
  "is_ata": true,
  "owner_program": null,
  "payment_hints": [
    "pay_token_owner"
  ],
  "meta": {
    "slot": 468263808,
    "commitment": "finalized",
    "as_of": "2026-11-11T20:51:26.907Z",
    "age_seconds": 0,
    "cache": "miss",
    "stale": false
  }
}
```

## Errors

- 400 [invalid-parameters](https://api.criptonlabs.com/errors/invalid-parameters.md)
- 429 [rate-limited](https://api.criptonlabs.com/errors/rate-limited.md)
- 503 [upstream-unavailable](https://api.criptonlabs.com/errors/upstream-unavailable.md)

## Caching

Fresh for 4 seconds; on upstream failure the last good value is served for up to 30 seconds (`meta.stale` is `true`), then the service answers 503. See the [freshness guide](https://api.criptonlabs.com/docs/guides/freshness.md).

## Rate limit

Tier `cheap`. See the [rate-limits guide](https://api.criptonlabs.com/docs/guides/rate-limits.md).

## MCP tool

The MCP tool `solana_address_kind` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
