DATA SCHEMAS

Neura responses follow predictable structures so you can deserialize them with confidence. This page highlights the reusable shapes for core resources. Field names may evolve over time; always check the live API for the latest additions.

Tokens

Field	Type	Description
address	string	Contract address.
symbol	string	Token ticker.
name	string	Human friendly name.
decimals	number	Decimal precision.
networkId	number	Numeric identifier of the source network.
networkName	string	Human readable network name.
marketCap	number	Market capitalization in USD (if available).
volume24h	number	Rolling 24 hour volume.
priceChange24h	number	Price delta over the last 24 hours (fractional).
lastUpdated	string	ISO 8601 timestamp.
exchanges	array	Optional array of exchange listings with name, networkId, tradeUrl.
socialLinks	object	Optional social URLs (website, twitter, discord, etc.).
launchpad	object	Optional launchpad metadata (graduationPercent, launchpadName, etc.).

Token price entry

Field	Type	Description
address	string	Contract address.
networkId	number	Network identifier.
price	number	Latest price in native units.
priceUsd	number	Latest price converted to USD.
lastUpdated	string	ISO 8601 timestamp.

Balances

Field	Type	Description
networkId	number	Network identifier.
networkName	string	Network name.
assets	array	Token balances for the wallet on the network.

Each entry inside assets contains:

Field	Type	Description
address	string	Token contract address.
symbol	string	Token symbol.
name	string	Token name.
decimals	number	Decimal precision.
balance	string	Raw balance (integer formatted as string).
balanceUsd	number	Balance value in USD (if available).

Networks

Field	Type	Description
id	number	Internal network identifier.
name	string	Network name.
symbol	string	Currency or chain symbol.
chainId	number	EVM chain ID when applicable.
isActive	boolean	Indicates whether the network is currently active.
lastUpdated	string	ISO 8601 timestamp.

Responses also include total (number of networks) and lastUpdated for the overall dataset.

Price bars

Bar entries returned by GET /bars share the structure:

Field	Type	Description
t	number	Unix timestamp (seconds).
o	number	Open price.
h	number	High price.
l	number	Low price.
c	number	Close price.
volume	number	Trade volume.

The response also echoes the request parameters: symbol, resolution, from, to, and lastUpdated.

Launchpad tokens

Launchpad list endpoints return filterTokens.results arrays, where each item includes:

Field	Type	Description
createdAt	number	Unix timestamp indicating when the token was created.
marketCap	number	Market capitalization in USD.
priceUSD	number	Token price in USD.
token	object	Nested metadata for the token.

token.launchpad provides:

Field	Type	Description
graduationPercent	number	Completion percentage toward migration.
launchpadName	string	Name of the launchpad platform.
launchpadProtocol	string	Underlying protocol (for example, Solana).
migrated	boolean	Indicates whether migration has occurred.
completed	boolean	Indicates whether the launch is complete.
completedAt	string	ISO 8601 timestamp (if completed).

Health

GET /health returns:

Field	Type	Description
status	string	"healthy" or "unhealthy".
timestamp	string	ISO 8601 timestamp.
uptime	number	Process uptime in seconds.
memory	object	Node.js memory usage snapshot.
version	string	Deployed API version.

GET /health/resilience returns:

Field	Type	Description
status	string	Overall health status.
timestamp	string	ISO 8601 timestamp.
resilience	object	Keyed by rate limiter entry (for example rateLimit_neura:token). Each entry exposes consumedPoints, remainingPoints, and msBeforeNext.

Tips for schema evolution

• Treat unknown fields as forwards compatible enhancements.

• Use JSON schema validation or TypeScript interfaces mirroring the tables above to guard against regressions.

• Subscribe to Neura release notes for notifications about new fields or deprecations.