NodeMatrix API Documentation
Professional blockchain token analysis API. Build on-chain flows, deploy bots, and generate APIs - all without code. Powered by Monad parallel execution.
API v2 Coming Soon
We're launching API v2 with numerous new endpoints and deep integrations across our ecosystem. Connect seamlessly with NodeMatrix Flow, MatrixDocs, and upcoming products.
Deprecation Notice: Some legacy endpoints will be deprecated in v2. We recommend migrating to the new Node-based endpoints.
API Key Configuration
Overview
The NodeMatrix API provides comprehensive token analysis and security scanning capabilities. Our API uses advanced AI and multiple data sources to analyze cryptocurrency tokens across various blockchain networks.
Powered by Monad Parallel Execution
NodeMatrix leverages Monad's parallel transaction processing to enable simultaneous transactions from the same wallet, making complex on-chain flows possible. Build visual node flows, deploy Telegram bots, create APIs, and launch backends - all without writing code.
Base URL
What You Can Build
Create complex on-chain workflows by connecting nodes visually. No coding required.
Deploy your flows as Telegram bots instantly. Perfect for trading bots and community tools.
Generate REST APIs from your visual flows. Get instant endpoints for integration.
Host flows as persistent backend services with automatic scaling.
Supported Networks
Monad (monad)
Main Ethereum network
Base Layer 2 network
Binance Smart Chain
Solana blockchain
Authentication
All API requests require authentication using an API key. Include your API key in the request headers:
Getting an API Key
10 scans, 7 days - Free
Purchase through our buy page
Contact our team for access
Rate Limiting
Our API implements comprehensive rate limiting to ensure fair usage and prevent abuse:
Global Limits
- Concurrent Requests: 50 maximum across all users
- Per Minute: 300 requests maximum globally
External API Protection
- EVA API: 4 RPS, 8 burst capacity
- GoPlus API: 8 RPS, 16 burst capacity
- DexScreener: 12 RPS, 24 burst capacity
- Etherscan: 4 RPS, 8 burst capacity
Rate Limit Headers
Rate Limit Response
Node Operations
Manage and execute individual nodes in your visual flows. Nodes are the building blocks of NodeMatrix workflows.
Retrieve a list of all available node types that can be used in your flows. Each node represents a specific operation or function.
Response Example
{
"success": true,
"nodes": [
{
"id": "monad_transaction",
"name": "Monad Transaction",
"type": "transaction",
"description": "Execute a transaction on Monad chain",
"category": "blockchain",
"inputs": [
{"name": "to", "type": "address"},
{"name": "amount", "type": "number"}
],
"outputs": [
{"name": "tx_hash", "type": "string"}
]
},
{
"id": "telegram_send",
"name": "Send Telegram Message",
"type": "telegram",
"description": "Send a message via Telegram bot",
"category": "communication"
}
]
}
Create a new node instance in a flow. Nodes can be configured with specific parameters and connected to other nodes.
Request Parameters
Update an existing node's configuration or position in the flow.
Path Parameters
Request Parameters
Remove a node from a flow. All connections to this node will also be removed.
Path Parameters
Execute a single node with provided input data. Useful for testing nodes independently before adding them to flows.
Path Parameters
Request Parameters
Flow Management
Create and manage visual node flows. Flows are collections of connected nodes that form complete workflows.
Get a list of all flows created by the authenticated user.
Query Parameters
Create a new visual flow. Flows start empty and nodes are added via the node endpoints.
Request Parameters
Update flow metadata (name, description) or flow configuration.
Path Parameters
Permanently delete a flow and all its nodes. This action cannot be undone.
Path Parameters
Execute a complete flow. Nodes will execute in order based on their connections. Powered by Monad's parallel execution for optimal performance.
Path Parameters
Request Parameters
Node Connections
Connect nodes together to create data flow paths. Connections define how data moves between nodes in a flow.
Create a connection between two nodes in a flow. Connections link output ports of source nodes to input ports of target nodes.
Path Parameters
Request Parameters
Update connection endpoints or add data transformation rules.
Path Parameters
Remove a connection between two nodes.
Path Parameters
Validate a flow's structure, checking for circular dependencies, missing connections, and type mismatches.
Path Parameters
{
"valid": true,
"errors": [],
"warnings": [
"Node 'monitor_contract' has no output connections"
],
"entry_nodes": ["start_node"],
"exit_nodes": ["end_node"]
}
Deployments
Deploy your flows as Telegram bots, REST APIs, or backend services. One flow, multiple deployment options.
Deploy a flow as a Telegram bot. The bot will respond to commands and messages based on your flow logic.
Path Parameters
Request Parameters
Generate a REST API from your flow. Each flow entry point becomes an API endpoint.
Path Parameters
Request Parameters
{
"success": true,
"deployment_id": "deploy_abc123",
"api_url": "https://api.nodematrix.one/flows/deploy_abc123",
"endpoints": [
{
"path": "/execute",
"method": "POST",
"description": "Execute the flow"
}
],
"status": "deploying"
}
Deploy a flow as a serverless backend service. Perfect for complex computations or scheduled tasks.
Path Parameters
Request Parameters
Check the status of a deployment, including health, logs, and performance metrics.
Path Parameters
Legacy Token Analysis
Deprecated in v2Deprecation Notice: These endpoints will be deprecated in API v2. We recommend migrating to Node-based flows for better performance and ecosystem integration. Legacy endpoints will remain available for 6 months after v2 launch.
These endpoints are maintained for backward compatibility. New integrations should use Node-based flows.
This endpoint will be deprecated in API v2. Use Node-based flows instead for better integration with the NodeMatrix ecosystem.
Performs a comprehensive analysis of a token including security, market data, holder analysis, and more. Perfect for integrating into your NodeMatrix flows, Telegram bots, or custom APIs. Works seamlessly with Monad's parallel execution for high-performance on-chain workflows.
Request Parameters
🧪 Test This Endpoint
{
"contract_address": "0x1234567890123456789012345678901234567890",
"chain": "eth"
}
{
"success": true,
"analysis_details": {
"token_data": {
"name": "Example Token",
"symbol": "EXAMPLE",
"decimals": 18,
"description": "A utility token for DeFi",
"description_confidence": 0.9
},
"security_analysis": {
"security_score": 85,
"overall_risk": "LOW",
"eva_analysis": {
"overall_eva_rating": "SAFE",
"is_renounced": true,
"token_name": "Example Token"
},
"goplus_analysis": {
"is_honeypot": false,
"buy_tax": "0.03",
"sell_tax": "0.03"
}
},
"market_analysis": {
"price_usd": 1.25,
"market_cap": 1250000,
"volume_24h": 125000
}
},
"vector_score": 82,
"grade_summary": {
"security_analysis": "A",
"market_analysis": "B",
"holder_analysis": "A"
}
}
Response Codes
This endpoint will be deprecated in API v2. Use Node-based flows instead for better integration with the NodeMatrix ecosystem.
Provides detailed security analysis including EVA AI audit, GoPlus security checks, and comprehensive risk assessment.
Request Parameters
{
"success": true,
"security_analysis": {
"security_score": 85,
"security_grade": "A",
"overall_risk": "LOW",
"eva_analysis": {
"eva_available": true,
"overall_eva_rating": "SAFE",
"is_renounced": true,
"has_owner": false,
"ai_audit_findings": [
{
"severity": "LOW",
"issue": "Standard ERC20 implementation",
"description": "Token follows standard practices"
}
]
},
"goplus_analysis": {
"goplus_available": true,
"is_honeypot": false,
"is_mintable": false,
"buy_tax": "0.03",
"sell_tax": "0.03",
"contract_verified": true
},
"key_findings": [
"✅ Contract ownership renounced",
"✅ Contract verified on blockchain explorer",
"✅ Low transaction taxes (3%)"
]
}
}
This endpoint will be deprecated in API v2. Use Node-based flows instead for better integration with the NodeMatrix ecosystem.
Returns only the NOX scores and grades without detailed analysis data. Faster and more lightweight.
{
"success": true,
"vector_score": 82,
"grade_summary": {
"security_analysis": "A",
"market_analysis": "B",
"holder_analysis": "A",
"wash_trading_analysis": "B",
"sniper_sellers_analysis": "A"
},
"component_scores": {
"security_analysis": 85,
"market_analysis": 78,
"holder_analysis": 88,
"wash_trading_analysis": 72,
"sniper_sellers_analysis": 90
},
"token_data": {
"name": "Example Token",
"symbol": "EXAMPLE",
"description": "A utility token for DeFi"
}
}
Focuses exclusively on security analysis without market or holder data. Optimized for security-focused applications.
{
"success": true,
"security_score": 85,
"security_grade": "A",
"overall_risk": "LOW",
"critical_issues": [],
"critical_override_applied": false,
"key_security_findings": [
"✅ Contract ownership renounced",
"✅ No honeypot detected",
"✅ Contract verified"
],
"token_info": {
"name": "Example Token",
"symbol": "EXAMPLE"
}
}
Feature Endpoints
Direct access to individual analysis features for specialized use cases.
Direct access to the security analysis feature with detailed EVA and GoPlus integration.
Provides market analysis including price data, volume, market cap, and trading metrics.
Analyzes token holder distribution, concentration, and patterns.
Detects potential wash trading patterns and artificial volume inflation.
Identifies sniper bot activity and early seller patterns that may indicate token manipulation.
Analyzes social media presence and community engagement metrics for the token.
Request Parameters
User Management Endpoints
Get usage statistics for your API key including calls made, remaining quota, and usage patterns.
{
"success": true,
"stats": {
"total_calls": 245,
"calls_today": 12,
"calls_this_month": 245,
"remaining_quota": 755,
"plan": "pro",
"quota_reset_date": "2024-02-01T00:00:00Z"
}
}
Get your recent API calls history with timestamps and endpoints accessed.
Query Parameters
Get API keys associated with a wallet address.
Query Parameters
Create a new API key for a wallet address.
Request Parameters
Get usage statistics for a specific wallet address.
Query Parameters
Monetization Endpoints
Generate a free test API key with limited usage (10 scans, 7 days expiry).
Request Parameters
{
"success": true,
"api_key": "test_1234567890abcdef",
"quota": 10,
"expires_at": "2024-01-15T00:00:00Z",
"plan": "test"
}
Purchase an API plan and receive an API key.
Request Parameters
System Endpoints
Get current rate limiting status for all APIs. Helps integrators avoid rate limits by monitoring system load.
{
"status": "success",
"rate_limits": {
"global_stats": {
"current_concurrent": 12,
"requests_this_minute": 156,
"max_concurrent_requests": 50
},
"api_usage": {
"eva": {
"requests_today": 1250,
"daily_limit": 10000,
"remaining_daily": 8750,
"rate_limit_hits": 0,
"status": "healthy"
},
"goplus": {
"requests_today": 2100,
"daily_limit": 50000,
"remaining_daily": 47900,
"rate_limit_hits": 2,
"status": "healthy"
}
}
},
"recommendations": [],
"integrator_guidelines": {
"max_concurrent_requests": 10,
"requests_per_minute": 60,
"retry_delay_seconds": 5,
"batch_size": 5
}
}
Basic health check endpoint to verify API availability.
{
"status": "healthy",
"timestamp": "2024-01-08T12:00:00Z",
"version": "1.0.0",
"uptime": "5 days, 12:34:56",
"services": {
"database": "connected",
"eva_api": "operational",
"goplus_api": "operational",
"dexscreener_api": "operational"
}
}