API Reference

NautPay Routes (Next.js API)

POST /api/agent

Server-side agent endpoint. Parses natural-language payment intent, runs compliance pre-flight, returns structured transaction for wallet signing.

Request:

{
  "message": "Pay 5000 USDC to alice.sol",
  "walletAddress": "7xKXtg...",
  "contacts": [{ "name": "alice", "address": "ABC123..." }]
}

Response (approved):

{
  "intent": {
    "action": "transfer",
    "amount": 5000,
    "token": "USDC",
    "recipient": "alice.sol",
    "confidence": 0.95
  },
  "compliance": {
    "approved": true,
    "risk_score": 0.05,
    "recommendation": "approve"
  },
  "resolved": {
    "from": "7xKXtg...",
    "to": "ABC123...",
    "source": "sns",
    "label": "alice.sol"
  },
  "execute": {
    "action": "transfer",
    "amount": 5000,
    "token": "USDC",
    "recipient": "ABC123..."
  }
}

POST /api/swap

Server-side Jupiter proxy. Avoids CORS issues and dead DNS (quote-api.jup.ag).

Quote request:

{ "action": "quote", "inputToken": "USDC", "outputToken": "EURC", "amount": 1000 }

Transaction request:

{ "action": "transaction", "quote": { ... }, "userPublicKey": "7xKXtg..." }

POST /api/wallet-verify

Server-side proxy for NautLense wallet verification. Adds NAUTLENSE_SERVICE_TOKEN as Bearer auth.

Actions:

{ "action": "status", "wallet_address": "7xKXtg..." }
{ "action": "initiate", "wallet_address": "7xKXtg...", "chain": "solana" }
{ "action": "confirm", "verification_id": "uuid", "signature": "base58..." }

POST /api/kyc/sumsub-token

Sumsub WebSDK access token generation. Returns 503 if Sumsub credentials not configured.

NautLense API (Compliance Engine)

Base URL: https://api.nautlense.com (production) / http://localhost:8090 (local)

Core Transactions

Travel Rule & Compliance

Sanctions Screening

Wallet Verification (Poco)

Emergency

Other