API reference

An index of the Noderr APIs, with shared rules for authentication, rate limits and errors.

Planned. Examples that use api.noderr.xyz describe the planned public API, which is not yet live. The live API is https://agent.noderr.xyz. See the Agent Protocol API Reference.

Available APIs

Base URLs

Quick start

REST

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

WebSocket

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

GraphQL

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

Authentication

Most read endpoints are public and need no authentication. Write operations need a 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

The @noderr/sdk package is planned and not yet published. See the SDK Reference.

npm install @noderr/sdk

Last updated: June 2026