> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt
> Use this file to discover all available pages before exploring further.
# ERC-1155 Tokens
> Subscribe to real-time ERC-1155 multi-token contract registry updates.
## Overview
* **Dataset ID:** [`0203 - ERC-1155 Tokens`](/data-catalog/evm/entities/erc1155-tokens)
* **Description:** Catalog of ERC-1155 Multi Token contracts (EIP-1155); one contract can have many token types.
* **Sample:** [Hugging Face Sample](https://huggingface.co/datasets/BlockDB/ERC1155-Tokens-Ethereum-And-EVM-Cryptocurrency-Data)
## Subscription Parameters
Target EVM network. *See the [Chain](/api-reference/enumerations/chain) enumeration.*
Optional filter: one contract address (20-byte hex, no `0x` prefix).
## Message Fields
Unique contract incarnation ID (26 bytes hex).
ERC-1155 contract address (20-byte hex).
Block where the contract was recognized.
Block time (ISO-8601).
Transaction index.
Contract-level name when present.
Contract-level symbol when present.
Decimals when exposed by the contract.
URI from `uri(uint256)` (optional ERC1155Metadata\_URI).
Whether the contract supports the ERC1155Metadata\_URI extension; null when detection was via fallback.
Lineage id (hex).
Parent lineage ids (hex).
Record creation time (ISO-8601).
Record last update time (ISO-8601).
## Subscription Example
```bash bash theme={null}
# Use wscat to connect and subscribe
wscat -c wss://api.blockdb.io/v1/evm/ \
-H "Authorization: Bearer $BLOCKDB_API_KEY" \
-x '{"action": "subscribe", "dataset_id": "0203", "chain_id": 1, "params": {}}'
```
```c C theme={null}
#include
#include
#include
static int callback_blockdb(struct lws *wsi, enum lws_callback_reasons reason,
void *user, void *in, size_t len) {
switch (reason) {
case LWS_CALLBACK_CLIENT_ESTABLISHED:
lws_callback_on_writable(wsi);
break;
case LWS_CALLBACK_CLIENT_RECEIVE:
printf("Received: %s\n", (char *)in);
break;
case LWS_CALLBACK_CLIENT_WRITEABLE: {
unsigned char buf[LWS_PRE + 1024];
unsigned char *p = &buf[LWS_PRE];
size_t n = sprintf((char *)p, "{\"action\": \"subscribe\", \"dataset_id\": \"0203\", \"chain_id\": 1, \"params\": {}}");
lws_write(wsi, p, n, LWS_WRITE_TEXT);
break;
}
}
return 0;
}
```
```csharp .NET theme={null}
using System;
using System.Net.WebSockets;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
class Program {
static async Task Main() {
using var ws = new ClientWebSocket();
ws.Options.SetRequestHeader("Authorization", $"Bearer {Environment.GetEnvironmentVariable("BLOCKDB_API_KEY")}");
await ws.ConnectAsync(new Uri("wss://api.blockdb.io/v1/evm/"), CancellationToken.None);
var subMsg = "{\"action\": \"subscribe\", \"dataset_id\": \"0203\", \"chain_id\": 1, \"params\": {}}";
await ws.SendAsync(new ArraySegment(Encoding.UTF8.GetBytes(subMsg)), WebSocketMessageType.Text, true, CancellationToken.None);
var buffer = new byte[1024 * 4];
while (ws.State == WebSocketState.Open) {
var result = await ws.ReceiveAsync(new ArraySegment(buffer), CancellationToken.None);
Console.WriteLine(Encoding.UTF8.GetString(buffer, 0, result.Count));
}
}
}
```
```python Python theme={null}
import websocket
import json
import os
def on_message(ws, message):
print(f"Received: {message}")
def on_open(ws):
msg = {
"action": "subscribe",
"dataset_id": "0203",
"chain_id": 1,
"params": {}
}
ws.send(json.dumps(msg))
ws = websocket.WebSocketApp(
"wss://api.blockdb.io/v1/evm/",
header={"Authorization": f"Bearer {os.getenv('BLOCKDB_API_KEY')}"},
on_message=on_message,
on_open=on_open
)
ws.run_forever()
```
```javascript Node.js theme={null}
const WebSocket = require('ws');
const ws = new WebSocket('wss://api.blockdb.io/v1/evm/', {
headers: { 'Authorization': `Bearer ${process.env.BLOCKDB_API_KEY}` }
});
ws.on('open', () => {
ws.send(JSON.stringify({
action: 'subscribe',
dataset_id: '0203',
chain_id: 1,
params: {}
}));
});
ws.on('message', (data) => {
console.log('Received:', JSON.parse(data));
});
```
```go Go theme={null}
package main
import (
"fmt"
"log"
"net/http"
"os"
"github.com/gorilla/websocket"
)
func main() {
header := http.Header{"Authorization": []string{"Bearer " + os.Getenv("BLOCKDB_API_KEY")}}
c, _, err := websocket.DefaultDialer.Dial("wss://api.blockdb.io/v1/evm/", header)
if err != nil {
log.Fatal("dial:", err)
}
defer c.Close()
sub := `{"action": "subscribe", "dataset_id": "0203", "chain_id": 1, "params": {}}`
err = c.WriteMessage(websocket.TextMessage, []byte(sub))
if err != nil {
log.Fatal("write:", err)
}
for {
_, message, err := c.ReadMessage()
if err != nil {
log.Fatal("read:", err)
}
fmt.Printf("Received: %s\n", message)
}
}
```
## Response Example
```json Response theme={null}
{
"chain_id": 1,
"dataset_id": "0203",
"is_reorg": false,
"data": {
"contract_id": "0000000000000000000000000000000000000000000000000000",
"contract_address": "495f947276749ce646f68ac8c248420045cb7b5e",
"block_number": 11579209,
"block_time": "2021-10-15T12:00:00Z",
"tx_index": 42,
"name": "OpenSea Shared Storefront",
"symbol": "OPENSTORE",
"decimals": null,
"uri": "https://api.opensea.io/api/v1/metadata/{id}",
"supports_metadata_uri": true,
"_tracing_id": "0203000000000000000000000000000000000001",
"_parent_tracing_ids": [
"0103000000000000000000000000000000000001"
],
"_created_at": "2025-11-11T18:42:15.123Z",
"_updated_at": "2025-11-11T18:42:15.123Z"
}
}
```
## AsyncAPI
````yaml specs/wss/evm/entities/tokens-erc1155.yaml erc1155-tokens
id: erc1155-tokens
title: Erc1155-tokens
description: ''
servers:
- id: production
protocol: wss
host: api.blockdb.io/v1/evm/
bindings: []
variables: []
address: /
parameters: []
bindings: []
operations:
- &ref_2
id: onSubscribe
title: On subscribe
type: receive
messages:
- &ref_5
id: subscribe
payload:
- name: subscribe
type: object
properties:
- name: action
type: string
description: subscribe
required: true
- name: chain_id
type: integer
required: true
- name: dataset_id
type: string
description: '0203'
required: true
- name: params
type: object
required: true
properties:
- name: contract_address
type: string
required: false
headers: []
jsonPayloadSchema:
type: object
properties:
action:
type: string
const: subscribe
x-parser-schema-id:
chain_id:
type: integer
x-parser-schema-id:
dataset_id:
type: string
const: '0203'
x-parser-schema-id:
params:
type: object
properties:
contract_address:
type: string
x-parser-schema-id:
x-parser-schema-id:
required:
- action
- chain_id
- dataset_id
- params
x-parser-schema-id:
title: Subscribe
example: |-
{
"action": "",
"chain_id": 123,
"dataset_id": "",
"params": {
"contract_address": ""
}
}
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe
- id: x-parser-message-name
value: subscribe
bindings: []
extensions: &ref_0
- id: x-parser-unique-object-id
value: erc1155-tokens
- &ref_3
id: onUnsubscribe
title: On unsubscribe
type: receive
messages:
- &ref_6
id: unsubscribe
payload:
- name: unsubscribe
type: object
properties:
- name: action
type: string
description: unsubscribe
required: true
- name: chain_id
type: integer
required: true
- name: dataset_id
type: string
description: '0203'
required: true
headers: []
jsonPayloadSchema:
type: object
properties:
action:
type: string
const: unsubscribe
x-parser-schema-id:
chain_id:
type: integer
x-parser-schema-id:
dataset_id:
type: string
const: '0203'
x-parser-schema-id:
required:
- action
- chain_id
- dataset_id
x-parser-schema-id:
title: Unsubscribe
example: |-
{
"action": "",
"chain_id": 123,
"dataset_id": ""
}
bindings: []
extensions:
- id: x-parser-unique-object-id
value: unsubscribe
- id: x-parser-message-name
value: unsubscribe
bindings: []
extensions: *ref_0
- &ref_4
id: emitUpdates
title: Emit updates
type: send
messages:
- &ref_7
id: subscribe_response
payload:
- name: subscribe_response
type: object
properties:
- name: action
type: string
description: subscribe
required: true
- name: chain_id
type: integer
required: true
- name: dataset_id
type: string
description: '0203'
required: true
- name: status
type: string
enumValues:
- success
- error
required: true
- name: error
type: object
required: false
properties:
- name: code
type: string
description: Machine-readable error code.
required: true
- name: message
type: string
description: Human-readable summary of the error.
required: true
- name: hint
type: string
description: Diagnostic hint to help resolve the issue.
required: false
- name: severity
type: string
enumValues:
- info
- warning
- error
- critical
required: true
- name: retryable
type: boolean
description: Whether the client should attempt to retry the operation.
required: true
- name: details
type: object
description: Additional structured metadata about the error.
required: false
- name: docs_url
type: string
description: Link to relevant documentation for the error.
required: false
headers: []
jsonPayloadSchema:
type: object
properties:
action:
type: string
const: subscribe
x-parser-schema-id:
chain_id:
type: integer
x-parser-schema-id:
dataset_id:
type: string
const: '0203'
x-parser-schema-id:
status:
type: string
enum:
- success
- error
x-parser-schema-id:
error: &ref_1
type: object
properties:
code:
type: string
description: Machine-readable error code.
x-parser-schema-id:
message:
type: string
description: Human-readable summary of the error.
x-parser-schema-id:
hint:
type: string
description: Diagnostic hint to help resolve the issue.
x-parser-schema-id:
severity:
type: string
enum:
- info
- warning
- error
- critical
x-parser-schema-id:
retryable:
type: boolean
description: Whether the client should attempt to retry the operation.
x-parser-schema-id:
details:
type: object
description: Additional structured metadata about the error.
x-parser-schema-id:
docs_url:
type: string
format: uri
description: Link to relevant documentation for the error.
x-parser-schema-id:
required:
- code
- message
- severity
- retryable
x-parser-schema-id: ErrorObject
required:
- action
- chain_id
- dataset_id
- status
x-parser-schema-id:
title: Subscribe_response
example: No examples found
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe_response
- id: x-parser-message-name
value: subscribe_response
- &ref_8
id: unsubscribe_response
payload:
- name: unsubscribe_response
type: object
properties:
- name: action
type: string
description: unsubscribe
required: true
- name: chain_id
type: integer
required: true
- name: dataset_id
type: string
description: '0203'
required: true
- name: status
type: string
enumValues:
- success
- error
required: true
- name: error
type: object
required: false
properties:
- name: code
type: string
description: Machine-readable error code.
required: true
- name: message
type: string
description: Human-readable summary of the error.
required: true
- name: hint
type: string
description: Diagnostic hint to help resolve the issue.
required: false
- name: severity
type: string
enumValues:
- info
- warning
- error
- critical
required: true
- name: retryable
type: boolean
description: Whether the client should attempt to retry the operation.
required: true
- name: details
type: object
description: Additional structured metadata about the error.
required: false
- name: docs_url
type: string
description: Link to relevant documentation for the error.
required: false
headers: []
jsonPayloadSchema:
type: object
properties:
action:
type: string
const: unsubscribe
x-parser-schema-id:
chain_id:
type: integer
x-parser-schema-id:
dataset_id:
type: string
const: '0203'
x-parser-schema-id:
status:
type: string
enum:
- success
- error
x-parser-schema-id:
error: *ref_1
required:
- action
- chain_id
- dataset_id
- status
x-parser-schema-id:
title: Unsubscribe_response
example: No examples found
bindings: []
extensions:
- id: x-parser-unique-object-id
value: unsubscribe_response
- id: x-parser-message-name
value: unsubscribe_response
- &ref_9
id: update
payload:
- name: update
type: object
properties:
- name: chain_id
type: integer
required: true
- name: dataset_id
type: string
description: '0203'
required: true
- name: is_reorg
type: boolean
required: true
- name: data
type: object
required: true
properties:
- name: contract_address
type: string
required: false
- name: name
type: string
required: false
- name: symbol
type: string
required: false
- name: decimals
type: integer
required: false
- name: block_number
type: integer
required: false
- name: _tracing_id
type: string
required: false
headers: []
jsonPayloadSchema:
type: object
properties:
chain_id:
type: integer
x-parser-schema-id:
dataset_id:
type: string
const: '0203'
x-parser-schema-id:
is_reorg:
type: boolean
x-parser-schema-id:
data:
type: object
properties:
contract_address:
type: string
x-parser-schema-id:
name:
type: string
x-parser-schema-id:
symbol:
type: string
x-parser-schema-id:
decimals:
type: integer
x-parser-schema-id:
block_number:
type: integer
x-parser-schema-id:
_tracing_id:
type: string
x-parser-schema-id:
x-parser-schema-id:
required:
- chain_id
- dataset_id
- is_reorg
- data
x-parser-schema-id:
title: Update
example: |-
{
"chain_id": 123,
"dataset_id": "",
"is_reorg": true,
"data": {
"contract_address": "",
"name": "",
"symbol": "",
"decimals": 123,
"block_number": 123,
"_tracing_id": ""
}
}
bindings: []
extensions:
- id: x-parser-unique-object-id
value: update
- id: x-parser-message-name
value: update
bindings: []
extensions: *ref_0
sendOperations:
- *ref_2
- *ref_3
receiveOperations:
- *ref_4
sendMessages:
- *ref_5
- *ref_6
receiveMessages:
- *ref_7
- *ref_8
- *ref_9
extensions:
- id: x-parser-unique-object-id
value: erc1155-tokens
securitySchemes: []
````