API Reference

Complete REST API documentation for X1NS with interactive testing.

Base URL

https://api.x1ns.xyz

All endpoints are prefixed with /api.

Rate Limits

Default: 100 requests/minute per IP
No authentication required for public endpoints

Interactive API Explorer

Test our APIs directly from the documentation!

Resolve Domain

GET/api/resolve/:domain

Resolve a domain name to its owner address

Try it out:

curl https://api.x1ns.xyz/api/resolve/alice.x1

Get Price

GET/api/price/:name

Get the registration price for a domain name based on length

Try it out:

curl https://api.x1ns.xyz/api/price/example

Check Availability

GET/api/available/:domain

Check if a domain is available for registration

Try it out:

curl https://api.x1ns.xyz/api/available/newdomain.x1

Reverse Lookup

GET/api/reverse/:address

Get all domains owned by a wallet address

Try it out:

curl https://api.x1ns.xyz/api/reverse/DEQWNRhQmNg7T6UQxV8d2oJAanFHBu9YkNyXDb7GvzvA

Get Primary Domain

GET/api/primary/:address

Get the primary domain set by a wallet owner

Try it out:

curl https://api.x1ns.xyz/api/primary/DEQWNRhQmNg7T6UQxV8d2oJAanFHBu9YkNyXDb7GvzvA

Get Domain Records

GET/api/records/:domain

Get all blockchain address records for a domain

Try it out:

curl https://api.x1ns.xyz/api/records/alice.x1

Get Profile

GET/api/profile/:domain

Get complete profile data for a domain including social links

Try it out:

curl https://api.x1ns.xyz/api/profile/alice.x1

Get Subdomains

GET/api/subdomains/:domain

Get all subdomains under a parent domain

Try it out:

curl https://api.x1ns.xyz/api/subdomains/alice.x1

Marketplace APIs

Get Marketplace Listing

GET/api/marketplace/listing/:domain

Get marketplace listing details for a specific domain

Try it out:

curl https://api.x1ns.xyz/api/marketplace/listing/premium.x1

Get All Marketplace Listings

GET/api/marketplace/listings

Get all active marketplace listings with optional filters

Try it out:

curl https://api.x1ns.xyz/api/marketplace/listings

Analytics APIs

Sales Statistics

GET/api/sales/stats

Get comprehensive marketplace sales statistics

Try it out:

curl https://api.x1ns.xyz/api/sales/stats

Recent Sales

GET/api/sales/recent

Get recent marketplace sales with pagination

Try it out:

curl https://api.x1ns.xyz/api/sales/recent

Recent Registrations

GET/api/registrations/recent

Get recently registered domains

Try it out:

curl https://api.x1ns.xyz/api/registrations/recent

Recent Tokenizations

GET/api/tokenizations/recent

Get recently tokenized domains (converted to NFTs)

Try it out:

curl https://api.x1ns.xyz/api/tokenizations/recent

Recent Listings

GET/api/listings/recent

Get recently created marketplace listings

Try it out:

curl https://api.x1ns.xyz/api/listings/recent

Quick Reference

All X1NS APIs are:

✅ Free to use - No API keys required
✅ Rate limited - 100 requests/minute per IP
✅ CORS enabled - Use from any domain
✅ JSON responses - All endpoints return JSON
✅ RESTful - Standard HTTP methods

For SDK integration, check out our TypeScript SDK.

SDK Reference Smart Contracts