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

What kind of XRPL address is this, and what does a payment to it need?

## Purpose

Reads the account at `address` on the latest validated ledger with one `account_info` call. `kind` is `not_found` (no account; still a 200 answer), `amm`, `vault` or `loan_broker` (the pseudo-account of an AMM pool, a vault or a loan broker, read from `AMMID`, `VaultID` or `LoanBrokerID`), or `account`. `flags` are the decoded AccountRoot flags, and `blackholed` is true when the master key is disabled, there is no signer list and the regular key is absent or a known blackhole address. Payment hints: destination_tag_required, deposit_preauth_required, xrp_not_wanted (advisory: the ledger does not enforce it), pseudo_account_rejects_payments, blackholed_account.

## When to use

Before paying or listing an XRPL address: to learn whether it exists, whether it is a pseudo-account that rejects payments, and whether a payment needs a destination tag or deposit preauthorization.

## When not to use

To check one payment end to end with amounts, trust lines and reserves (use `/v1/xrpl/payment-readiness`), or to read balances (use `/v1/xrpl/account/{address}/summary`).

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `address` | path | yes | XRPL classic address to classify. | Valid classic XRPL address: starts with `r`, 25 to 35 base58 characters, checksum verified | `rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3` |

## Request example

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

## Response example (200)

```json
{
  "kind": "amm",
  "flags": {
    "require_dest_tag": false,
    "deposit_auth": true,
    "disallow_xrp": false,
    "disallow_incoming": {
      "check": false,
      "nftoken_offer": false,
      "paychan": false,
      "trustline": false
    },
    "require_auth": false,
    "default_ripple": true,
    "global_freeze": false,
    "no_freeze": false,
    "allow_clawback": false
  },
  "blackholed": true,
  "payment_hints": [
    "deposit_preauth_required",
    "pseudo_account_rejects_payments",
    "blackholed_account"
  ],
  "meta": {
    "ledger_index": 108300498,
    "as_of": "2026-11-13T09:18:36.982Z",
    "age_seconds": 0,
    "cache": "miss",
    "stale": false
  }
}
```

## Errors

- 400 [invalid-parameters](https://api.criptonlabs.com/errors/invalid-parameters.md)
- 400 [bad-request](https://api.criptonlabs.com/errors/bad-request.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 10 seconds; on upstream failure the last good value is served for up to 120 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 `xrpl_address_kind` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
