Embed & Hosted Pages

Not every integrator wants to run npm install and wire up a backend. Orkid provides two zero-code integration paths.

Hosted swap pages

The simplest option — we host a branded swap page for you at orkidlabs.xyz/hosted/[your-slug].

Your page reads branding config from your partner account (brand name, logo, colors, supported chains, default tokens). You just link to it.

Example: orkidlabs.xyz/hosted/alternatefutures

To set up your hosted page, contact api@orkidlabs.com with:

• Your brand name and logo URL
• Your preferred colors (primary, background, card)
• Which chains you want to support
• Default token pair and amount

Embed generator

For partners who want the widget on their own site but don't want to write code:

1. Go to the embed generator
2. Pick your chains, colors, brand name, and default tokens
3. Choose iframe or script embed
4. Copy the generated code
5. Paste it into your site's HTML

The iframe embed is a single <iframe> tag — no JavaScript, no build step, no dependencies.

The script embed loads the widget from Orkid's CDN and mounts it into a <div> on your page. More flexible, but requires a <script type="module"> tag.

API key for production

Both embed options work without an API key for basic quoting in the browser. For production swaps with execution, you need a partner API key.

• Get a key instantly at orkidlabs.xyz/partner (free tier) — or contact api@orkidlabs.com for higher tiers
• Set up a partner proxy on your backend that forwards requests with your X-ORKID-API-Key header
• Never expose your production API key in client-side code

See Authentication for details.

White-label React widget

If you're comfortable with React and want full control:

npm install @orkid-labs/widget @orkid-labs/sdk wagmi viem @tanstack/react-query

The widget supports both same-chain swaps and cross-chain bridging (since 0.3.0). A destination-chain selector appears next to the output row — bridging engages whenever the destination differs from the origin chain, using the non-custodial bridge flow: curated tokens, approval + deposit signing from the user's wallet, and live pending/filled/expired/refunded status. Listen with onBridgeQuote and onBridgeSubmitted callbacks.

See the SDK reference for the full widget API.