API & Technical

Backend architecture and API reference

API Base URL

https://api.nodematrix.one

Authentication

API requests require authentication via session token obtained through the web interface. Direct API access for external applications is planned for future releases.

Core Endpoints

Endpoint	Method	Description
/api/flow/execute	POST	Execute current workflow
/api/flow/save	POST	Save workflow to storage
/api/flow/load	GET	Load saved workflow
/api/flow/export	GET	Export workflow as JSON
/api/config/run	GET/POST	Get/Update RunConfig
/api/config/global	GET/POST	Get/Update GlobalConfig
/api/wallets/balance	GET	Fetch wallet balances
/api/wallets/import	POST	Import wallets from private keys

State Management

RunConfig

Per-run state that changes during execution

• Token addresses
• Transaction hashes
• Wallet balances
• Execution status

GlobalConfig

Persistent settings across all runs

• API keys (Twitter, Telegram)
• RPC endpoints
• Default gas settings
• Notification preferences

Example: Execute Flow

const response = await fetch('https://api.nodematrix.one/api/flow/execute', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <session_token>'
  },
  body: JSON.stringify({
    flowId: 'current',
    chain: 'monad',
    runId: 1
  })
});

const result = await response.json();
// { success: true, executionId: "exec_123", status: "running" }