Asset by id (instrument id, or Amulet for CC).
GET /api/v1/dextools/asset. Asset by id (instrument id, or Amulet for CC).
Anonymous calls are accepted under a per-IP budget; an X-API-Key raises the limit. When the deployment sets MARKET_DATA_REQUIRE_API_KEY=true the key becomes mandatory and anonymous calls answer 401 MARKET_DATA_API_KEY_REQUIRED.
Request
GET /api/v1/dextools/asset
The schema permits anonymous access. Supported credentials: a customer API key with read scope in X-API-Key. Deployment policy can require a key for market-data routes.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
id | query | string | Yes | min length: 1; max length: 512 | — |
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
cURL
Set ID to the path and required query values before running this example. URL-encode path values as needed.
curl --fail-with-body --silent --show-error \
--get \
--url "https://launch-api.supanova.app/api/v1/dextools/asset" \
--header "X-API-Key: $SUPANOVA_API_KEY" \
--data-urlencode "id=$ID"Responses
200
Asset.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asset | object · Schema 1 | Yes | — | — |
Additional fields are not allowed.
400
The request is malformed or failed validation.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
401
Credentials are missing, malformed, expired or revoked.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
403
The credential may not call this route.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
404
Unknown asset.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
429
The caller exceeded the market-data request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
503
The PQS market projection is not configured.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
default
DexTools http-adapter error body.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
DexTools error envelope: code, message, and issues. See the adapter contract.
Nested schemas
Field links above lead to the complete nested object, array, and variant definitions below. Required fields are scoped to their containing object.
Schema 1
Response 200.asset
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
circulatingSupply | string | No | pattern: ^\d+(?:\.\d+)$ | Tokens outside the pools: totalSupply minus the curve inventory and liquidity reserve, or minus the AMM token reserve after graduation. |
holdersCount | integer | No | minimum: 0; maximum: 9007199254740991 | — |
id | string | Yes | — | — |
name | string | Yes | — | — |
symbol | string | Yes | — | — |
totalSupply | string | No | pattern: ^\d+(?:\.\d+)$ | — |
Additional fields are not allowed.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.