Collection embeds

Use the links.embed URL returned by the API. This example uses Woof Pack, a registered KurvDrop verified against the public Base Sepolia catalogue on 7 October 2026. Replace its contract address with your own collection’s contract_address:

<iframe
  src="https://testnet.kurv.fun/embed/84532/0x8354d02d8022f455db9acb235c6f6655c8adabd3"
  title="Woof Pack on KURV"
  loading="lazy"
  width="100%"
  height="420"
  style="max-width:660px;border:0;border-radius:18px"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
></iframe>

For a Solana collection, use https://testnet.kurv.fun/embed/solana:devnet/{address}

The widget shows the collection’s art or teaser, network, supply and confirmed minted count. It refreshes visible chain figures every 15 seconds and marks stale data. It has no account header, navigation, ticker or third-party wallet cookie dependency. On HTTPS sites the display widget may be embedded by any origin; the rest of the KURV app keeps its existing framing restrictions.

The widget’s mint_mode is kurv_wallet_handoff: Mint opens a KURV window for the buyer’s account or wallet, the current price and approval, and the card updates when the mint is through. The iframe does not sign or collect payment. Imported collections that were not launched on KURV open their collection shelf instead.

A collection’s owner finds this snippet ready to paste under Put this mint on your site on the collection page. The widget reads in each visitor’s language; add ?lang=ja to the address to fix one.

Do not remove allow-popups-to-escape-sandbox: wallet authorisation must happen outside the parent site’s iframe sandbox. Set the height to suit your layout; the card is responsive down to a narrow mobile column.

Layout and look

Add choices to the widget’s address. The owner’s Put this mint on your site builds this for you, with a preview:

<iframe
  src="https://testnet.kurv.fun/embed/84532/0x8354d02d8022f455db9acb235c6f6655c8adabd3?layout=compact&theme=light&accent=ff5a1f"
  title="KURV mint"
  loading="lazy"
  width="100%"
  height="150"
  style="max-width:660px;border:0;border-radius:18px"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
></iframe>

Choice	Values
layout	full, compact, art, noart
theme	dark, light
font	system, serif, mono, rounded
accent	Six hex digits with no #, such as ff5a1f: the Mint press
text	Six hex digits with no #, such as 160f2b: the words

Each value is checked on the server against this list, and anything else is the default, so no CSS of your own reaches the card. The address carries the look only: the card reads the collection’s name, art and numbers live, so an edit on KURV reaches it with no change to your code.

The MCP connector provides kurv_embed_code for a deployed address. Use Public APIs to build a custom display, Mint from your page for a button of your own or your own wallet flow, and Mint from your site for the contract itself. Collection figures are snapshots; see Risks and disclaimer.