# GET /v1/solana/stablecoin/{mint}

Is this Solana mint the canonical stablecoin it claims to be?

## Purpose

Answers from a closed registry of canonical stablecoins, each entry taken from the issuer's own documentation. `canonical` is true only for a registry mint, and `registry_entry` then names the issuer and links its own documentation. `posture` is the mint's controls read live (`token_program`, `mint_authority_set`, `freeze_authority_set` and `extensions`) and compared with a dated snapshot: `posture_matches_registry` says whether every fact still matches, and `posture_differences` lists each one that changed as `<field>_changed` (the extension names are compared as a set, so their order never counts). A registry mint that no longer decodes answers `posture: null` with `mint_not_found`, still 200. The registry never changes the token verdict: the PYUSD mint of the example keeps its own `DANGER` verdict with `permanent_delegate` on `/v1/solana/token/{mint}` while its stablecoin answer is canonical, so read both before accepting a token. No regulatory or licensing status is returned, and a canonical answer is not an endorsement of the token. 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 accepting or quoting a stablecoin: to check the mint is the canonical one and that its mint facts have not changed since the snapshot.

## When not to use

To read supply or balances (use `/v1/solana/token/{mint}`), or as a regulatory or licensing check: none is served.

## Parameters

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

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/solana/stablecoin/2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo"
```

## Response example (200)

```json
{
  "canonical": true,
  "registry_entry": {
    "symbol": "PYUSD",
    "peg": "USD",
    "issuer_name": "Paxos",
    "source_url": "https://docs.paxos.com/guides/stablecoin/pyusd/mainnet"
  },
  "posture": {
    "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
    "mint_authority_set": true,
    "freeze_authority_set": true,
    "extensions": [
      "mint_close_authority",
      "permanent_delegate",
      "transfer_fee_config",
      "confidential_transfer_mint",
      "confidential_transfer_fee_config",
      "transfer_hook",
      "metadata_pointer",
      "token_metadata"
    ]
  },
  "posture_matches_registry": true,
  "posture_differences": [],
  "snapshot_date": "2026-11-11",
  "meta": {
    "slot": 456932444,
    "commitment": "finalized",
    "as_of": "2026-10-14T12:00:03.000Z",
    "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 60 seconds; on upstream failure the last good value is served for up to 600 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_stablecoin` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
