VARKOS API

Integrate the full power of VARKOS AI agents into your application. Chat, analyze, and automate with 100+ specialists via a simple REST API.

API OPERATIONAL · v1


Base URL: https://varkos.vip/api/v1

◈ OPEN DEVELOPER PORTAL →

Authentication

◈ API KEY REQUIRED

Every request must include your API key. Get one from the Developer Portal.

Usage

// Header (recommended)
x-api-key: vk_v6_your_api_key_here

// Or Bearer token
Authorization: Bearer vk_v6_your_api_key_here

Error Response

{ "error": "API key non valida o non attiva", "docs": "https://varkos.vip/api-docs" }

Plans & Rate Limits

PlanCalls/DayAgentsPrice
Free501€0
Starter2003€29/mo
Pro1,0005€79/mo
Enterprise10,000AllCustom
GET
/api/v1/status

Verifica lo stato del sistema e i dati del tuo account API.

Response

{
  "ok": true,
  "status": "operational",
  "version": "v1",
  "product": "v6",
  "plan": "pro",
  "owner": "user@example.com",
  "usage": { "calls_today": 42, "daily_limit": 1000 },
  "timestamp": "2026-05-26T12:00:00.000Z"
}
GET
/api/v1/agents

Lista tutti gli agenti AI disponibili per il tuo piano.

Response

{
  "ok": true,
  "product": "v6",
  "plan": "pro",
  "agents": [
    { "id": "varkos-001", "name": "VARKOS Assistant", "desc": "Assistente AI generale" },
    { "id": "varkos-analyst", "name": "Market Analyst", "desc": "Analisi mercati e dati" }
  ],
  "total": 2
}
POST
/api/v1/chat

Invia un messaggio a un agente VARKOS e ricevi una risposta AI.

Body

{
  "message": "Analizza il mercato dell'AI nel 2026",  // required
  "agent_id": "varkos-analyst",                       // optional
  "history": [                                         // optional, max 6
    { "role": "user", "content": "Ciao" },
    { "role": "assistant", "content": "Ciao! Come posso aiutarti?" }
  ]
}

Response

{
  "ok": true,
  "reply": "Il mercato AI nel 2026 mostra una crescita del 38%...",
  "agent_id": "varkos-analyst",
  "product": "v6",
  "usage": { "latency_ms": 842, "calls_today": 43, "daily_limit": 1000 }
}

Esempio JavaScript

const response = await fetch('https://varkos.vip/api/v1/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'vk_v6_your_api_key_here'
  },
  body: JSON.stringify({
    message: 'Analizza il mercato dell\'AI nel 2026',
    agent_id: 'varkos-analyst'
  })
})
const data = await response.json()
console.log(data.reply)

Esempio Python

import requests

response = requests.post(
    'https://varkos.vip/api/v1/chat',
    headers={'x-api-key': 'vk_v6_your_api_key_here'},
    json={'message': 'Analizza il mercato AI 2026', 'agent_id': 'varkos-analyst'}
)
print(response.json()['reply'])

Esempio cURL

curl -X POST https://varkos.vip/api/v1/chat \
  -H "Content-Type: application/json" \
  -H "x-api-key: vk_v6_your_api_key_here" \
  -d '{"message":"Analizza il mercato AI 2026"}'
POST
/api/v1/keys

Genera una nuova API key. Richiede JWT VARKOS (login nel portale).

Body

{
  "name": "My App",       // optional — nome descrittivo
  "product": "v6",        // v6 | vix | axis | kozai
  "plan": "starter"       // free | starter | pro | enterprise
}

Response

{
  "ok": true,
  "api_key": "vk_v6_AbCdEf123456...",  // mostrata UNA SOLA VOLTA
  "warning": "Salva questa chiave — non verrà mostrata di nuovo",
  "plan": "starter",
  "product": "v6"
}