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

# Get assets

> Get assets by ID, slug, or (chain, address).

export const SupportedChainsList = props => {
  const [data, setData] = useState(null);
  const [isLoading, setIsLoading] = useState(true);
  useEffect(() => {
    const fetchData = async () => {
      try {
        const response = await fetch("https://api.allium.so/api/v1/supported-chains/realtime-apis", {
          method: "GET"
        });
        if (!response.ok) {
          throw new Error(`HTTP error! status: ${response.status}`);
        }
        const responseData = await response.json();
        const filteredData = responseData.filter(entry => {
          const product = entry.endpoints[props.product_name];
          return product !== null;
        });
        setData(filteredData);
        setIsLoading(false);
      } catch (error) {
        setIsLoading(false);
      }
    };
    fetchData();
  }, []);
  if (isLoading) {
    return <div>Loading chain information...</div>;
  }
  if (!data) {
    return <div>No data available</div>;
  }
  const isCustomSQL = props.product_name === "custom_sql";
  return <div>
            {data.length > 0 && <table className="w-full">
                    <thead>
                        <tr>
                            <th>Chain</th>
                            <th>Chain ID</th>
                            <th>Status</th>
                            {isCustomSQL && <th>Tables</th>}
                        </tr>
                    </thead>
                    <tbody>
                        {data.map(chain => {
    const endpoint = chain.endpoints[props.product_name];
    return <tr key={chain.id}>
                                    <td style={{
      padding: '12px'
    }}>{chain.label}</td>
                                    <td style={{
      padding: '12px'
    }}><code>{chain.id}</code></td>
                                    <td style={{
      padding: '12px'
    }}>{endpoint ? endpoint.availability === "beta" ? "🌱 Beta" : "✅ Supported" : "❌ Not Supported"}</td>
                                    {isCustomSQL && <td style={{
      padding: '12px'
    }}>
                                            {endpoint && endpoint.tables ? endpoint.tables.map(t => t.name).join(", ") : "-"}
                                        </td>}
                                </tr>;
  })}
                    </tbody>
                </table>}
        </div>;
};

This endpoint returns assets by ID, slug, or (chain, address).

<Warning>
  This is a beta endpoint currently under active development. We're working to stabilize the API and will minimize breaking changes wherever possible, but they may still occur as we refine the interface.

  For production support or migration assistance, reach out at <a href="mailto:hello@allium.so">[hello@allium.so](mailto:hello@allium.so)</a>.
</Warning>

## Supported Chains

<SupportedChainsList product_name="get_assets" />


## OpenAPI

````yaml /_openapi/assets-api.json POST /api/v1/developer/assets/batch
openapi: 3.1.0
info:
  title: Allium API
  version: 0.1.0
servers:
  - url: https://api.allium.so
security: []
paths:
  /api/v1/developer/assets/batch:
    post:
      tags:
        - ASSETS
        - DEVELOPER
      summary: Get Assets Batch
      operationId: get_assets_batch_api_v1_developer_assets_batch_post
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/AssetBatchRequest'
              title: Requests
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  anyOf:
                    - $ref: '#/components/schemas/AssetResponse'
                    - type: 'null'
                title: Response Get Assets Batch Api V1 Developer Assets Batch Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyBearer: []
components:
  schemas:
    AssetBatchRequest:
      properties:
        id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Id
          description: Asset ID to look up
        slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Slug
          description: Asset slug to look up
        chain:
          anyOf:
            - type: string
            - type: 'null'
          title: Chain
          description: Lowercase chain name (required with address)
        address:
          anyOf:
            - type: string
            - type: 'null'
          title: Address
          description: Token contract address
      type: object
      title: AssetBatchRequest
    AssetResponse:
      properties:
        id:
          type: integer
          title: Id
          description: Unique asset identifier
        slug:
          type: string
          title: Slug
          description: URL-friendly asset identifier
        source:
          type: string
          title: Source
          description: Data source (e.g. allium)
        chain_specific_data:
          additionalProperties:
            additionalProperties:
              anyOf:
                - type: string
                - type: integer
            type: object
          type: object
          title: Chain Specific Data
          description: Per-chain contract addresses and decimals
        name:
          type: string
          title: Name
          description: Token name
        symbol:
          type: string
          title: Symbol
          description: Token symbol
        image_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Image Url
          description: Token logo URL
        circulating_supply:
          anyOf:
            - type: number
            - type: 'null'
          title: Circulating Supply
          description: Circulating token supply
        token_creation_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Token Creation Time
          description: Token creation timestamp (UTC)
      type: object
      required:
        - id
        - slug
        - source
        - chain_specific_data
        - name
        - symbol
        - image_url
        - circulating_supply
        - token_creation_time
      title: AssetResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyBearer:
      type: apiKey
      in: header
      name: X-API-KEY

````