Tokens · ERC-1155 - BlockDB Docs

curl -X POST "https://api.blockdb.io/v1/evm/entities/tokens/erc1155" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_timestamp": "2025-10-29T00:00:00Z",
  "to_timestamp": "2025-11-11T00:00:00Z",
  "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
}'

#include <curl/curl.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (!curl) return 1;

    const char *token = getenv("BLOCKDB_API_KEY");
    char auth_header[256];
    snprintf(auth_header, sizeof(auth_header), "Authorization: Bearer %s", token ? token : "");
    const char *payload = "{\"chain_id\":1,\"from_block\":12345678,\"to_block\":12345999,\"contract_address\":\"495f947276749ce646f68ac8c248420045cb7b5e\"}";

    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, auth_header);
    headers = curl_slist_append(headers, "Content-Type: application/json");

    curl_easy_setopt(curl, CURLOPT_URL, "https://api.blockdb.io/v1/evm/entities/tokens/erc1155");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);

    CURLcode res = curl_easy_perform(curl);

    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return res == CURLE_OK ? 0 : 1;
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("BLOCKDB_API_KEY"));

        var payload = new StringContent(
            "{\"chain_id\":1,\"from_block\":12345678,\"to_block\":12345999,\"contract_address\":\"495f947276749ce646f68ac8c248420045cb7b5e\"}",
            Encoding.UTF8,
            "application/json"
        );

        var response = await client.PostAsync("https://api.blockdb.io/v1/evm/entities/tokens/erc1155", payload);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

import os
import requests

response = requests.post(
    "https://api.blockdb.io/v1/evm/entities/tokens/erc1155",
    headers={
        "Authorization": f"Bearer {os.getenv('BLOCKDB_API_KEY')}",
        "Content-Type": "application/json"
    },
    json={
        'chain_id': 1,
        'from_block': 12345678,
        'to_block': 12345999,
        'from_timestamp': '2025-10-29T00:00:00Z',
        'to_timestamp': '2025-11-11T00:00:00Z',
        'contract_address': '495f947276749ce646f68ac8c248420045cb7b5e'
    }
)

data = response.json()
print(data)

const response = await fetch("https://api.blockdb.io/v1/evm/entities/tokens/erc1155", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.BLOCKDB_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    chain_id: 1,
    from_block: 12345678,
    to_block: 12345999,
    from_timestamp: "2025-10-29T00:00:00Z",
    to_timestamp: "2025-11-11T00:00:00Z",
    contract_address: "495f947276749ce646f68ac8c248420045cb7b5e"
  })
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "os"
    "strings"
)

func main() {
    payload := strings.NewReader(`{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
}`)

    req, _ := http.NewRequest("POST", "https://api.blockdb.io/v1/evm/entities/tokens/erc1155", payload)
    req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", os.Getenv("BLOCKDB_API_KEY")))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    // Handle response
}

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": "2025-10-29T00:00:00Z",
      "to_timestamp": "2025-11-11T00:00:00Z"
    },
    "resolved_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": "2025-10-29T00:00:00Z",
      "to_timestamp": "2025-11-11T00:00:00Z"
    },
    "filters": {
      "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
    }
  },
  "data": [
    {
      "contract_id": "495f947276749ce646f68ac8c248420045cb7b5e00bb875f0074",
      "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": "020300000000000000000000000000000001",
      "_parent_tracing_ids": ["010300000000000000000000000000000001"],
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    }
  ],
  "cursor": null,
  "page_count": 1
}

{
  "error": {
    "code": "BAD_REQUEST",
    "http_status": 400,
    "message": "The request contains invalid or missing parameters.",
    "hint": "Validate all required parameters against the endpoint specification before retrying.",
    "severity": "error",
    "retryable": false,
    "details": {
      "invalid_parameters": [
        {
          "name": "chain_id",
          "location": "query",
          "reason": "missing",
          "expected": "positive integer, e.g. 1"
        },
        {
          "name": "from_timestamp",
          "location": "query",
          "reason": "invalid_format",
          "expected": "ISO-8601 UTC timestamp, e.g. 2025-11-11T00:00:00Z"
        }
      ]
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/home"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "http_status": 401,
    "message": "Invalid or missing API key.",
    "hint": "Ensure you send 'Authorization: Bearer <API_KEY>' in every request to this endpoint.",
    "severity": "error",
    "retryable": false,
    "details": {
      "auth_scheme": "bearer",
      "expected_header": "Authorization: Bearer <API_KEY>",
      "provided_header": "Authorization: <REDACTED_OR_MISSING>",
      "token_status": "invalid_or_missing",
      "recommendation": "Regenerate the API key if you suspect it is expired or compromised."
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/authorization"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "http_status": 403,
    "message": "Your API key does not have permission to access this endpoint.",
    "hint": "Upgrade your subscription tier or request additional access.",
    "severity": "warning",
    "retryable": false,
    "details": {
      "required_plan": "production",
      "your_plan": null,
      "contact": "support@blockdb.io",
      "recommendation": "Contact BlockDB Support Team via email support@blockdb.io."
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "http_status": 404,
    "message": "The requested resource does not exist.",
    "hint": "Verify the API endpoint",
    "severity": "warning",
    "retryable": false,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "PAYLOAD_TOO_LARGE",
    "http_status": 413,
    "message": "The requested response exceeds the maximum allowed size of 10 MB.",
    "hint": "Reduce the limit, narrow the block or time window, or apply additional filters before retrying.",
    "details": {
      "max_allowed_bytes": 10485760,
      "estimated_response_bytes": 15360000,
      "recommended_actions": [
        "Decrease the 'limit' parameter value",
        "Shorten the block range or time window",
        "Filter by fewer contract addresses"
      ]
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/pagination-and-limits"
  }
}

{
  "error": {
    "code": "CHAIN_NOT_SUPPORTED",
    "http_status": 422,
    "message": "chain_id=137 is not supported.",
    "hint": "Use a supported chain_id. Consult the documentation for the list of available chains.",
    "severity": "error",
    "retryable": false,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "http_status": 429,
    "message": "You have exceeded the allowed request rate.",
    "hint": "Introduce client-side throttling or exponential backoff and respect the retry_after_seconds value.",
    "details": {
      "limit_rps": 1000,
      "current_estimated_rps": 73,
      "retry_after_seconds": 2,
      "limit_scope": "api_key",
      "limit_window_seconds": 1
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/rate-limiting"
  }
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "http_status": 500,
    "message": "An unexpected server error occurred.",
    "hint": "This error is not caused by your request. You may retry after a short delay.",
    "severity": "critical",
    "retryable": true,
    "details": {
      "incident_id": "INC-2025-11-11-123456",
      "temporary_issue": true,
      "expected_recovery_seconds": 5
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "http_status": 503,
    "message": "The service is temporarily unable to handle the request.",
    "hint": "The database connection pool is briefly saturated. Retry after a short delay.",
    "severity": "warning",
    "retryable": true,
    "details": null,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

POST

evm

entities

tokens

erc1155

curl -X POST "https://api.blockdb.io/v1/evm/entities/tokens/erc1155" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_timestamp": "2025-10-29T00:00:00Z",
  "to_timestamp": "2025-11-11T00:00:00Z",
  "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
}'

#include <curl/curl.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (!curl) return 1;

    const char *token = getenv("BLOCKDB_API_KEY");
    char auth_header[256];
    snprintf(auth_header, sizeof(auth_header), "Authorization: Bearer %s", token ? token : "");
    const char *payload = "{\"chain_id\":1,\"from_block\":12345678,\"to_block\":12345999,\"contract_address\":\"495f947276749ce646f68ac8c248420045cb7b5e\"}";

    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, auth_header);
    headers = curl_slist_append(headers, "Content-Type: application/json");

    curl_easy_setopt(curl, CURLOPT_URL, "https://api.blockdb.io/v1/evm/entities/tokens/erc1155");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);

    CURLcode res = curl_easy_perform(curl);

    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return res == CURLE_OK ? 0 : 1;
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("BLOCKDB_API_KEY"));

        var payload = new StringContent(
            "{\"chain_id\":1,\"from_block\":12345678,\"to_block\":12345999,\"contract_address\":\"495f947276749ce646f68ac8c248420045cb7b5e\"}",
            Encoding.UTF8,
            "application/json"
        );

        var response = await client.PostAsync("https://api.blockdb.io/v1/evm/entities/tokens/erc1155", payload);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

import os
import requests

response = requests.post(
    "https://api.blockdb.io/v1/evm/entities/tokens/erc1155",
    headers={
        "Authorization": f"Bearer {os.getenv('BLOCKDB_API_KEY')}",
        "Content-Type": "application/json"
    },
    json={
        'chain_id': 1,
        'from_block': 12345678,
        'to_block': 12345999,
        'from_timestamp': '2025-10-29T00:00:00Z',
        'to_timestamp': '2025-11-11T00:00:00Z',
        'contract_address': '495f947276749ce646f68ac8c248420045cb7b5e'
    }
)

data = response.json()
print(data)

const response = await fetch("https://api.blockdb.io/v1/evm/entities/tokens/erc1155", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.BLOCKDB_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    chain_id: 1,
    from_block: 12345678,
    to_block: 12345999,
    from_timestamp: "2025-10-29T00:00:00Z",
    to_timestamp: "2025-11-11T00:00:00Z",
    contract_address: "495f947276749ce646f68ac8c248420045cb7b5e"
  })
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "os"
    "strings"
)

func main() {
    payload := strings.NewReader(`{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
}`)

    req, _ := http.NewRequest("POST", "https://api.blockdb.io/v1/evm/entities/tokens/erc1155", payload)
    req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", os.Getenv("BLOCKDB_API_KEY")))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    // Handle response
}

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": "2025-10-29T00:00:00Z",
      "to_timestamp": "2025-11-11T00:00:00Z"
    },
    "resolved_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": "2025-10-29T00:00:00Z",
      "to_timestamp": "2025-11-11T00:00:00Z"
    },
    "filters": {
      "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
    }
  },
  "data": [
    {
      "contract_id": "495f947276749ce646f68ac8c248420045cb7b5e00bb875f0074",
      "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": "020300000000000000000000000000000001",
      "_parent_tracing_ids": ["010300000000000000000000000000000001"],
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    }
  ],
  "cursor": null,
  "page_count": 1
}

{
  "error": {
    "code": "BAD_REQUEST",
    "http_status": 400,
    "message": "The request contains invalid or missing parameters.",
    "hint": "Validate all required parameters against the endpoint specification before retrying.",
    "severity": "error",
    "retryable": false,
    "details": {
      "invalid_parameters": [
        {
          "name": "chain_id",
          "location": "query",
          "reason": "missing",
          "expected": "positive integer, e.g. 1"
        },
        {
          "name": "from_timestamp",
          "location": "query",
          "reason": "invalid_format",
          "expected": "ISO-8601 UTC timestamp, e.g. 2025-11-11T00:00:00Z"
        }
      ]
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/home"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "http_status": 401,
    "message": "Invalid or missing API key.",
    "hint": "Ensure you send 'Authorization: Bearer <API_KEY>' in every request to this endpoint.",
    "severity": "error",
    "retryable": false,
    "details": {
      "auth_scheme": "bearer",
      "expected_header": "Authorization: Bearer <API_KEY>",
      "provided_header": "Authorization: <REDACTED_OR_MISSING>",
      "token_status": "invalid_or_missing",
      "recommendation": "Regenerate the API key if you suspect it is expired or compromised."
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/authorization"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "http_status": 403,
    "message": "Your API key does not have permission to access this endpoint.",
    "hint": "Upgrade your subscription tier or request additional access.",
    "severity": "warning",
    "retryable": false,
    "details": {
      "required_plan": "production",
      "your_plan": null,
      "contact": "support@blockdb.io",
      "recommendation": "Contact BlockDB Support Team via email support@blockdb.io."
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "http_status": 404,
    "message": "The requested resource does not exist.",
    "hint": "Verify the API endpoint",
    "severity": "warning",
    "retryable": false,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "PAYLOAD_TOO_LARGE",
    "http_status": 413,
    "message": "The requested response exceeds the maximum allowed size of 10 MB.",
    "hint": "Reduce the limit, narrow the block or time window, or apply additional filters before retrying.",
    "details": {
      "max_allowed_bytes": 10485760,
      "estimated_response_bytes": 15360000,
      "recommended_actions": [
        "Decrease the 'limit' parameter value",
        "Shorten the block range or time window",
        "Filter by fewer contract addresses"
      ]
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/pagination-and-limits"
  }
}

{
  "error": {
    "code": "CHAIN_NOT_SUPPORTED",
    "http_status": 422,
    "message": "chain_id=137 is not supported.",
    "hint": "Use a supported chain_id. Consult the documentation for the list of available chains.",
    "severity": "error",
    "retryable": false,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "http_status": 429,
    "message": "You have exceeded the allowed request rate.",
    "hint": "Introduce client-side throttling or exponential backoff and respect the retry_after_seconds value.",
    "details": {
      "limit_rps": 1000,
      "current_estimated_rps": 73,
      "retry_after_seconds": 2,
      "limit_scope": "api_key",
      "limit_window_seconds": 1
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/rate-limiting"
  }
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "http_status": 500,
    "message": "An unexpected server error occurred.",
    "hint": "This error is not caused by your request. You may retry after a short delay.",
    "severity": "critical",
    "retryable": true,
    "details": {
      "incident_id": "INC-2025-11-11-123456",
      "temporary_issue": true,
      "expected_recovery_seconds": 5
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "http_status": 503,
    "message": "The service is temporarily unable to handle the request.",
    "hint": "The database connection pool is briefly saturated. Retry after a short delay.",
    "severity": "warning",
    "retryable": true,
    "details": null,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

Overview

Dataset ID: 0203 - ERC-1155 Tokens
Description: Catalog of ERC-1155 Multi Token contracts (EIP-1155); one contract can have many token types.
CSV Sample: Download
JSON Sample: Download

Parameters

number

required

Target EVM network. See the Chain enumeration for supported values.

Range Filters (mutually exclusive)

number

Starting block number (inclusive) for the query. Use with to_block.

number

Ending block number (inclusive) for the query. Use with from_block.

string

Starting timestamp (ISO-8601). If it falls between blocks, the next block after this timestamp is used. Use with to_timestamp.

string

Ending timestamp (ISO-8601). If it falls between blocks, the last block before this timestamp is used. Use with from_timestamp.

Scoping rule: Provide exactly one of:

Block range — from_block and to_block
Time range — from_timestamp and to_timestamp
Direct selectors — presented below

Direct selectors may be used on their own, without a block or time range. Do not combine scoping modes. Omitting all three returns HTTP 400.

Contract Address Filter

string

Specific ERC-1155 token contract address to return (hex string, 20 bytes, no 0x prefix).

Pagination Controls

number

default:"250"

Recommended default 250; maximum 1000 to stay under ~10 MB responses.

string

Pagination cursor from a prior call.

Response Fields

Data

object[]

Each element matches the linked dataset (no chain_id column — use meta.chain_id).

string

Unique contract incarnation ID (26 bytes hex). Disambiguates redeployed contracts at the same address.

string

The Ethereum contract address of the ERC-1155 multi-token contract.

number

Block number of the contract recognition event.

string

Block timestamp joined from the blocks table for easier selection and grouping.

number

Transaction index within the genesis block.

string | null

Contract name from name() (optional in EIP-1155).

string | null

Contract symbol from symbol() (optional in EIP-1155).

number | null

Contract decimals from decimals() (optional in EIP-1155).

string | null

URI from uri(uint256) (optional ERC1155Metadata_URI). Clients replace {id} with token ID in hex (64 chars).

boolean | null

Whether the contract supports the ERC1155Metadata_URI extension; null when detection was via fallback.

string

Row-level lineage hash (hex string, no 0x prefix).

string[]

Lineage references of immediate parents.

string

Record creation timestamp, e.g. "2025-11-11T18:42:15.123Z".

string

Last update timestamp in the same format.

Envelope Fields

string | null

Cursor token for pagination.

number

Number of records returned in data.

curl -X POST "https://api.blockdb.io/v1/evm/entities/tokens/erc1155" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_timestamp": "2025-10-29T00:00:00Z",
  "to_timestamp": "2025-11-11T00:00:00Z",
  "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
}'

#include <curl/curl.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (!curl) return 1;

    const char *token = getenv("BLOCKDB_API_KEY");
    char auth_header[256];
    snprintf(auth_header, sizeof(auth_header), "Authorization: Bearer %s", token ? token : "");
    const char *payload = "{\"chain_id\":1,\"from_block\":12345678,\"to_block\":12345999,\"contract_address\":\"495f947276749ce646f68ac8c248420045cb7b5e\"}";

    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, auth_header);
    headers = curl_slist_append(headers, "Content-Type: application/json");

    curl_easy_setopt(curl, CURLOPT_URL, "https://api.blockdb.io/v1/evm/entities/tokens/erc1155");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);

    CURLcode res = curl_easy_perform(curl);

    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return res == CURLE_OK ? 0 : 1;
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("BLOCKDB_API_KEY"));

        var payload = new StringContent(
            "{\"chain_id\":1,\"from_block\":12345678,\"to_block\":12345999,\"contract_address\":\"495f947276749ce646f68ac8c248420045cb7b5e\"}",
            Encoding.UTF8,
            "application/json"
        );

        var response = await client.PostAsync("https://api.blockdb.io/v1/evm/entities/tokens/erc1155", payload);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

import os
import requests

response = requests.post(
    "https://api.blockdb.io/v1/evm/entities/tokens/erc1155",
    headers={
        "Authorization": f"Bearer {os.getenv('BLOCKDB_API_KEY')}",
        "Content-Type": "application/json"
    },
    json={
        'chain_id': 1,
        'from_block': 12345678,
        'to_block': 12345999,
        'from_timestamp': '2025-10-29T00:00:00Z',
        'to_timestamp': '2025-11-11T00:00:00Z',
        'contract_address': '495f947276749ce646f68ac8c248420045cb7b5e'
    }
)

data = response.json()
print(data)

const response = await fetch("https://api.blockdb.io/v1/evm/entities/tokens/erc1155", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.BLOCKDB_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    chain_id: 1,
    from_block: 12345678,
    to_block: 12345999,
    from_timestamp: "2025-10-29T00:00:00Z",
    to_timestamp: "2025-11-11T00:00:00Z",
    contract_address: "495f947276749ce646f68ac8c248420045cb7b5e"
  })
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "os"
    "strings"
)

func main() {
    payload := strings.NewReader(`{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
}`)

    req, _ := http.NewRequest("POST", "https://api.blockdb.io/v1/evm/entities/tokens/erc1155", payload)
    req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", os.Getenv("BLOCKDB_API_KEY")))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    // Handle response
}

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": "2025-10-29T00:00:00Z",
      "to_timestamp": "2025-11-11T00:00:00Z"
    },
    "resolved_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": "2025-10-29T00:00:00Z",
      "to_timestamp": "2025-11-11T00:00:00Z"
    },
    "filters": {
      "contract_address": "495f947276749ce646f68ac8c248420045cb7b5e"
    }
  },
  "data": [
    {
      "contract_id": "495f947276749ce646f68ac8c248420045cb7b5e00bb875f0074",
      "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": "020300000000000000000000000000000001",
      "_parent_tracing_ids": ["010300000000000000000000000000000001"],
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    }
  ],
  "cursor": null,
  "page_count": 1
}

{
  "error": {
    "code": "BAD_REQUEST",
    "http_status": 400,
    "message": "The request contains invalid or missing parameters.",
    "hint": "Validate all required parameters against the endpoint specification before retrying.",
    "severity": "error",
    "retryable": false,
    "details": {
      "invalid_parameters": [
        {
          "name": "chain_id",
          "location": "query",
          "reason": "missing",
          "expected": "positive integer, e.g. 1"
        },
        {
          "name": "from_timestamp",
          "location": "query",
          "reason": "invalid_format",
          "expected": "ISO-8601 UTC timestamp, e.g. 2025-11-11T00:00:00Z"
        }
      ]
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/home"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "http_status": 401,
    "message": "Invalid or missing API key.",
    "hint": "Ensure you send 'Authorization: Bearer <API_KEY>' in every request to this endpoint.",
    "severity": "error",
    "retryable": false,
    "details": {
      "auth_scheme": "bearer",
      "expected_header": "Authorization: Bearer <API_KEY>",
      "provided_header": "Authorization: <REDACTED_OR_MISSING>",
      "token_status": "invalid_or_missing",
      "recommendation": "Regenerate the API key if you suspect it is expired or compromised."
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/authorization"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "http_status": 403,
    "message": "Your API key does not have permission to access this endpoint.",
    "hint": "Upgrade your subscription tier or request additional access.",
    "severity": "warning",
    "retryable": false,
    "details": {
      "required_plan": "production",
      "your_plan": null,
      "contact": "support@blockdb.io",
      "recommendation": "Contact BlockDB Support Team via email support@blockdb.io."
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "http_status": 404,
    "message": "The requested resource does not exist.",
    "hint": "Verify the API endpoint",
    "severity": "warning",
    "retryable": false,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "PAYLOAD_TOO_LARGE",
    "http_status": 413,
    "message": "The requested response exceeds the maximum allowed size of 10 MB.",
    "hint": "Reduce the limit, narrow the block or time window, or apply additional filters before retrying.",
    "details": {
      "max_allowed_bytes": 10485760,
      "estimated_response_bytes": 15360000,
      "recommended_actions": [
        "Decrease the 'limit' parameter value",
        "Shorten the block range or time window",
        "Filter by fewer contract addresses"
      ]
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/pagination-and-limits"
  }
}

{
  "error": {
    "code": "CHAIN_NOT_SUPPORTED",
    "http_status": 422,
    "message": "chain_id=137 is not supported.",
    "hint": "Use a supported chain_id. Consult the documentation for the list of available chains.",
    "severity": "error",
    "retryable": false,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "http_status": 429,
    "message": "You have exceeded the allowed request rate.",
    "hint": "Introduce client-side throttling or exponential backoff and respect the retry_after_seconds value.",
    "details": {
      "limit_rps": 1000,
      "current_estimated_rps": 73,
      "retry_after_seconds": 2,
      "limit_scope": "api_key",
      "limit_window_seconds": 1
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/rate-limiting"
  }
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "http_status": 500,
    "message": "An unexpected server error occurred.",
    "hint": "This error is not caused by your request. You may retry after a short delay.",
    "severity": "critical",
    "retryable": true,
    "details": {
      "incident_id": "INC-2025-11-11-123456",
      "temporary_issue": true,
      "expected_recovery_seconds": 5
    },
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "http_status": 503,
    "message": "The service is temporarily unable to handle the request.",
    "hint": "The database connection pool is briefly saturated. Retry after a short delay.",
    "severity": "warning",
    "retryable": true,
    "details": null,
    "docs_url": "https://docs.blockdb.io/api-reference/overview/error-codes"
  }
}

Last modified on July 19, 2026

Overview

SDKs

Account & Usage

EVM Endpoints

Enumerations

Tokens · ERC-1155

Overview

Parameters

Range Filters (mutually exclusive)

Contract Address Filter

Response Fields

Meta

Data

Envelope Fields

​Overview

​Parameters

​Range Filters (mutually exclusive)

​Contract Address Filter

​Pagination Controls

​Response Fields

​Meta

​Data

​Envelope Fields

Overview

Parameters

Range Filters (mutually exclusive)

Contract Address Filter

Pagination Controls

Response Fields

Meta

Data

Envelope Fields