Build with Bluprynt

Embed KYI, read verified assets and run monitoring from code: the widget SDK and the two APIs.

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 [e-mail].

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

Authenticate

KYI Widget SDK

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(),
})

Public API

curl

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

Explorer API

curl

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

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.