> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# wallet/getassetissuebyname | TRON

> TRON API method that retrieves information about a TRC10 token by its name. Reference for wallet/getassetissuebyname on TRON via Chainstack.

TRON API method that retrieves information about a TRC10 token by its name.

## Parameters

* `value` — the name of the TRC10 token to retrieve information for
* `visible` — optional boolean parameter. When set to `true`, addresses are in base58 format. Default is `false`.

## Response

* `assetIssue` — array of asset issue information containing:
  * `owner_address` — token creator address
  * `name` — token name
  * `abbr` — token abbreviation
  * `total_supply` — total token supply
  * `trx_num` — TRX amount for exchange rate
  * `num` — token amount for exchange rate
  * `start_time` — ICO start time
  * `end_time` — ICO end time
  * `description` — token description
  * `url` — token website URL
  * `id` — token ID

## Use case

The `wallet/getassetissuebyname` method is used for:

* Retrieving detailed information about TRC10 tokens
* Building token information displays in wallets and DApps
* Verifying token authenticity and properties
* Creating token discovery and analysis tools
* Implementing token trading interfaces

## curl examples

Because TRC10 names are not unique on mainnet, calling `wallet/getassetissuebyname` with a plain name often returns a non‑unique error. A reliable flow is:

1. search by name to see all matches

```shell Shell theme={"system"}
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getassetissuelistbyname' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "SEED",
    "visible": true
  }'
```

This returns an `assetIssue` array with multiple SEED tokens. Each item has an `id` field (for example, `1000001`).

2. fetch the exact token by id

```shell Shell theme={"system"}
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getassetissuebyid' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "1000001"
  }'
```

One‑liner using `jq` to pick the first match and query by id:

```shell Shell theme={"system"}
ASSET_ID=$(curl -s -X POST \
  'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getassetissuelistbyname' \
  -H 'Content-Type: application/json' \
  -d '{"value":"SEED","visible":true}' | jq -r '.assetIssue[0].id')

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getassetissuebyid' \
  --header 'Content-Type: application/json' \
  --data '{"value":"'"$ASSET_ID"'"}'
```

<Info>
  * if you call `wallet/getassetissuebyname` with a non‑unique name (for example, `SEED`), the node can respond with:

  ```json theme={"system"}
  {"Error":"class org.tron.core.exception.NonUniqueObjectException : To get more than one asset, please use getAssetIssueById syntax"}
  ```

  * prefer `wallet/getassetissuelistbyname` to discover candidates, then `wallet/getassetissuebyid` to retrieve a specific token.
</Info>

### direct working example (hex name)

You can also query a known unique token by providing the name hex‑encoded with `visible: false`. Example for `TRXTestCoin` (asset id `1000006`):

```shell Shell theme={"system"}
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getassetissuebyname' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": "54525854657374436f696e",
    "visible": false
  }'
```


## OpenAPI

````yaml openapi/tron_node_api/getassetissuebyname.json post /95e61622bf6a8af293978377718e3b77/wallet/getassetissuebyname
openapi: 3.0.0
info:
  title: wallet/getassetissuebyname TRON API
  version: 1.0.0
  description: Get TRC10 token information by name
servers:
  - url: https://tron-mainnet.core.chainstack.com
security: []
paths:
  /95e61622bf6a8af293978377718e3b77/wallet/getassetissuebyname:
    post:
      tags:
        - TRC10 Assets
      summary: wallet/getassetissuebyname
      operationId: getAssetIssueByName
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - value
              properties:
                value:
                  type: string
                  description: >-
                    Token name. When `visible` is true, provide the plain UTF‑8
                    name. When `visible` is false, provide the UTF‑8 name
                    hex‑encoded.
                  default: TOKEN_NAME
                visible:
                  type: boolean
                  description: >-
                    When true, `value` is plain text. When false, `value` is
                    hex‑encoded UTF‑8.
                  default: false
              example:
                value: 54525854657374436f696e
                visible: false
      responses:
        '200':
          description: TRC10 token information
          content:
            application/json:
              schema:
                type: object
                properties:
                  assetIssue:
                    type: array
                    items:
                      type: object
                      properties:
                        owner_address:
                          type: string
                        name:
                          type: string
                        abbr:
                          type: string
                        total_supply:
                          type: integer
                        trx_num:
                          type: integer
                        num:
                          type: integer
                        start_time:
                          type: integer
                        end_time:
                          type: integer
                        description:
                          type: string
                        url:
                          type: string
                        id:
                          type: string

````