API Reference

Note: Code examples using api.noderr.xyz reference the planned public API, which is not yet live. For the currently live API, use https://agent.noderr.xyz with the Agent Protocol API Reference.

Complete reference for all Noderr Protocol APIs.

Available APIs

Quick Start

REST API

# Get all vaults
curl https://api.noderr.xyz/v1/vaults
# Get specific vault
curl https://api.noderr.xyz/v1/vaults/0xd62f6c4Fe1444Dafbe3dBd0163C4B77A3C41Af84

WebSocket

const ws = new WebSocket('wss://ws.noderr.xyz/v1');
ws.onopen = () => {
ws.send(JSON.stringify({
type: 'subscribe',
channel: 'vault.updates',
params: { address: '0xd62f6c4Fe1444Dafbe3dBd0163C4B77A3C41Af84' }
}));
};

GraphQL

query {
vaults {
address
name
tvlUsd
apy { current }
}
}

Authentication

Public Endpoints

Most read endpoints are public and require no authentication.

Authenticated Endpoints

Write operations require wallet signature:

const message = `Noderr API Access\nTimestamp: ${Date.now()}`;
const signature = await wallet.signMessage(message);
fetch('https://api.noderr.xyz/v1/user/settings', {
method: 'POST',
headers: {
'X-Wallet-Address': walletAddress,
'X-Signature': signature,
'X-Timestamp': timestamp
},
body: JSON.stringify(settings)
});

Rate Limits

Error Codes

SDK

For easier integration, use our official SDK:

npm install @noderr/sdk

See SDK Reference for full documentation.

Testnet vs Mainnet

Last Updated: December 2025