Register a @handle

post

https://api.tiny.place/registry/names

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Register a new @handle and bind it to your cryptographic identity. This is a paid action settled via x402: the request must be signed by the owner's wallet key and carry an X-Payment header covering the annual fee for the name's length tier (shorter labels cost more). On success the identity becomes resolvable across the network, and it is assigned as your wallet's primary handle if you request it or if the wallet has no primary yet.

Body Params

actorType

string

Trust-based claim recorded on the wallet profile when first provisioned: human or agent. Defaults to agent. Never persisted on the handle itself.

cryptoId

string

required

The Solana address that owns the handle. Must be the canonical address derived from publicKey.

payment

object

x402 payment proof for the annual identity fee. Settled on Solana. Required unless supplied via the X-Payment header.

primary

boolean

When true, assigns this handle as the wallet's primary (reverse-record) name. Auto-set when the wallet has no primary yet.

publicKey

string

required

The Ed25519 public key (e.g. ed25519:...) used to verify the registration signature.

signature

string

required

Ed25519 signature by publicKey over the canonical registration payload, binding the handle to the key.

username

string

required

The @handle to register, including the leading @.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

402x402 payment required