📡 API Documentation

Integra RentNFT en tus aplicaciones. API RESTful con autenticación por API Key, respuestas en JSON y rate limiting inteligente.

Tu API Key:

1000

Requests/min

99.9%

Uptime

<50ms

Latencia

Autenticación

Incluye tu API Key en el header de cada request:

curl -H "Authorization: Bearer rnft_live_sk_YOUR_KEY" \
     -H "Content-Type: application/json" \
     https://api.rentnft.com/v2/nfts

Rate Limits

Los límites varían según tu plan:

Plan	Requests/min	Requests/día
Free	60	10,000
Pro	300	100,000
Enterprise	1,000	Ilimitado

Endpoints: NFTs

GET/v2/nftsListar NFTs

Param	Tipo	Descripción
server	string	Filtrar por servidor (ej: SA-051)
category	string	weapon, armor, spirit, mount
min_price	number	Precio mínimo USD
max_price	number	Precio máximo USD
page	integer	Página (default: 1)

{
  "data": [
    {
      "id": "nft_abc123",
      "name": "Espada Legendaria del Dragón",
      "category": "weapon",
      "price": 2450.00,
      "server": "SA-051",
      "seller": "warrior_99",
      "rarity": "legendary"
    }
  ],
  "pagination": {"page": 1, "total": 234}
}

GET/v2/nfts/:idDetalle de NFT

{
  "id": "nft_abc123",
  "name": "Espada Legendaria del Dragón",
  "price": 2450.00,
  "description": "Nivel 9, +45 ATK",
  "images": ["..."],
  "seller": {"username": "warrior_99", "rating": 4.9},
  "created_at": "2026-06-15T10:30:00Z"
}

POST/v2/nftsPublicar NFT

Campo	Tipo	Requerido
name	string	SI
category	string	SI
price	number	SI
server	string	SI
description	string	No

// Response 201 Created
{
  "id": "nft_xyz789",
  "status": "active",
  "message": "NFT publicado exitosamente"
}

Endpoints: Gold

GET/v2/gold/pricesPrecios de Gold por servidor

{
  "prices": [
    {"server": "SA-051", "price_per_1m": 95.00, "available": "450M"},
    {"server": "EU-021", "price_per_1m": 102.50, "available": "320M"}
  ]
}

POST/v2/gold/buyComprar Gold

Campo	Tipo	Requerido
server	string	SI
amount	string	SI (ej: "10M")
character_name	string	SI

// Response
{"order_id": "ord_123", "total": 950.00, "status": "escrow"}

Endpoints: WEMIX

GET/v2/wemix/pricePrecio actual de WEMIX

{"price_usd": 1.847, "change_24h": 3.2, "volume_24h": 2450000}

Endpoints: Usuarios

GET/v2/users/meMi perfil

{
  "id": "usr_42",
  "username": "player42",
  "email": "player@mail.com",
  "balance": {"usd": 3240.50, "wemix": 1250},
  "kyc_verified": true
}

Endpoints: Trades

GET/v2/tradesHistorial de trades

{
  "trades": [
    {"id":"trd_1","type":"buy","item":"Espada Legendaria","amount":2450,"status":"completed","date":"2026-06-15"}
  ]
}

Códigos de Error

Código	Significado
400	Request inválido - parámetros incorrectos
401	No autenticado - API Key inválida
403	Prohibido - sin permisos
404	Recurso no encontrado
429	Rate limit excedido
500	Error interno del servidor

Webhooks

Recibe notificaciones en tiempo real cuando ocurran eventos:

POST https://tu-servidor.com/webhook

{
  "event": "trade.completed",
  "data": {
    "trade_id": "trd_123",
    "amount": 2450.00,
    "buyer": "player42"
  },
  "timestamp": "2026-06-15T10:30:00Z"
}

Eventos disponibles: trade.completed, trade.cancelled, nft.sold, gold.delivered, escrow.released

¿Necesitas ayuda con la integración?