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

# Token metadata

> Resolve display metadata for assets, SY, PT, YT, and tranching LP tokens.

export const ApiResponse = ({children, errors = {}}) => {
  const [status, setStatus] = useState("200");
  const statuses = ["200", ...Object.keys(errors)];
  return <section className="api-response" aria-label="Response">
      <div className="api-response-header not-prose">
        <h2>Response</h2>
        <div className="api-response-format">
          {statuses.length > 1 ? <select aria-label="Response status" value={status} onChange={event => setStatus(event.target.value)}>
              {statuses.map(code => <option key={code} value={code}>{code}</option>)}
            </select> : <span>200</span>}
          <span className="api-response-mime">application/json</span>
        </div>
      </div>
      <div hidden={status !== "200"}>{children}</div>
      {status !== "200" && <div aria-live="polite">
          {Object.entries(errors[status]).map(([name, value]) => <ResponseField key={name} name={name} type={value === null ? "null" : Array.isArray(value) ? "array" : typeof value}>
              {name === "error" ? "Error message describing why the request failed." : "Additional error details."}
            </ResponseField>)}
        </div>}
    </section>;
};

## Request body

<ParamField body="mints" type="string[]" required>
  Up to 100 unique, valid Solana mint addresses. An empty array is allowed.
</ParamField>

<RequestExample dropdown>
  ```bash cURL theme={null}
  curl https://api.exponent.finance/token-metadata \
    -H 'Content-Type: application/json' \
    -d '{"mints": ["So11111111111111111111111111111111111111112"]}'
  ```

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

  response = requests.post(
      "https://api.exponent.finance/token-metadata",
      json={'mints': ['So11111111111111111111111111111111111111112']},
      timeout=30,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.exponent.finance/token-metadata", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({"mints": ["So11111111111111111111111111111111111111112"]}),
  });
  if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
  }
  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ApiResponse errors={{"400": {"error": "<message>"}, "500": {"error": "<message>"}}}>
  <ResponseField name="tokens" type="object[]">
    Resolved token metadata; unknown mints are omitted.

    <Expandable title="child attributes">
      <ResponseField name="tokens[].mint" type="string">
        Solana mint address identifying the token.
      </ResponseField>

      <ResponseField name="tokens[].name" type="string">
        Human-readable token name.
      </ResponseField>

      <ResponseField name="tokens[].symbol" type="string">
        Token symbol used for display.
      </ResponseField>

      <ResponseField name="tokens[].decimals" type="number">
        Token decimal places; divide raw quantities by `10 ** decimals` to obtain token units.
      </ResponseField>

      <ResponseField name="tokens[].imageUrl" type="string">
        URL of the token’s display image.
      </ResponseField>

      <ResponseField name="tokens[].maturityUnix" type="number">
        Token maturity in Unix seconds, present only for tokens with a maturity. Omitted when unavailable.
      </ResponseField>
    </Expandable>
  </ResponseField>
</ApiResponse>

<ResponseExample>
  ```json 200 theme={null}
  {
    "tokens": [
      {
        "mint": "So11111111111111111111111111111111111111112",
        "name": "Solana",
        "symbol": "SOL",
        "decimals": 9,
        "imageUrl": "https://cdn.exponent.finance/tokens/So11111111111111111111111111111111111111112.svg?v=v2"
      }
    ]
  }
  ```

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

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


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