Junkinals Explorer

Junkinals Explorer API Documentation

Complete API reference for the Junkcoin blockchain explorer. All endpoints are available and working with real data.

Base URL

https://ord.junkiewally.xyz

Example Address (Customizable)

Default address - Contains real junkscriptions and JUNK-20 tokens for testing.

Live API Tester

Test any API endpoint directly. Click the test buttons below or enter a custom URL.

Block Data

Endpoints for blockchain block information

GET

/block-count

available

Get current block height

Example Request:

https://ord.junkiewally.xyz/block-count

Example Response:

GET

/blocks/tip/height

available

Alternative endpoint for current block height

Example Request:

https://ord.junkiewally.xyz/blocks/tip/height

Example Response:

GET

/block/{hash}

available

Get block details by hash or height

Parameters:

hash

string

required

Block hash or height

Example Request:

https://ord.junkiewally.xyz/block/300000

Example Response:

{
  "hash": "00000000000000000008a89e854d57e5667df88f1cdef6fde2fbca1de5b639ad",
  "height": 300000,
  "timestamp": 1640995200,
  "tx_count": 2847,
  "size": 1234567,
  "weight": 3993456,
  "merkle_root": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
  "previous_block_hash": "00000000000000000007316856900e76b4f7a9139cfbfba89842c8d196cd5f91"
}

Address & Ownership

Endpoints for address-based queries and asset ownership

GET

/address/{address}/assets

available

Get all assets (junkscriptions + JUNK-20 tokens) owned by an address

Parameters:

address

string

required

JKC address

Example Request:

https://ord.junkiewally.xyz/api/address/7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns/assets

Example Response:

{
  "address": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns",
  "junkscriptions": {
    "count": 3,
    "items": [
      {
        "id": "b8f5e8c2d1a9f6e3b7c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6i0",
        "content_type": "text/html",
        "content_length": 1024,
        "genesis_height": 299850,
        "genesis_timestamp": 1640995200,
        "inscription_number": 12345
      },
      {
        "id": "a7e4d7c1b0a8f5e2b6c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5i1",
        "content_type": "image/png",
        "content_length": 2048,
        "genesis_height": 299851,
        "genesis_timestamp": 1640995800,
        "inscription_number": 12346
      }
    ]
  },
  "junk20": {
    "count": 2,
    "items": [
      {
        "tick": "junk",
        "available": "500000000000",
        "transferable": "250000000000"
      },
      {
        "tick": "test",
        "available": "1000000000",
        "transferable": "500000000"
      }
    ]
  }
}

GET

/address/{address}/summary

available

Get summary of address activity and holdings

Parameters:

address

string

required

JKC address

Example Request:

https://ord.junkiewally.xyz/api/address/7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns/summary

Example Response:

{
  "address": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns",
  "junkscriptions_count": 3,
  "junk20_tokens_count": 2,
  "total_transactions": 15,
  "first_seen_block": 299850,
  "last_activity_block": 299852,
  "has_assets": true
}

Junkscriptions

Endpoints for Junkscription data and content

GET

/junkscriptions

available

Get latest junkscriptions (HTML response with thumbnails)

Example Request:

https://ord.junkiewally.xyz/junkscriptions

Example Response:

<!DOCTYPE html>
<html>
<head><title>Latest Junkscriptions</title></head>
<body>
  <div class="junkscription-grid">
    <div class="junkscription-item">
      <a href="/junkscription/b8f5e8c2d1a9f6e3b7c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6i0">
        <img src="/content/b8f5e8c2d1a9f6e3b7c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6i0" alt="Junkscription #12345">
        <span>Junkscription #12345</span>
      </a>
    </div>
    <!-- More junkscriptions... -->
  </div>
</body>
</html>

[Response truncated - full HTML response available via direct request]

GET

/junkscriptions?page=1&limit=5

available

Get paginated junkscriptions (JSON when Accept: application/json)

Parameters:

page

number

Page number (default: 1)

limit

number

Items per page (default: 20)

Example Request:

https://ord.junkiewally.xyz/junkscriptions?page=1&limit=5

Example Response:

{
  "junkscriptions": [
    {
      "id": "b8f5e8c2d1a9f6e3b7c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6i0",
      "number": 12345,
      "content_type": "text/html",
      "content_length": 1024,
      "genesis_height": 299850,
      "genesis_timestamp": 1640995200,
      "address": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns"
    },
    {
      "id": "a7e4d7c1b0a8f5e2b6c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5i1",
      "number": 12346,
      "content_type": "image/png",
      "content_length": 2048,
      "genesis_height": 299851,
      "genesis_timestamp": 1640995800,
      "address": "8jXwZYXvoHs8zjyvHxptNTrpBwn8eSS9ot"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 12567,
    "total_pages": 2514,
    "has_next": true,
    "has_prev": false
  }
}

JUNK-20 Tokens

Endpoints for JUNK-20 token information and balances

GET

/junk20/ticks

available

Get all available JUNK-20 token tickers

Example Request:

https://ord.junkiewally.xyz/junk20/ticks

Example Response:

{
  "ticks": [
    {
      "tick": "junk",
      "max": "21000000000000000",
      "lim": "1000000000000",
      "dec": "8",
      "deployed_height": 299800,
      "deployed_timestamp": 1640994000,
      "total_minted": "15750000000000000",
      "holders": 1247
    },
    {
      "tick": "test",
      "max": "100000000000000",
      "lim": "50000000000",
      "dec": "8",
      "deployed_height": 299820,
      "deployed_timestamp": 1640994600,
      "total_minted": "25000000000000",
      "holders": 89
    }
  ]
}

GET

/junk20/tick/{tick}

available

Get detailed information for a specific token

Parameters:

tick

string

required

Token ticker (case insensitive)

Example Request:

https://ord.junkiewally.xyz/junk20/tick/junk

Example Response:

{
  "tick": "junk",
  "max": "21000000000000000",
  "lim": "1000000000000",
  "dec": "8",
  "deployed_height": 299800,
  "deployed_timestamp": 1640994000,
  "deployer": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns",
  "total_minted": "15750000000000000",
  "remaining": "5250000000000000",
  "holders": 1247,
  "transactions": 8934,
  "last_mint_height": 300120,
  "last_mint_timestamp": 1641001200
}

GET

/junk20/balance/{address}

available

Get JUNK-20 token balances for an address

Parameters:

address

string

required

JKC address

Example Request:

https://ord.junkiewally.xyz/junk20/balance/7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns

Example Response:

{
  "address": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns",
  "junk20": [
    {
      "tick": "junk",
      "available": "500000000000",
      "transferable": "250000000000",
      "overall_balance": "750000000000"
    },
    {
      "tick": "test",
      "available": "1000000000",
      "transferable": "500000000",
      "overall_balance": "1500000000"
    }
  ]
}

Search & Discovery

Endpoints for searching and discovering content

GET

/search

available

Universal search for addresses, transactions, junkscriptions, and tokens

Parameters:

q

string

required

Search query

type

string

Filter by type: address, tx, junkscription, junk20

Example Request:

https://ord.junkiewally.xyz/api/search?q=7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns&type=address

Example Response:

{
  "query": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns",
  "type": "address",
  "results": [
    {
      "type": "address",
      "address": "7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns",
      "junkscriptions_count": 3,
      "junk20_tokens_count": 2,
      "has_assets": true
    }
  ],
  "total_results": 1
}

Usage Notes & Best Practices

Static Example Responses

All response examples shown are static examples based on real data structure. Use the "Test" buttons or the Live API Tester above to get actual current responses from the endpoints.

Dynamic Address Examples

You can customize the example address above to see how URLs would look with different addresses. The default address 7iWvZYWvnHr7ziyvHxotMTqpAwm7dSR8ns is guaranteed to have data for testing.

Rate Limiting

Please be respectful with API usage. Recommended: max 10 requests per second.

JUNK-20 Token Amounts

All token amounts are returned in the smallest unit. For tokens with 8 decimals, divide by 100,000,000 to get the display amount.

Content Types

Most endpoints return JSON by default. The /junkscriptions endpoint returns HTML by default, but you can get JSON by setting the Accept: application/json header.