Nabdchain API Documentation

API

Use the public API for chain reads, account lookup, signed transaction submission, asset operations, AP records, and finality checks.

Base APIhttps://api.testnet.nabdchain.org/api/v1

OpenAPIhttps://testnet.nabdchain.org/api/openapi.yaml

SDK repositorygitlab.com/ktham33n1/nabd-sdk

Explorerhttps://testnet.nabdchain.org

Chain identityRead network_id and genesis_hash before signing.

Endpoint families

Method	Path	Purpose
GET	`/api/status`	Network identity and consensus state
GET	`/api/v1/blocks`	Recent blocks and block lookup
GET	`/api/v1/accounts/{address}`	Balance, nonce, and account activity
POST	`/api/v1/transactions`	Submit one signed transaction
POST	`/api/v1/transactions/batch`	Submit 1-250 signed transactions with per-item results
GET	`/api/v1/assets`	List and inspect assets
GET	`/api/v1/ap/contracts`	List autonomous programs
POST	`/api/v1/faucet/requests`	Request public testnet tokens

SDK

Use the public SDK repository for Python, TypeScript, checked OpenAPI, examples, and package release notes.

Resource	Link	Use
Getting started	GETTING_STARTED.md	Install, read chain state, request faucet funds, sign, submit, and poll finality.
Python SDK	python/	Local Ed25519 signing, transfers, assets, AP calls, and finality polling.
TypeScript SDK	typescript/	Node.js 18+ integrations for wallets, dashboards, and services.
OpenAPI	openapi.yaml	Generate clients for other languages from the live contract.
Release flow	RELEASE.md	Maintainer flow for PyPI, npm, Git tags, and CI package gates.

# Repository
git clone https://gitlab.com/ktham33n1/nabd-sdk.git

# Python
cd nabd-sdk
python3 -m pip install -e ./python
python3 python/examples/read_chain.py

# TypeScript
cd typescript
npm install
npm run build

Signing

For Ed25519 transactions, build the signable payload from the protocol fields below, remove fields that are not present, then serialize canonical JSON with UTF-8, lexicographic key order, and compact separators.

from, to, amount, fee, nonce, timestamp, data, pubkey, privacy, type,
expires_at, version, network_id, genesis_hash

timestamp is Unix seconds. Nodes accept signed transaction timestamps from 3600 seconds in the past through 300 seconds in the future. Do not sign response metadata such as tx_hash, status, block_round, or explorer display fields.

Fees

API amounts and fees are integers in micro-NABD with 6 decimals.

1 NABD = 1_000_000 micro-NABD
0.001 NABD = 1_000 micro-NABD

Operation	Minimum Fee
Transfer, private transfer, batch item	`1,000` micro-NABD
Asset operation	`1,000` micro-NABD
AP deployment	`100,000` micro-NABD
AP call	`10,000` micro-NABD

Faucet

Use the public faucet to fund NABD1 test wallets for SDK, wallet, asset, and AP trials.

curl -sS -X POST https://testnet.nabdchain.org/api/v1/faucet/requests \
  -H "Content-Type: application/json" \
  --data '{"address":"NABD1...","email":"dev@example.com","note":"wallet test","captcha_token":"TOKEN_FROM_FAUCET_PAGE"}'

Reference AP

A live reference Autonomous Program is deployed on the testnet for AP lifecycle checks.

Contract52874a94e69f2a9713427ee760d2b84811241b16

Deploy tx51aac251ec1f9ce815f501575a86e6053833e559f88997a8933ef72c63283d6d

Call tx4e6fc90dffc7c70b2720f3219aa7483db465ff0cee892009780dbb9448d3f01b

Functionping, success, 1 execution fee unit.

curl -sS https://api.testnet.nabdchain.org/api/v1/ap/contracts/52874a94e69f2a9713427ee760d2b84811241b16
curl -sS https://api.testnet.nabdchain.org/api/v1/ap/contracts/52874a94e69f2a9713427ee760d2b84811241b16/executions

Examples

# Chain identity
curl -sS https://api.testnet.nabdchain.org/api/status

# Recent blocks
curl -sS "https://api.testnet.nabdchain.org/api/v1/blocks?limit=5"

# Account lookup
curl -sS "https://api.testnet.nabdchain.org/api/v1/accounts/NABD1..."

# Submit signed transaction
curl -sS -X POST https://api.testnet.nabdchain.org/api/v1/transactions \
  -H "Content-Type: application/json" \
  --data '{"from":"NABD1...","to":"NABD1...","amount":1000,"fee":1000,"nonce":1,"timestamp":1779890000,"type":"transfer","data":"","pubkey":"...","network_id":"NETWORK_ID_FROM_STATUS","genesis_hash":"GENESIS_HASH_FROM_STATUS","signature":"..."}'

# Poll finality
curl -sS "https://api.testnet.nabdchain.org/api/v1/transactions/TX_HASH_FROM_SUBMIT_RESPONSE"

NABD Developer Docs

API