Developers

API Reference

Public, unauthenticated HTTP endpoints that expose the same Chainlink CRE circulating-supply data and corporate wallet balances shown on this site—usable as an integrator “API door” with stable JSON fields.

Base URL

https://ukfl-cre-verified-tokens.com/

Authentication

None. All endpoints are public GET JSON.

Caching

On-chain reads revalidate about every 90s. CRE workflows may refresh on-chain closer to ~30 minutes.

Conventions

Content-Type: application/json
Unknown path resources return 404 with { error, slug | id }
Chain/RPC failures on wallet list may return 502
Amounts that originate on-chain use { raw, formatted } where applicable

Endpoints

GEThttps://ukfl-cre-verified-tokens.com/api/tokens

List tokens

Returns the full catalogue of UKFL CRE–verified tokens with static metadata and related path helpers. No blockchain call is required for this endpoint.

cURL

curl -sS "https://ukfl-cre-verified-tokens.com/api/tokens" \
  -H "Accept: application/json"

JavaScript (fetch)

const res = await fetch("https://ukfl-cre-verified-tokens.com/api/tokens", {
  headers: { Accept: "application/json" },
});
const data = await res.json();
console.log(data);

Example response

{
  "count": 10,
  "tokens": [
    {
      "slug": "mpra",
      "symbol": "MPRA",
      "name": "Maya Preferred PRA",
      "roleTag": "Preferred Class · RWA",
      "standard": "ERC-20",
      "networks": [
        "ethereum"
      ],
      "summary": "Flagship ERC-20 RWA preferred-class token…",
      "creAddress": "0x1Dc69020c37879171385fED7DAcbf642edE5E079",
      "tokenAddress": "0xEc1227BfB3e76d7a2A9bca24d9E98f68dE8bf808",
      "endpoints": {
        "detail": "/tokens/mpra",
        "supplyPage": "/chainlink/mpra/supply",
        "supplyApi": "/api/tokens/mpra/supply",
        "metaApi": "/api/tokens/mpra"
      }
    }
  ],
  "updatedAt": "2026-08-09T12:00:00.000Z"
}

Open live endpoint

GEThttps://ukfl-cre-verified-tokens.com/api/tokens/mpra

Get token metadata

Returns full static metadata for a single token (about copy, contracts, trading links, CRE address).

Parameters

Name	In	Required	Description
slug	path	yes	Token slug identifier. ukfl · mpra · smcat · mprd · wmpra · rpwmpra · maya3 · mfund · ltns1 · venus

Name

Required

Description

slug

path

yes

Token slug identifier.

ukfl · mpra · smcat · mprd · wmpra · rpwmpra · maya3 · mfund · ltns1 · venus

cURL

curl -sS "https://ukfl-cre-verified-tokens.com/api/tokens/mpra" \
  -H "Accept: application/json"

JavaScript (fetch)

const res = await fetch("https://ukfl-cre-verified-tokens.com/api/tokens/mpra", {
  headers: { Accept: "application/json" },
});
const data = await res.json();
console.log(data);

Example response

{
  "slug": "mpra",
  "symbol": "MPRA",
  "name": "Maya Preferred PRA",
  "standard": "ERC-20",
  "creAddress": "0x1Dc69020c37879171385fED7DAcbf642edE5E079",
  "tokenAddress": "0xEc1227BfB3e76d7a2A9bca24d9E98f68dE8bf808",
  "paths": {
    "detail": "/tokens/mpra",
    "supply": "/chainlink/mpra/supply",
    "supplyApi": "/api/tokens/mpra/supply"
  },
  "updatedAt": "2026-08-09T12:00:00.000Z"
}

Error responses

404 — Unknown slug

{
  "error": "Token not found",
  "slug": "unknown"
}

Open live endpoint

GEThttps://ukfl-cre-verified-tokens.com/api/tokens/mpra/supply

Get live CRE circulating supply

Reads the Chainlink CRE CirculatingSupplyConsumer for the token plus corporate wallet balance breakdown. Values are cached on-server (~90 seconds).

Parameters

Name	In	Required	Description
slug	path	yes	Token slug identifier. ukfl · mpra · smcat · mprd · wmpra · rpwmpra · maya3 · mfund · ltns1 · venus

Name

Required

Description

slug

path

yes

Token slug identifier.

ukfl · mpra · smcat · mprd · wmpra · rpwmpra · maya3 · mfund · ltns1 · venus

cURL

curl -sS "https://ukfl-cre-verified-tokens.com/api/tokens/mpra/supply" \
  -H "Accept: application/json"

JavaScript (fetch)

const res = await fetch("https://ukfl-cre-verified-tokens.com/api/tokens/mpra/supply", {
  headers: { Accept: "application/json" },
});
const data = await res.json();
console.log(data);

Example response

{
  "slug": "mpra",
  "symbol": "MPRA",
  "creAddress": "0x1Dc69020c37879171385fED7DAcbf642edE5E079",
  "tokenAddress": "0xEc1227BfB3e76d7a2A9bca24d9E98f68dE8bf808",
  "decimals": 18,
  "circulatingSupply": {
    "raw": "977896534000000000000000",
    "formatted": "977,896.534"
  },
  "totalSupply": {
    "raw": "200000000000000000000000000",
    "formatted": "200,000,000"
  },
  "corporateAssetsBalance": {
    "raw": "…",
    "formatted": "155,022,103.466"
  },
  "treasuryBalance": {
    "raw": "…",
    "formatted": "44,000,000"
  },
  "computedCirculating": {
    "raw": "…",
    "formatted": "977,896.534"
  },
  "lastObservedAt": 1723123456,
  "lastObservedAtIso": "2026-08-09T11:30:00.000Z",
  "lastObservedRelative": "12m ago",
  "updateCount": "42",
  "isFresh": true,
  "corporateWallets": [
    {
      "id": "corporate-assets",
      "deductFromCirculating": true,
      "balance": {
        "raw": "…",
        "formatted": "…"
      }
    }
  ],
  "source": "cre",
  "error": null,
  "fetchedAt": "2026-08-09T12:00:00.000Z"
}

Error responses

404 — Unknown slug

{
  "error": "Token not found",
  "slug": "unknown"
}

Open live endpoint

GEThttps://ukfl-cre-verified-tokens.com/api/wallets

List corporate wallets

Returns all UK Financial Ltd corporate wallets with live ERC-20 balances for catalogue tokens, plus circulating-supply deduction policy. On-chain reads are cached (~90 seconds).

cURL

curl -sS "https://ukfl-cre-verified-tokens.com/api/wallets" \
  -H "Accept: application/json"

JavaScript (fetch)

const res = await fetch("https://ukfl-cre-verified-tokens.com/api/wallets", {
  headers: { Accept: "application/json" },
});
const data = await res.json();
console.log(data);

Example response

{
  "count": 5,
  "policy": {
    "deductFromCirculating": "Wallets with deductFromCirculating=true (corporate-assets, treasury-vault) are corporate-owned and subtracted from circulating supply."
  },
  "wallets": [
    {
      "id": "corporate-assets",
      "ens": "uk-financial-ltd-corporate-assets.eth",
      "address": "0xAF2587b7e09d7816Fc0867Ea3A8B3058bBaAa16F",
      "role": "corporate_owned",
      "deductFromCirculating": true,
      "balances": [
        {
          "slug": "mpra",
          "symbol": "MPRA",
          "raw": "…",
          "formatted": "155022103.466",
          "decimals": 18
        }
      ],
      "updatedAt": "2026-08-09T12:00:00.000Z"
    }
  ],
  "updatedAt": "2026-08-09T12:00:00.000Z"
}

Error responses

502 — RPC / chain read failure

{
  "error": "Failed to load wallets"
}

Open live endpoint

GEThttps://ukfl-cre-verified-tokens.com/api/wallets/corporate-assets

Get single wallet report

Contract-style report for one corporate wallet: ENS, address, deduction flag, and per-token balances.

Parameters

Name	In	Required	Description
id	path	yes	Wallet identifier. corporate-assets · treasury-vault · maya-pro-vault · venus-holdings · maya-chain

Name

Required

Description

path

yes

Wallet identifier.

corporate-assets · treasury-vault · maya-pro-vault · venus-holdings · maya-chain

cURL

curl -sS "https://ukfl-cre-verified-tokens.com/api/wallets/corporate-assets" \
  -H "Accept: application/json"

JavaScript (fetch)

const res = await fetch("https://ukfl-cre-verified-tokens.com/api/wallets/corporate-assets", {
  headers: { Accept: "application/json" },
});
const data = await res.json();
console.log(data);

Example response

{
  "id": "corporate-assets",
  "ens": "uk-financial-ltd-corporate-assets.eth",
  "label": "Corporate Assets Hub",
  "address": "0xAF2587b7e09d7816Fc0867Ea3A8B3058bBaAa16F",
  "role": "corporate_owned",
  "deductFromCirculating": true,
  "description": "Primary UK Financial Ltd corporate assets wallet…",
  "etherscan": "https://etherscan.io/address/0xAF2587b7e09d7816Fc0867Ea3A8B3058bBaAa16F",
  "balances": [
    {
      "slug": "mpra",
      "symbol": "MPRA",
      "tokenAddress": "0xEc1227BfB3e76d7a2A9bca24d9E98f68dE8bf808",
      "raw": "…",
      "formatted": "155022103.466",
      "decimals": 18
    }
  ],
  "updatedAt": "2026-08-09T12:00:00.000Z"
}

Error responses

404 — Unknown wallet id

{
  "error": "Wallet not found",
  "id": "unknown"
}

Open live endpoint

Token slugs

Use these values for {slug}.

Wallet IDs

Use these values for {id}.

Circulating supply policy

Wallets corporate-assets and treasury-vault are corporate-owned and are deducted when explaining public float (total − corporate − treasury). When a CRE receiver publishes circulatingSupply, that field is the authoritative figure for trackers and listings.