---
title: "Get asset metadata"
method: GET
path: "/assets"
tags: ["Utilities"]
---

# Get asset metadata

`GET /assets`

## Request

- Base URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor`
- URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor/assets`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/docs/assets/get.ts> (a function with typed inputs; its response is checked against the schema)

Authenticated asset lookup. GET accepts required ids and fields as comma-separated or repeated query parameters; at most 100 IDs before deduplication. Supported fields: name, symbol, decimals, price, logo. QUERY /assets is also supported (not representable as an OpenAPI 3.1 operation): send application/json {"ids":["eip155:1:native"],"fields":["symbol","price"]}, at most 100 IDs and a 64 KiB body. Both methods return exact submitted ID keys, omit unrequested fields and use null for unresolved requested fields; item errors remain HTTP 200. An invalid request returns 400 with {"error":{"code":"invalid_request","message":"..."}}.

## Query parameters

- `ids` string, required: Required comma-separated asset IDs (or repeated ids); at most 100 submitted IDs
- `fields` string, required: Required comma-separated fields (or repeated fields): name,symbol,decimals,price,logo

## Headers

- `x-api-key` string: API key for authentication

## Response `200`

Requested asset fields keyed by exact submitted ID

- AssetsResponse
  - `data` object, required

## Other responses

- `400`: Invalid asset request (or invalid API key)
- `401`: Authentication required or the presented credential is invalid.
- `403`: Organization is not billable
- `502`: Asset upstream unavailable
- `503`: Tenant billing verification is temporarily unavailable; retry after 5 seconds.

## Changes

- **2026-11-06** `aa1767d704fa`: 5 info
  - the endpoint scheme security `internalProjectBearer` was added to the API
  - the endpoint scheme security `tenantApiKey` was added to the API
  - the `header` request parameter `x-api-key` became optional
  - added the non-success response with the status `401`
  - …1 more
- **2026-09-30** `a6fd693c3d5f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/changes/assets/get.md)

---

[API](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api.md) - [All operations](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/revisions/aa1767d704fa?raw)