> For the complete documentation index, see [llms.txt](https://xpansionchain-1.gitbook.io/xpansionchain/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xpansionchain-1.gitbook.io/xpansionchain/troubleshooting/token-data-object.md).

# Token data object

## Token data object

Currently, in our API reference, we have a `token.data` object required as a parameter for a bunch of endpoints.

**Example:** ![Token data](https://docs.x.immutable.com/assets/images/token-data-1cb23bd1004254e5d17c1305963d017f.png)

However, it is not clear from the API reference what this object should look like. This page is to provide that clarification.

#### Endpoints requiring `token.data`:[​](https://docs.x.immutable.com/docs/x/token-data-object#endpoints-requiring-tokendata) <a href="#endpoints-requiring-tokendata" id="endpoints-requiring-tokendata"></a>

* <mark style="color:blue;">getSignableOrder</mark>
* <mark style="color:blue;">getSignableTransferV1</mark>
* <mark style="color:blue;">getSignableTransfer</mark> (Get bulk details of a signable transfer)
* <mark style="color:blue;">getSignableWithdrawal</mark>

#### token[​](https://docs.x.immutable.com/docs/x/token-data-object#token) <a href="#token" id="token"></a>

The `token` param is made up of two fields:

* **type**
* **data**

`type` can be one of: **ETH**, **ERC20**, or **ERC721**

`data` depends on the `type` that is used. Fields are:

* **decimals** (required for ETH, ERC20)
* **token\_address** (required for ERC20, ERC721)
* **token\_id** (required for ERC721)

If any of the required fields are missing, the request will error out.

#### Example requests:[​](https://docs.x.immutable.com/docs/x/token-data-object#example-requests) <a href="#example-requests" id="example-requests"></a>

**type: 'ETH'**[**​**](https://docs.x.immutable.com/docs/x/token-data-object#type-eth)

```
{
  ...
  "token": {
      "type": "ETH",
      "data": {
          "decimals": 18
      }
  }
}
```

**type: 'ERC20'**[**​**](https://docs.x.immutable.com/docs/x/token-data-object#type-erc20)

```
{
  ...
  "token": {
      "type": "ERC20",
      "data": {
          "decimals": 18,
          "token_address": "0x..."
      }
  }
}
```

**type: 'ERC721'**[**​**](https://docs.x.immutable.com/docs/x/token-data-object#type-erc721)

```
{
  ...
  "token": {
      "type": "ERC721",
      "data": {
          "token_address": "0x...",
          "token_id": "123"
      }
  }
}
```