Build with Bluprynt

Bluprynt gives integrators three surfaces. Use the KYI Widget SDK to verify issuers inside your product. Use the Public API to read verified asset records and badges. Use the Explorer API to read tokenomics changes and run a Disclosure Monitoring watchlist.

KYI Widget SDK

Open the KYI drawer on your page with one kyi() call.

Public API

Look up KYI-verified assets, issuers and authority wallets.

Explorer API

Poll tokenomics changes and your watchlist’s disclosure changes.

Choose a surface

Surface	Use it to	Credential	Writes
KYI Widget SDK	Verify an issuer and its assets in your product	Partner ID + `SECRET_KEY` mint a short-lived token on your server	The member’s own KYB, assets and wallet signatures
Public API	Show whether a token is KYI verified	API key, raw in `Authorization`	Nothing, every route is `GET`
Explorer API	Track tokenomics and disclosure changes	`bx_live_…` key as `Bearer`	Only the `watchlist:write` routes

Base URLs: the SDK ships as @bluprynt/kyi-widget-sdk, the Public API is at https://integrations.bluprynt.com and the Explorer API is at https://explorer-api.bluprynt.com. For SDK partner credentials, ask your Bluprynt representative. For API keys, write to product@bluprynt.com.

The two APIs authenticate differently. The Public API rejects a Bearer prefix. The Explorer API requires one.

Authenticate

KYI Widget SDK
Public API
Explorer API

Your server mints a token for the signed-in member, and the browser opens the drawer with it. The full server code is in Access tokens.

// server
import { generateToken } from '@bluprynt/kyi-widget-sdk/server'

const accessToken = await generateToken({
  issuer: process.env.KYI_PARTNER_ID!,
  secretKey: process.env.KYI_SECRET_KEY!,
  userId: String(session.user.id),
})

// browser
import { kyi } from '@bluprynt/kyi-widget-sdk'

const widget = kyi('drawer', 'kyi', accessToken, {
  onClose: () => widget.destroy(),
})

curl -s "https://integrations.bluprynt.com/assets/solana/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -H "Authorization: $BLUPRYNT_API_KEY"

const res = await fetch(
  'https://integrations.bluprynt.com/assets/solana/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  { headers: { Authorization: process.env.BLUPRYNT_API_KEY! } },
)
const asset = await res.json()

import os, requests

asset = requests.get(
    "https://integrations.bluprynt.com/assets/solana/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    headers={"Authorization": os.environ["BLUPRYNT_API_KEY"]},
).json()

curl -s "https://explorer-api.bluprynt.com/me/watchlist" \
  -H "Authorization: Bearer $BLUPRYNT_EXPLORER_KEY"

const res = await fetch('https://explorer-api.bluprynt.com/me/watchlist', {
  headers: { Authorization: `Bearer ${process.env.BLUPRYNT_EXPLORER_KEY}` },
})
const { data } = await res.json()

import os, requests

body = requests.get(
    "https://explorer-api.bluprynt.com/me/watchlist",
    headers={"Authorization": f"Bearer {os.environ['BLUPRYNT_EXPLORER_KEY']}"},
).json()

Key routes

Public API

Route	Returns
`GET /assets`	All verified assets, paged
`GET /assets/{chain}/{account_address}`	One asset by chain name
`GET /assets/{namespace}/{reference}/{account_address}`	One asset by CAIP-2 chain ID
`GET /kyi/v1/tokens`	KYI verification for a token
`GET /api/v1/badges/{credential_type}`	A badge image, no key needed

Full Public API reference

Explorer API

Route	Scope
`GET /tokenomics/changes`	`tokenomics:read`
`GET /assets/{id}/tokenomics/changes`	`tokenomics:read`
`GET /me/watchlist`	`monitoring:read`
`GET /me/monitoring/changes`	`monitoring:read`
`GET /me/notifications`	`monitoring:read`
`POST`, `PATCH`, `DELETE /me/watchlist…`	`watchlist:write`

Full Explorer API reference

Try it without a key

Badges need no key, so this call works as is:

curl -s -o kyi.svg -w "%{http_code} %{content_type}\n" \
  "https://integrations.bluprynt.com/api/v1/badges/kyi_verified?variant=full"
# 200 image/svg+xml

The Explorer API health check needs no key either: curl -s https://explorer-api.bluprynt.com/health.

Next steps

Embed KYI

Mint a token and open the drawer in three steps.

Show a KYI badge

Badge a verified token in your listing, end to end.

Watch an asset

Watch, read changes and pull notifications.

KYI Widget SDK

Public API

Explorer API

​Choose a surface

​Authenticate

​Key routes

​Try it without a key

​Next steps

Embed KYI

Show a KYI badge

Watch an asset

Choose a surface

Authenticate

Key routes

Try it without a key

Next steps