●Lineage Explorer API · v1.0.0 · OpenAPI 3.1.0

API reference

Read-only public REST API for the Lineage block explorer. Read blocks, transactions, addresses, items, and supply over plain HTTP. Every endpoint is grouped by resource, with its parameters, response shape, and an example.

Base URLhttps://explorer.lineage.to

OpenAPI spec ↗

Testnet. These endpoints serve the public testnet. A mainnet will be announced separately.

Blocks

GET/api/v1/blocks

List blocks

Parameters

Name	Type	In	Required	Description
limit	integer	query	optional	—
offset	integer \| null	query	optional	—
order	"asc" \| "desc"	query	optional	—

Responses

200application/jsonA page of blocks

Field	Type	Required	Description
data	BlockSummary[]	required	—
└ num	integer	required	—
└ hash	string	required	—
└ previousHash	string \| null	required	—
└ timestamp	string \| null	required	—
└ version	integer	required	—
└ nbTx	integer \| null	required	—
pagination	Pagination	required	—
└ total	integer	required	—
└ limit	integer	required	—
└ offset	integer	required	—
└ hasMore	boolean	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/blocks"

Example response

json

{
  "data": [
    {
      "num": 0,
      "hash": "string",
      "previousHash": "string",
      "timestamp": "2026-01-01T00:00:00.000Z",
      "version": 0,
      "nbTx": 0
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "hasMore": false
  }
}

GET/api/v1/blocks/{id}

Get a block by height or hash

Parameters

Name	Type	In	Required	Description
id	string	path	required	—

Responses

200application/jsonA block

Field	Type	Required	Description
num	integer	required	—
hash	string	required	—
previousHash	string \| null	required	—
timestamp	string \| null	required	—
version	integer	required	—
nbTx	integer \| null	required	—
merkleRootHash	string \| null	required	—
bits	string \| null	required	—

404application/problem+jsonNot found

Example request

curl

curl "https://explorer.lineage.to/api/v1/blocks/1"

Example response

json

{
  "num": 0,
  "hash": "string",
  "previousHash": "string",
  "timestamp": "2026-01-01T00:00:00.000Z",
  "version": 0,
  "nbTx": 0,
  "merkleRootHash": "string",
  "bits": "string"
}

GET/api/v1/blocks/{id}/transactions

List a block's transactions

Parameters

Name	Type	In	Required	Description
id	string	path	required	—

Responses

200application/jsonThe block's transactions

Field	Type	Required	Description
data	BlockTransaction[]	required	—
└ hash	string	required	—
└ blockHash	string	required	—
└ version	integer	required	—
└ timestamp	string \| null	required	—
└ type	"token" \| "item" \| "coinbase" \| "unknown"	required	—
└ coinbase	boolean	required	—

404application/problem+jsonNot found

Example request

curl

curl "https://explorer.lineage.to/api/v1/blocks/1/transactions"

Example response

json

{
  "data": [
    {
      "hash": "string",
      "blockHash": "string",
      "version": 0,
      "timestamp": "2026-01-01T00:00:00.000Z",
      "type": "token",
      "coinbase": false
    }
  ]
}

Transactions

GET/api/v1/transactions

List transactions (excludes coinbase)

Parameters

Name	Type	In	Required	Description
limit	integer	query	optional	—
offset	integer \| null	query	optional	—
order	"asc" \| "desc"	query	optional	—

Responses

200application/jsonA page of transactions

Field	Type	Required	Description
data	TransactionSummary[]	required	—
└ hash	string	required	—
└ blockHash	string	required	—
└ version	integer	required	—
└ timestamp	string \| null	required	—
└ type	"token" \| "item" \| "coinbase" \| "unknown"	required	—
pagination	Pagination	required	—
└ total	integer	required	—
└ limit	integer	required	—
└ offset	integer	required	—
└ hasMore	boolean	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/transactions"

Example response

json

{
  "data": [
    {
      "hash": "string",
      "blockHash": "string",
      "version": 0,
      "timestamp": "2026-01-01T00:00:00.000Z",
      "type": "token"
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "hasMore": false
  }
}

GET/api/v1/transactions/{hash}

Get a transaction by hash

Parameters

Name	Type	In	Required	Description
hash	string	path	required	—

Responses

200application/jsonA transaction

Field	Type	Required	Description
hash	string	required	—
blockHash	string	required	—
version	integer	required	—
timestamp	string \| null	required	—
type	"token" \| "item" \| "coinbase" \| "unknown"	required	—
inputs	object[]	required	—
└ fromAddress	string \| null	required	—
└ amount	string \| null	required	—
└ amountLngx	string \| null	required	—
└ previousOutTxHash	string \| null	required	—
└ previousOutTxN	integer \| null	required	—
outputs	object[]	required	—
└ n	integer	required	—
└ valueType	string	required	—
└ amount	string \| null	required	—
└ amountLngx	string \| null	required	—
└ address	string \| null	required	—
└ locktime	string	required	—
└ genesisHash	string \| null	required	—
└ itemMetadata	string \| null	required	—

404application/problem+jsonNot found

Example request

curl

curl "https://explorer.lineage.to/api/v1/transactions/tx_2"

Example response

json

{
  "hash": "string",
  "blockHash": "string",
  "version": 0,
  "timestamp": "2026-01-01T00:00:00.000Z",
  "type": "token",
  "inputs": [
    {
      "fromAddress": "string",
      "amount": "string",
      "amountLngx": "string",
      "previousOutTxHash": "string",
      "previousOutTxN": 0
    }
  ],
  "outputs": [
    {
      "n": 0,
      "valueType": "string",
      "amount": "string",
      "amountLngx": "string",
      "address": "string",
      "locktime": "string",
      "genesisHash": "string",
      "itemMetadata": "string"
    }
  ]
}

Addresses

GET/api/v1/addresses/{address}

Get an address balance

Parameters

Name	Type	In	Required	Description
address	string	path	required	—

Responses

200application/jsonThe address balance

Field	Type	Required	Description
address	string	required	—
balance	string	required	—
balanceLngx	string	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/addresses/addr_1"

Example response

json

{
  "address": "string",
  "balance": "string",
  "balanceLngx": "string"
}

GET/api/v1/addresses/{address}/transactions

List an address's transactions

Parameters

Name	Type	In	Required	Description
address	string	path	required	—
limit	integer	query	optional	—
offset	integer \| null	query	optional	—

Responses

200application/jsonA page of the address's transactions

Field	Type	Required	Description
data	AddressTransaction[]	required	—
└ hash	string	required	—
└ blockHash	string	required	—
└ version	integer	required	—
└ timestamp	string \| null	required	—
└ type	"token" \| "item" \| "coinbase" \| "unknown"	required	—
└ inputs	object[]	required	—
└ fromAddress	string \| null	required	—
└ amount	string \| null	required	—
└ amountLngx	string \| null	required	—
└ previousOutTxHash	string \| null	required	—
└ previousOutTxN	integer \| null	required	—
└ outputs	object[]	required	—
└ n	integer	required	—
└ valueType	string	required	—
└ amount	string \| null	required	—
└ amountLngx	string \| null	required	—
└ address	string \| null	required	—
└ locktime	string	required	—
└ genesisHash	string \| null	required	—
└ itemMetadata	string \| null	required	—
└ blockNum	integer	required	—
└ balanceAfter	string	required	—
└ balanceAfterLngx	string	required	—
pagination	Pagination	required	—
└ total	integer	required	—
└ limit	integer	required	—
└ offset	integer	required	—
└ hasMore	boolean	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/addresses/addr_1/transactions"

Example response

json

{
  "data": [
    {
      "hash": "string",
      "blockHash": "string",
      "version": 0,
      "timestamp": "2026-01-01T00:00:00.000Z",
      "type": "token",
      "inputs": [
        {
          "fromAddress": "string",
          "amount": "string",
          "amountLngx": "string",
          "previousOutTxHash": "string",
          "previousOutTxN": 0
        }
      ],
      "outputs": [
        {
          "n": 0,
          "valueType": "string",
          "amount": "string",
          "amountLngx": "string",
          "address": "string",
          "locktime": "string",
          "genesisHash": "string",
          "itemMetadata": "string"
        }
      ],
      "blockNum": 0,
      "balanceAfter": "string",
      "balanceAfterLngx": "string"
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "hasMore": false
  }
}

Items

GET/api/v1/items

Search minted items by metadata substring and/or genesis hash

Returns item outputs (mints and transfers). Provide `q` for a case-insensitive metadata substring match, `genesis` for an exact item-class filter, or both. At least one is required.

Parameters

Name	Type	In	Required	Description
limit	integer	query	optional	—
offset	integer \| null	query	optional	—
q	string	query	optional	—
genesis	string	query	optional	—

Responses

200application/jsonA page of item outputs

Field	Type	Required	Description
data	ItemOutput[]	required	—
└ genesisHash	string \| null	required	—
└ metadata	string \| null	required	—
└ address	string \| null	required	—
└ amount	string \| null	required	—
└ amountLngx	string \| null	required	—
└ spent	boolean	required	—
└ txHash	string	required	—
└ n	integer	required	—
└ blockNum	integer	required	—
└ blockHash	string	required	—
└ timestamp	string \| null	required	—
pagination	Pagination	required	—
└ total	integer	required	—
└ limit	integer	required	—
└ offset	integer	required	—
└ hasMore	boolean	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/items?q=sword&genesis=g7f3c2a8"

Example response

json

{
  "data": [
    {
      "genesisHash": "string",
      "metadata": "string",
      "address": "string",
      "amount": "string",
      "amountLngx": "string",
      "spent": false,
      "txHash": "string",
      "n": 0,
      "blockNum": 0,
      "blockHash": "string",
      "timestamp": "2026-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "hasMore": false
  }
}

Chain

GET/api/v1/supply

Circulating and total supply

Responses

200application/jsonSupply figures

Field	Type	Required	Description
circulating	string	required	—
circulatingLngx	string	required	—
total	string \| null	required	—
totalLngx	string \| null	required	—
ticker	string	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/supply"

Example response

json

{
  "circulating": "string",
  "circulatingLngx": "string",
  "total": "string",
  "totalLngx": "string",
  "ticker": "string"
}

GET/api/v1/status

Chain and indexer status

Responses

200application/jsonChain status

Field	Type	Required	Description
network	string	required	—
ticker	string	required	—
height	integer \| null	required	—
blocks	integer	required	—
transactions	integer	required	—

Example request

curl

curl "https://explorer.lineage.to/api/v1/status"

Example response

json

{
  "network": "string",
  "ticker": "string",
  "height": 0,
  "blocks": 0,
  "transactions": 0
}