Overview - Neuron Agent API

Tokens are digital assets managed by the Neuron platform and governed by smart contracts with associated state machines. The Token endpoints let you query token metadata, retrieve creation attributes, inspect event histories, and annotate tokens with text or XML notes. All endpoints require a valid JWT bearer token. Access to a token is subject to the authorization rules defined in the token’s governing contract.

Endpoints

Endpoint	Description
Get token	Retrieve full metadata for a single token by ID.
Get tokens	List tokens owned by or accessible to the authenticated account.
Get contract tokens	List all tokens created under a specific smart contract.
Get description	Retrieve a human-readable description of a token.
Get creation attributes	Retrieve the attributes that were set when the token was originally created.
Get token events	Retrieve the event history of a token (state transitions, transfers, etc.).
Add text note	Attach a plain text annotation to a token.
Add XML note	Attach a structured XML annotation to a token.

Token structure

Tokens are linked to:

A smart contract that defines their rules and roles — see Contracts.
A state machine that tracks their lifecycle — see State machines.

Use Get token events to trace state transitions over time. Use Get current state for the live state.

Tokens flow guide — walkthrough of querying tokens, attributes, and events.
State machines — inspect and report on a token’s state machine.
Contracts — the contracts that govern token behaviour.

​Endpoints

​Token structure

​Related

Endpoints

Token structure

Related