Linkem

Documentation

Everything you need to build and customize your Linkem profile. Explore guides, API reference, and more.

Getting Started

Everything you need to launch your Linkem profile in under 2 minutes.

Linkem is the link-in-bio platform built for the Solana ecosystem. Share your tokens, trades, wallet, and content — all from one clean, customizable page at linkem.to/@yourname.

One Link

Consolidate all your socials, content, and crypto into a single URL.

Solana Native

Display favorite tokens with live prices, wallet address, and donations.

Fully Customizable

Choose themes, accent colors, link shapes, and background gradients.

Secure Auth

Log in with Privy using email, X, or your Solana wallet.

Quick Start

Head to linkem.to, type your desired username in the hero input, and click Claim your Linkem. You'll be live in minutes.

Create Account

Sign in with Privy using email, X, or a Solana wallet.

Option A: Email or X

1

Click Login

Open the login modal from the top navbar.

2

Choose a method

Pick email for a one-time passcode or continue with X inside the Privy modal.

3

Complete verification

Finish the OTP or OAuth step. Linkem mints a secure local session after Privy verifies you.

4

Claim your username

If this is your first login, you'll be redirected to the claim page to lock in your @handle.

Option B: Solana Wallet

1

Open the Privy modal

Click login and choose the wallet path.

2

Select your wallet

Phantom, Solflare, and Backpack are shown first for Solana logins.

3

Approve the signature

Privy verifies the connected wallet and Linkem exchanges the Privy access token for your local session.

4

Claim your handle

First-time sign-ins land on the claim page so you can choose your public @handle.

Privy Auth

Authentication is powered by Privy. Linkem verifies Privy access tokens on the server, then issues an httpOnly app session cookie for dashboard and claim routes. No wallet private keys ever touch our servers.

Claim Username

Lock in your unique linkem.to/@handle.

After creating your account, you'll land on the claim page. Type in your desired username and we'll check availability in real time.

Username Rules

RuleDetail
Length3 – 20 characters
CharactersLetters, numbers, underscores, hyphens
CaseCase-insensitive (stored lowercase)
Reservedlinkem, admin, api, system, support, help
text
linkem.to/@yourname
linkem.to/@crypto_trader
linkem.to/@sol-degen
Username Changes

You can change your username later from the dashboard sidebar, but there's a 7-day cooldown between changes. Choose wisely the first time!

Onboarding

A guided 5-step wizard to set up your profile.

1

Choose your goal

Select your primary use case: Influencer (build following), Trader (share plays & alpha), or Trencher (hunt memecoins).

2

Pick a template

Choose from 4 color themes — Degen Purple, Ocean Trader, Green Gains, or Fire Red. Each comes with a preset accent color, background, and sample links.

3

Select platforms

Toggle which social platforms to display on your profile: Twitter/X, Instagram, YouTube, TikTok, Telegram, Discord, and more.

4

Personalize

Upload a profile picture (max 5MB), set your display name, and write a bio.

5

Preview & launch

See a live preview of your Linkem with a confetti celebration. Your profile is auto-published when you complete onboarding.

Skip & Come Back

Every step except the goal selection can be skipped. You can always customize everything later from the dashboard.

Dashboard

Your command center for managing everything.

The dashboard at /dashboard gives you a 4-tab editor on the left and a real-time preview of your public profile on the right (45% of viewport).

Links Tab

Add, edit, reorder, and animate your custom links.

Profile Tab

Upload avatar, set display name, write bio, add social handles.

Blockchain Tab

Add favorite tokens, wallet address, KOL, and donation wallet.

Design Tab

Choose background theme, accent color, and link shape.

Dashboard Controls

ActionWhat it does
SavePersists all your changes without publishing
PublishMakes your profile live at linkem.to/@you
View My LinkemOpens your public profile in a new tab

Profile Setup

Make your Linkem uniquely yours.

Profile Picture

Upload any image up to 5MB. Supported formats: JPG, PNG, GIF, WebP. Images are hosted via ImgBB for fast global delivery.

Display Name

Up to 80 characters. This appears as the large heading on your profile. If left blank, your @username is shown instead.

Bio

Up to 280 characters. A short description that appears below your display name.

Social Handles

Enter your handle or full URL for each platform. If you enter a handle (e.g. @yourname), Linkem automatically builds the correct platform URL.

text
Twitter/X:   @handle → https://x.com/handle
Instagram:   @handle → https://instagram.com/handle
YouTube:     @handle → https://youtube.com/@handle
TikTok:      @handle → https://tiktok.com/@handle
Telegram:    handle  → https://t.me/handle
Threads:     @handle → https://threads.net/@handle

Design & Themes

Customize every visual detail of your profile.

Background Themes

Dark (Default)
Ocean Blue
Purple Haze
Forest Green
Dark Red
Midnight Purple

Accent Color

Your accent color is used for link borders, social icons, avatar ring, token badges, and CTA buttons. Pick any hex color using the color picker or type it directly.

text
Default:      #86efac  (Linkem green)
Degen Purple: #a88bc4
Ocean Trader: #5b9cd6
Green Gains:  #6bc59e
Fire Red:     #ff6b7a

Link Shapes

Rounded
Square
Pill

Blockchain Features

Showcase your on-chain presence.

Favorite Tokens

Browse trending tokens or search by contract address. Display up to 12 with live prices and 24h change.

Wallet Address

Display your Solana wallet with a one-click copy button. Validated against base58 format.

Favorite KOL

Tag your preferred Key Opinion Leader (e.g. @ansem) for social proof.

SOL Donations

Add a donation wallet and visitors can copy it to send you SOL directly.

Adding Tokens

1

Open Blockchain tab

In the dashboard, switch to the Blockchain tab.

2

Browse or search

Browse the top 20 trending Solana tokens, or paste a contract address to search.

3

Add to favorites

Click the + button on any token. It appears as a badge on your profile with live price data from Birdeye.

Data Source

Token prices, 24h change percentages, and wallet portfolio data are all fetched from the Birdeye API with a 5-minute server-side cache for trending tokens.

Supported Platforms

All the platforms you can link from your Linkem.

PlatformHandle FormatGenerated URL
Twitter / X@handlex.com/handle
Instagram@handleinstagram.com/handle
YouTube@handleyoutube.com/@handle
TikTok@handletiktok.com/@handle
Facebookhandlefacebook.com/handle
Threads@handlethreads.net/@handle
Telegramhandlet.me/handle
WhatsAppnumberwa.me/number
DiscordFull invite URL
SpotifyFull profile/playlist URL
Axiom@handleaxiom.trade/@handle
WebsiteFull URL

Templates

Pre-built themes to jump-start your profile.

Templates are available during onboarding and set your accent color, background gradient, link shape, and 3 sample links. You can customize everything after applying a template.

Degen Purple

For the purple pilled degen. Rounded links with pulse and glow animations.

Ocean Trader

Cool blue for traders. Pill-shaped links with slide and bounce.

Green Gains

For the profit takers. Square links with sparkle and glow.

Fire Red

Bold and aggressive. Rounded links with pulse and bounce.

API Reference

All endpoints powering Linkem.

Authentication

POST/api/auth/privyExchange a verified Privy access token for a Linkem session
POST/api/auth/logoutClear the current Linkem session
GET/api/auth/sessionCheck current session

Link Management

POST/api/link/claimClaim a username
GET/api/link/check?username=Check username availability
GET/api/link/get?username=Fetch a public profile
POST/api/link/updateSave profile/link/design data
GET/api/link/updateGet authenticated user's link
POST/api/link/publishPublish profile to go live

Blockchain Data

GET/api/birdeye/token?address=Look up token by contract address
GET/api/birdeye/wallet?wallet=Fetch wallet token holdings
GET/api/birdeye/trendingTop 20 trending Solana tokens

User & Upload

GET/api/user/profileGet user profile + onboarding status
POST/api/user/complete-onboardingMark onboarding done + auto-publish
POST/api/upload/imageUpload image (max 5MB) to ImgBB

Example: Fetch a Public Profile

javascript
const res = await fetch('https://linkem.to/api/link/get?username=yourname');
const data = await res.json();

console.log(data.linkemLink);
// {
//   id: "abc123",
//   username: "yourname",
//   displayName: "Your Display Name",
//   bio: "Solana degen & builder",
//   avatar: "https://...",
//   links: [...],
//   platformLinks: { twitter: "@handle", ... },
//   blockchainData: { favoriteTokens: [...], ... },
//   customColor: "#86efac",
//   background: "default",
//   linkShape: "rounded",
//   published: true
// }

Security

How we keep your data safe.

LayerImplementation
SessionsJWT (HS256) with 7-day expiry. Stored as httpOnly, secure cookies.
Privy AuthPrivy access tokens are verified server-side before Linkem creates a local session.
Input ValidationAll user input is server-side sanitized: length limits, URL validation, allowlists for animations/shapes/platforms, hex color validation.

Server-Side Validation

Every field submitted to the update endpoint is validated and sanitized:

text
Display name:    max 80 characters
Bio:             max 280 characters
Link titles:     max 80 characters
Token symbols:   max 16 characters
Token names:     max 80 characters
Tokens:          max 12 per profile
Portfolio:       max 50 items
URLs:            must be http:// or https://
Wallet address:  base58, 32-44 characters
Hex colors:      must match #[0-9a-fA-F]{6}
Animations:      none | pulse | bounce | glow | slide | sparkle
Link shapes:     rounded | square | pill

FAQ

Common questions answered.

Is Linkem free?

Yes. Linkem is completely free to use. Create your profile, add unlimited links, and customize your design at no cost.

Can I use Linkem without a Solana wallet?

Absolutely. You can log in with email or X through Privy and add blockchain features later if you want them.

How do I change my username?

Go to the dashboard sidebar, click your username, type the new one and save. There's a 7-day cooldown between changes.

Are token prices real-time?

Token data is fetched from the Birdeye API with a 5-minute server-side cache for trending tokens. Individual token lookups are fresh on each request.

Can I use a custom domain?

Not yet. All profiles are served from linkem.to/@username. Custom domains are on our roadmap.

What wallets are supported?

The login flow is configured for Solana wallets, with Phantom, Solflare, and Backpack shown first.

How do I delete my account?

Contact us on Twitter @linkem for account deletion requests.