> 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/build-with-native/native-core.md).

# Market Makers

{% hint style="info" %}
*Last updated: 2026-06-11 (*v0.5*)*
{% endhint %}

This document describes the Native Core business API. Clients submit signed business actions with `POST /trade` and read business state with `POST /info`.

Operational, recovery, and node-private interfaces are intentionally not part of this contract.

## Conventions

* `API_URL` examples use `https://api-test.native.org`.
* Hex values are `0x`-prefixed lowercase strings unless noted otherwise.
* Protocol numeric fields in signed actions are decimal strings.
* Business query responses include `query_height` and `app_hash` when a query view is available. `query_height` is the execution height represented by the published read view.
* `POST /trade` and `POST /info` accept an optional `x-trace-id` HTTP header for request correlation. When the header is absent or invalid, the gateway generates one. The response always includes the trace id in `x-trace-id`.
* `POST /trade` returns admission success or rejection. Public clients confirm effects through business queries such as `orderStatus`, `openOrders`, `userFills`, `userBalances`, `spotCreditPositions`, `spotCreditAccount`, `batchOrderStatus`, `quoteAssets`, `accountingWithdrawTokens`, `withdraws`, `queryStatus`, `oracleStatus`, and `markPrices`.

## Transaction Signing

Native Core transactions require signing. Read more:

{% content-ref url="/pages/HuXGRf95Oiiq5dDwWhBC" %}
[Transaction Signing](/native-dev/build-with-native/native-core/transaction-signing.md)
{% endcontent-ref %}

## Decimal Units

Native Core executes on integers only. Read more:

{% content-ref url="/pages/599fbf416b30bce8b5c0a312787ecde004fbca64" %}
[Decimals Units](/native-dev/build-with-native/native-core/decimals-units.md)
{% endcontent-ref %}

## POST /trade

{% content-ref url="/pages/2f1iTLbJG8HD9gz4V3yT" %}
[POST /trade](/native-dev/build-with-native/native-core/post-trade.md)
{% endcontent-ref %}

## POST /info

{% content-ref url="/pages/ymw4xOGLPOW1dX7aL3tP" %}
[POST /info](/native-dev/build-with-native/native-core/post-info.md)
{% endcontent-ref %}

## Changelog

```
2026-06-11: v0.5 - add withdraw/settle/repay actions with EIP-712 signing, x-trace-id, queryStatus/accountingWithdrawTokens/withdraws/batchOrderStatus info queries, assets withdraw fees, and revised /trade error codes.
2026-05-30: v0.4 - add cancelAll action, trading-fee fields on userFills, orderStatus pending/null-OID overlay, assets.issuer, expanded /trade error codes, and signing example refresh.
2026-05-13: v0.3 - admission precheck and margin controls, migrate quantity precision to markets, and add quote-asset minimum/allowlist admin and query APIs (plus related fixes).
2026-05-13: v0.2 - add decimals related, put sections into subpages
2026-05-12: v0.1 - initial base, with tx signing
```


---

# 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/build-with-native/native-core.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.