bmap_readPosts

Read social posts from the BMAP API (query layer). Can fetch posts by author (BAP ID), specific post by transaction ID, or recent posts from all users. Supports pagination and feed functionality.

Read as Markdown

Result

Matching BMAP posts as JSON text.

Permissions

No spending approval is requested by this handler. Public network lookups can still fail or require a compatible service.

Inputs and availability

Full catalog · Before wallet setup; Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Local Vault + sponsor; Droplit wallet

Field	Type / required	Description
bapId	string Optional	BAP identity key to filter posts by author
txid	string Optional	Specific transaction ID to fetch
limit	number Optional	Maximum number of posts to return default: 20; minimum: 1; maximum: 100
page	number Optional	Page number for pagination (1-based) default: 1; minimum: 1
feed	boolean Optional	Whether to fetch feed (posts from followed users) default: false
address	string Optional	Bitcoin address to filter posts by

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "type": "object",
  "properties": {
    "bapId": {
      "description": "BAP identity key to filter posts by author",
      "type": "string"
    },
    "txid": {
      "description": "Specific transaction ID to fetch",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of posts to return",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination (1-based)",
      "type": "number",
      "minimum": 1
    },
    "feed": {
      "default": false,
      "description": "Whether to fetch feed (posts from followed users)",
      "type": "boolean"
    },
    "address": {
      "description": "Bitcoin address to filter posts by",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}