n8n-nodes-api3

[Velocity BPA Licensing Notice]

This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).

Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.

For licensing information, visit https://velobpa.com/licensing or contact licensing@velobpa.com.

A comprehensive n8n community node for API3 decentralized oracle protocol providing 10 resources and 50+ operations for dAPIs, Airnodes, OEV auctions, DAO governance, and staking. Includes multi-chain support and poll-based triggers.

Features

• dAPIs (Decentralized APIs): Read price feeds, get feed info, list available feeds, check deviation thresholds
• Data Feeds: Read raw data feeds by ID, get historical values, batch read multiple feeds
• Airnodes: Get Airnode info, list available nodes, make Airnode requests
• OEV (Oracle Extractable Value): Get OEV network info, view auctions, place bids
• API3 DAO: Get staking info, user stake, stake/unstake tokens, claim rewards
• Governance: Get proposals, vote on proposals, check vote records, view treasury
• API3 Token: Get price, supply info, user balances, transfer tokens
• Insurance/Coverage: Get policy info, available coverage, claims history
• Subscriptions: Manage dAPI subscriptions
• Utilities: Get supported chains, contract addresses, encode parameters, health checks
• Triggers: Poll-based triggers for price updates, deviation thresholds, auctions, proposals, and rewards

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Click Install
3. Enter n8n-nodes-api3
4. Click Install

Manual Installation

# Navigate to your n8n custom nodes directory
cd ~/.n8n/custom

# Install the package
npm install n8n-nodes-api3

Development Installation

# Clone the repository
git clone https://github.com/Velocity-BPA/n8n-nodes-api3.git
cd n8n-nodes-api3

# Install dependencies
npm install

# Build the project
npm run build

# Create symlink to n8n custom nodes
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-api3

# Restart n8n

Credentials Setup

Create API3 credentials in n8n with the following fields:

Getting an RPC Endpoint

You can use free RPC endpoints from:

• Alchemy
• Infura
• QuickNode
• Ankr

Or use public endpoints (rate limited):

• Ethereum: https://eth.llamarpc.com
• Polygon: https://polygon-rpc.com
• Arbitrum: https://arb1.arbitrum.io/rpc

Resources & Operations

dAPIs

Data Feeds

Airnodes

OEV (Oracle Extractable Value)

API3 DAO

Governance

API3 Token

Insurance (Coverage)

Subscriptions

Utility

Trigger Node

The API3 Trigger node polls for events at configurable intervals:

Usage Examples

Read ETH/USD Price

{
  "nodes": [
    {
      "name": "API3",
      "type": "n8n-nodes-api3.api3",
      "parameters": {
        "resource": "dapis",
        "operation": "getDAPIValue",
        "dapiName": "ETH/USD"
      }
    }
  ]
}

Get User Staking Info

{
  "nodes": [
    {
      "name": "API3",
      "type": "n8n-nodes-api3.api3",
      "parameters": {
        "resource": "dao",
        "operation": "getUserStake",
        "userAddress": "0x..."
      }
    }
  ]
}

API3 Concepts

Networks

Error Handling

The node provides descriptive error messages for common issues:

• Invalid RPC endpoint: Check your RPC URL and network selection
• Invalid address: Ensure addresses are valid Ethereum addresses (0x...)
• Network not supported: Operation may not be available on selected network
• Private key required: Write operations require a private key
• Rate limited: Consider using a private RPC endpoint

Security Best Practices

1. Never expose private keys - Use n8n credentials storage
2. Use dedicated wallets - Don't use main wallets for automation
3. Test on testnets first - Use Goerli/Sepolia for testing
4. Limit permissions - Only fund wallets with needed amounts
5. Monitor transactions - Set up alerts for wallet activity

Development

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Fix linting issues
npm run lint:fix

# Build
npm run build

# Watch mode
npm run dev

Author

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

Licensing

This n8n community node is licensed under the Business Source License 1.1.

Free Use

Permitted for personal, educational, research, and internal business use.

Commercial Use

Use of this node within any SaaS, PaaS, hosted platform, managed service,
or paid automation offering requires a commercial license.

For licensing inquiries:
licensing@velobpa.com

See LICENSE, COMMERCIAL_LICENSE.md, and LICENSING_FAQ.md for details.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support

• GitHub Issues
• API3 Documentation
• n8n Community

Acknowledgments

• API3 - Decentralized APIs for Web 3.0
• n8n - Workflow automation platform
• Velocity BPA - Business process automation