GET Asset history
Returns the minting/burning history of one MultiAsset given its fingerprint.
GET /api/core/assets/{fingerprint}/history
🎰 Parameters
| Name | Description | In | Type | Required |
|---|---|---|---|---|
| fingerprint | The CIP14 fingerprint for the MultiAsset. | path | string | true |
| page_no | Page number to retrieve - defaults to 1 | query | integer | false |
| page_size | Number of results per page - defaults to 20 - max 100 | query | integer | false |
| order | Prescribes in which order the minting/burning events are returned - "desc" descending (default) from newest to oldest - "asc" ascending from oldest to newest | query | string | false |
👨💻 Code samples
- Node.js
- Python
- Rust
const CBI = await new CardanoBI({ apiKey: 'YOUR-KEY', apiSecret: 'YOUR-SECRET' });
const history = await CBI.core.assets.history_({ fingerprint: "asset1gqp4wdmclgw2tqmkm3nq7jdstvqpesdj3agnel" });
console.log(history);
CBI = CardanoBI(apiKey='YOUR-KEY', apiSecret='YOUR-SECRET' });
history = await CBI.core.assets.history_(fingerprint='asset1gqp4wdmclgw2tqmkm3nq7jdstvqpesdj3agnel');
print(history);
let CBI = CardanoBI::new(Some("YOUR-KEY"), Some("YOUR-SECRET")).await.expect("Failed to initialize CardanoBI");
let history_history = CBI.core.assets.history_(Some("asset1gqp4wdmclgw2tqmkm3nq7jdstvqpesdj3agnel"), HashMap::new()).await.expect("Failed to call endpoint");
println!("history_history: {:?}", history_history);
💌 Response Codes
- 200
- 400
- 401
- 402
- 403
- 404
- 429
OK: Successful request.
[
"..."
]
Bad Request: The request was unacceptable, often due to missing a required parameter.
Response schema is undefined.
Unauthorized: No valid API key provided.
Response schema is undefined.
Quota Exceeded: This API key has reached its usage limit on request.
Response schema is undefined.
Access Denied: The request is missing a valid API key or token.
Response schema is undefined.
Not Found: The requested resource cannot be found.
Response schema is undefined.
Too Many Requests: This API key has reached its rate limit.
Response schema is undefined.
💌 Response Schemas
- 200
- 400
- 401
- 402
- 403
- 404
- 429
Status Code 200
| Name | Type | Description |
|---|---|---|
| event_id | integer(int64) | The Multi-Asset minting/buring event unique identifier. |
| tx_hash_hex | string | The hexadecimal encoding of the hash identifier of the transaction containing this event. |
| quantity | number(double) | The amount of the Multi Asset to mint (can be negative to "burn" assets). |
| event_time | string(date-time) | The event creation time (time of the block containing it). |
| block_no | integer(int32) | The block number containing the minting/buring transaction for this event. |
Status Code 400
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 401
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 402
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 403
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 404
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 429
| Name | Type | Description |
|---|
Response schema is undefined.