NEXUS AI Agent Marketplace - JavaScript/TypeScript SDK

Official JavaScript/TypeScript SDK for the NEXUS AI Agent Marketplace.

Installation

npm install nexus-aimarket-sdk
# or
yarn add nexus-aimarket-sdk

Quick Start

import { NexusClient } from 'nexus-aimarket-sdk';

// Create a client (no auth needed for public endpoints)
const client = new NexusClient();

// Search for services
const services = await client.search({ protocol: 'mcp', sandbox: true });
console.log(`Found ${services.total} services`);

// Get trending
const trending = await client.trending({ limit: 10 });
trending.trending.forEach(svc => {
  console.log(`  ${svc.name}: score ${svc.trending_score}`);
});

// Get registry export
const registry = await client.getRegistry({ protocol: 'aitp' });

Authenticated Operations

import { NexusClient } from 'nexus-aimarket-sdk';

// Create client with API key
const client = new NexusClient({ apiKey: 'nxs_your_api_key' });

// Register a service
const service = await client.registerService({
  name: 'My AI Service',
  description: 'A powerful AI-powered API',
  category: 'ai',
  tags: ['nlp', 'text-generation'],
  pricePerRequest: 0.5,
  sandboxEnabled: true,
  sandboxCallLimit: 50
});
console.log(`Registered: ${service.service_id}`);

// Create webhook subscription
const webhook = await client.createWebhookSubscription({
  url: 'https://my-server.com/webhooks/nexus',
  events: ['service.registered', 'service.trending']
});
console.log(`Webhook secret: ${webhook.secret}`); // Save this!

API Reference

Discovery (No Auth Required)

• search(params) - Search services with filters
• getProtocols() - List supported protocols
• getCategories() - List categories
• getService(serviceId) - Get service details
• getServiceHealth(serviceId) - Get health status

Registry

• getRegistry(params) - Get agents.json export
• getRegistryStats() - Get statistics

Trending

• trending(params) - Get trending services
• hotSandbox(limit) - Get hot sandbox services
• rising(params) - Get fastest growing services

Metrics

• getServiceMetrics(serviceId, period) - Service metrics
• getProtocolMetrics(protocol, period) - Protocol metrics
• getPlatformMetrics(period) - Platform metrics

MCP Gateway

• listTools() - List MCP tools
• executeTool(params) - Execute with payment

Sandbox

• listSandboxServices() - List sandbox services
• executeSandbox(params) - Execute in sandbox (free)
• getSandboxUsage(agentId, serviceId) - Check usage

Agent Management

• registerAgent(params) - Register new agent
• getAgentBalance(agentId) - Check balance
• generatePaymentProof(agentId, amount) - Generate proof

API Keys (Auth Required)

• createApiKey(params) - Create new key
• listApiKeys() - List your keys
• rotateApiKey(keyId) - Rotate key
• revokeApiKey(keyId) - Revoke key

Service Registration (Auth Required)

• registerService(params) - Register service
• listMyServices() - List your services
• updateService(serviceId, updates) - Update service
• requestPromotion(serviceId, justification) - Request production

Webhooks (Auth Required)

• createWebhookSubscription(params) - Subscribe
• listWebhookSubscriptions() - List subscriptions
• deleteWebhookSubscription(id) - Unsubscribe

Error Handling

import { NexusClient, NexusError, NexusRateLimitError, NexusAuthError } from 'nexus-aimarket-sdk';

const client = new NexusClient({ apiKey: 'nxs_...' });

try {
  const result = await client.search({ protocol: 'mcp' });
} catch (error) {
  if (error instanceof NexusAuthError) {
    console.log('Auth failed');
  } else if (error instanceof NexusRateLimitError) {
    console.log(`Rate limited. Retry after ${error.retryAfter} seconds`);
  } else if (error instanceof NexusError) {
    console.log(`API error: ${error.message} (status: ${error.statusCode})`);
  }
}

License

MIT