> For the complete documentation index, see [llms.txt](https://docs.native.org/native-dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.native.org/native-dev/concepts/markets-and-assets.md).

# Markets, Assets & Decimals

Trading on Native Core is organized around **assets** and **markets**. Understanding how they are identified and how their numbers are scaled is essential for reading the order book and placing orders correctly.

#### Assets

An asset is a token tracked on Native Core, identified by a numeric `asset_id` and a unique `symbol`.

* **`balance_decimals`** — the internal scale used for balances and settlement of that asset.
* **`issuer`** — the owner account bound to an asset (via the operator listing action). It is a record-keeping binding only and confers no admin privileges; genesis and legacy-listed assets show the zero address.

#### Markets

A market is a tradable pair, identified by a numeric `market_id`, with a base asset and a quote asset. Each market carries its own scaling metadata:

* **`base_quantity_decimals`** — lot scale for order quantity in the base asset.
* **`price_decimals`** — decimal places for price (quote units per 1 base unit).
* **`max_price_sig_figs`** — maximum significant figures allowed for non-integer display prices.
* **`quote_balance_decimals`** — the quote asset's `balance_decimals`, included so clients can convert quote notional without a separate lookup.

#### Quote Assets & Minimum Notional

Only allowlisted **quote assets** may be used as the quote side of a market. Each carries a **minimum order notional** (`min_quantity`) so dust orders are rejected. For example, the genesis allowlist uses USDC and USDT with a `10` minimum, ETH with `0.01`, and BNB with `0.02`. Orders below the configured minimum are rejected with `MinTradeSpotNtl`.

#### Raw Atoms vs Display Values

Native Core executes on **integers only**. Public APIs accept and return human-readable decimal strings, while the signed transaction payload carries raw integer **atoms**:

```
raw_quantity = display_quantity * 10^base_quantity_decimals
raw_price    = display_price * 10^price_decimals
```

Submitting more fractional digits than a market's `price_decimals` or `base_quantity_decimals` allows is rejected (`invalid_price_precision` / `invalid_quantity_precision`). For the full conversion rules and worked examples, see the Decimal Units reference.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.native.org/native-dev/concepts/markets-and-assets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.