NexusPay Docs

{
  "success": true,
  "data": { ... }
}

// On error:
{
  "success": false,
  "error": "Human-readable message"
}

curl https://nexuspay.app/api/wallets \
  -H "X-Api-Key: nxp_live_sk_•••••••••••••••"

curl https://nexuspay.app/api/wallets \
  -H "X-Api-Key: nxp_live_sk_•••"

{
  "success": true,
  "data": [
    {
      "agentId": "agent-alpha",
      "address": "0x7a3f...8b2c",
      "balanceUsdc": 245.50,
      "status": "ACTIVE",
      "createdAt": "2025-03-01T10:00:00Z"
    }
  ]
}

curl -X POST https://nexuspay.app/api/wallets \
  -H "X-Api-Key: nxp_live_sk_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent-gamma",
    "initialBalanceUsdc": 50.00
  }'

{
  "success": true,
  "data": {
    "agentId": "agent-gamma",
    "address": "0x9c1d...3f7a",
    "balanceUsdc": 50.00,
    "status": "ACTIVE",
    "createdAt": "2026-04-01T12:00:00Z"
  }
}

curl "https://nexuspay.app/api/transactions?agentId=agent-alpha&status=CONFIRMED" \
  -H "X-Api-Key: nxp_live_sk_•••"

curl -X POST https://nexuspay.app/api/transactions \
  -H "X-Api-Key: nxp_live_sk_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "fromAgentId": "agent-alpha",
    "toAddress": "0x9b2e...4d1a",
    "amountUsdc": 12.50,
    "category": "compute",
    "metadata": { "jobId": "job_7f3a" }
  }'

{
  "success": true,
  "data": {
    "id": "tx_AbCdEfGhI",
    "fromAgentId": "agent-alpha",
    "toAddress": "0x9b2e...4d1a",
    "amountUsdc": 12.50,
    "status": "CONFIRMED",
    "txHash": "0x8f2a...c91e",
    "category": "compute",
    "createdAt": "2026-04-01T12:01:00Z"
  }
}

curl -X POST https://nexuspay.app/api/p2p \
  -H "X-Api-Key: nxp_live_sk_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "fromAgentId": "agent-alpha",
    "toAgentId": "agent-beta",
    "amountUsdc": 5.00,
    "memo": "Tool access fee"
  }'

{
  "success": true,
  "data": {
    "id": "tx_P2pXyZ123",
    "fromAgentId": "agent-alpha",
    "toAgentId": "agent-beta",
    "amountUsdc": 5.00,
    "isP2P": true,
    "status": "CONFIRMED",
    "memo": "Tool access fee",
    "createdAt": "2026-04-01T12:05:00Z"
  }
}

curl https://nexuspay.app/api/policies \
  -H "X-Api-Key: nxp_live_sk_•••"

curl -X POST https://nexuspay.app/api/policies \
  -H "X-Api-Key: nxp_live_sk_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent-gamma",
    "tier": "MODERATE",
    "maxPerTransactionUsdc": 25.00,
    "dailyLimitUsdc": 150.00,
    "allowedCategories": ["compute", "storage"]
  }'

curl https://nexuspay.app/api/x402 \
  -H "X-Api-Key: nxp_live_sk_•••"

curl -X POST https://nexuspay.app/api/x402 \
  -H "X-Api-Key: nxp_live_sk_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "/api/premium/inference",
    "priceUsdc": 0.001,
    "description": "GPT-4o inference endpoint"
  }'

{
  "success": true,
  "data": {
    "id": "ep_Mnop789",
    "path": "/api/premium/inference",
    "priceUsdc": 0.001,
    "description": "GPT-4o inference endpoint",
    "active": true,
    "createdAt": "2026-04-01T12:10:00Z"
  }
}

{
  "success": true,
  "data": {
    "valid": true,
    "agentId": "agent-alpha",
    "claims": { "role": "buyer" },
    "expiresAt": "2026-04-01T13:00:00Z"
  }
}

{
  "success": true,
  "data": {
    "id": "key_QrSt456",
    "agentId": "agent-alpha",
    "key": "nxp_live_sk_AbCdEfGhIjKlMnOpQr",
    "label": "production key",
    "createdAt": "2026-04-01T12:15:00Z"
  }
}

npm install nexuspay-agentkit @coinbase/agentkit

import { AgentKit } from "@coinbase/agentkit";
import { getLangChainTools } from "@coinbase/agentkit-langchain";
import { nexusPayActionProvider } from "nexuspay-agentkit";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { ChatOpenAI } from "@langchain/openai";

const agentKit = await AgentKit.from({
  cdpApiKeyName: process.env.CDP_API_KEY_NAME!,
  cdpApiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY!,
  actionProviders: [
    nexusPayActionProvider({
      baseUrl: process.env.NEXUSPAY_URL!,    // your NexusPay deployment
      apiKey: process.env.NEXUSPAY_API_KEY!, // from Dashboard → API Keys
    }),
  ],
});

const tools = await getLangChainTools(agentKit);
const agent = createReactAgent({
  llm: new ChatOpenAI({ model: "gpt-4o" }),
  tools,
});

"Check the balance of agent-researcher before sending the payment"
"Transfer $2.50 to agent-writer for the content it generated"
"Pay the inference API at /api/premium/gpt4 using agent-alpha's wallet"
"Set a $10 daily limit on agent-beta's spending"
"Show me the last 10 transactions from agent-alpha"

// Agent B just completed its task — pay it from the orchestrator
await agent.invoke({
  messages: [{
    role: "user",
    content: `
      Agent B finished the data analysis task.
      Transfer $5 USDC from agent-orchestrator to agent-analyst as payment.
      Then confirm the remaining balance on agent-orchestrator.
    `,
  }],
});

// The agent will call:
//   nexuspay_p2p_transfer({ fromAgentId: "agent-orchestrator", toAgentId: "agent-analyst", amountUsdc: 5 })
//   nexuspay_get_balance({ agentId: "agent-orchestrator" })

Create your first agent wallet and start sending USDC payments in minutes.