REST API reference

Endpoints for vault data, strategy information and protocol metrics.

Planned. The api.noderr.xyz public REST/GraphQL/WebSocket API is not yet live. This page documents the planned interface. The live API is https://agent.noderr.xyz. See the Agent Protocol API Reference.

Base URL

https://api.noderr.xyz/v1

For testnet (Base Sepolia):

https://api-testnet.noderr.xyz/v1

Authentication

Read endpoints are public and need no authentication. Write operations need a signed message from a connected wallet.

Rate limits

Tier	Requests/Minute	Requests/Day
Public	60	10,000
Authenticated	300	100,000
Node Operator	1,000	Unlimited

Vaults

Get all vaults

GET /vaults

Returns all active vaults with current metrics.

Response:

Example only. The values are illustrative, not live data.

{
"vaults": [
{
"address": "0x49f747BBac988Cd628a5D79AAdF865EBaDe6a34f",
"name": "Conservative Vault",
"symbol": "nCONS",
"tvl": "1250000000000000000000",
"tvlUsd": 1250000.00,
"apy": 8.5,
"riskLevel": "conservative",
"strategies": 3,
"isERC7540": true,
"fulfillmentDelay": 3600
}
],
"totalTvl": "5000000000000000000000",
"totalTvlUsd": 5000000.00
}

Get vault details

GET /vaults/:address

Returns detailed information about one vault.

Parameters:

Name	Type	Description
address	string	Vault contract address

Response:

Example only. The values are illustrative, not live data.

{
"address": "0x49f747BBac988Cd628a5D79AAdF865EBaDe6a34f",
"name": "Conservative Vault",
"symbol": "nCONS",
"asset": "0x...",
"tvl": "1250000000000000000000",
"totalShares": "1200000000000000000000",
"pricePerShare": "1041666666666666666",
"apy": {
"current": 8.5,
"7d": 8.2,
"30d": 8.7,
"inception": 9.1
},
"fees": {
"management": 0,
"performance": 10,
"hurdle": 4
},
"strategies": [
{
"name": "Aave USDC Lending",
"allocation": 40,
"apy": 5.2
}
],
"isERC7540": true,
"fulfillmentDelay": 3600
}

Get vault history

GET /vaults/:address/history

Returns historical TVL and APY data for a vault.

Query parameters:

Name	Type	Default	Description
period	string	30d	Time period (7d, 30d, 90d, 1y, all)
interval	string	1d	Data interval (1h, 4h, 1d, 1w)

Strategies

Get all strategies

GET /strategies

Returns all active trading strategies.

Get strategy performance

GET /strategies/:id/performance

Returns detailed performance metrics for a strategy.

Nodes

Get node status

GET /nodes

Returns the status of all registered nodes in the network.

User data

Get user positions

GET /users/:address/positions

Returns all vault positions for a user.

Get user transactions

GET /users/:address/transactions

Returns the transaction history for a user.

Protocol metrics

Get protocol stats

GET /protocol/stats

Returns aggregate protocol statistics.

Errors

All errors use one format:

Example only. The values are illustrative, not live data.

{
"error": {
"code": "VAULT_NOT_FOUND",
"message": "Vault with address 0x... not found",
"details": {}
}
}

Common error codes:

Code	HTTP Status	Description
VAULT_NOT_FOUND	404	Vault does not exist
INVALID_ADDRESS	400	Invalid Ethereum address
RATE_LIMITED	429	Too many requests
INTERNAL_ERROR	500	Server error

SDKs

Both SDKs are planned and not yet published.

Last updated: June 2026

results matching ""

No results matching ""