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

# Get asset information

> Get descriptive information about an asset.

## Path parameters

<ParamField path="id" type="string" required>
  Symbol ID
</ParamField>

## Query parameters

<ParamField query="lang" type="string">
  Language for the app.
</ParamField>

## Response

`200` Success.

<ResponseField name="about" type="string" />

<ResponseField name="snapshot" type="object[]">
  <Expandable title="properties">
    <ResponseField name="displayText" type="string" />

    <ResponseField name="value" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="price_target" type="object">
  <Expandable title="properties">
    <ResponseField name="currentPrice" type="number" />

    <ResponseField name="targetLowPrice" type="string" />

    <ResponseField name="targetHighPrice" type="string" />

    <ResponseField name="targetMeanPrice" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="earnings" type="object">
  <Expandable title="properties">
    <ResponseField name="forecast" type="number[]" />

    <ResponseField name="actualInc" type="number[]" />

    <ResponseField name="actualDec" type="number[]" />

    <ResponseField name="q" type="string[]" />
  </Expandable>
</ResponseField>

<ResponseField name="analyst_ratings" type="object">
  <Expandable title="properties">
    <ResponseField name="buy" type="number" />

    <ResponseField name="hold" type="number" />

    <ResponseField name="sell" type="number" />

    <ResponseField name="strongBuy" type="number" />

    <ResponseField name="strongSell" type="number" />

    <ResponseField name="recommended" type="string" />
  </Expandable>
</ResponseField>

## Possible Errors

| Error | Possible cause | What to do |
| - | - | - |
| 400 | Invalid or missing field | Check the request against the schema. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://gateway.amana.io/asset-info/{id}'
  ```

  ```python Python theme={null}
  import requests

  url = "https://gateway.amana.io/asset-info/{id}"
  headers = {}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://gateway.amana.io/asset-info/{id}', {
    method: 'GET',
    headers: {},
  });
  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "about": "<string>",
    "snapshot": [
      {
        "displayText": "<string>",
        "value": "<string>"
      }
    ],
    "price_target": {
      "currentPrice": 123.45,
      "targetLowPrice": "<string>",
      "targetHighPrice": "<string>",
      "targetMeanPrice": "<string>"
    },
    "earnings": {
      "forecast": [
        123.45
      ],
      "actualInc": [
        123.45
      ],
      "actualDec": [
        123.45
      ],
      "q": [
        "<string>"
      ]
    },
    "analyst_ratings": {
      "buy": 123.45,
      "hold": 123.45,
      "sell": 123.45,
      "strongBuy": 123.45,
      "strongSell": 123.45,
      "recommended": "<string>"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 429 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.