Hive Developer logo

Hive Developer Portal

Methods:

Presents data interpreted by the hivemind database as JSON-RPC.

Also see: Communities Broadcast Ops

bridge.get_ranked_posts

Get ranked posts.

Supported values for sort:

The value for tag can be any valid tag.

The value for observer can be any valid account or empty string.

Query Parameters JSON
{"sort": "", "tag": "", "observer": ""}
Expected Response JSON
[
  {
    "post_id": 12345678,
    "author": "alice",
    "permlink": "that-march-hare",
    "category": "wonderland",
    "title": "That March Hare",
    "body": "I think he went mad.",
    "json_metadata": {
      "tags": ["wonderland"],
      "app": "hiveblog/0.1"
    },
    "created": "2019-12-05T16:29:12",
    "updated": "2019-12-05T16:29:12",
    "depth": 0,
    "children": 0,
    "net_rshares": 1539574839484,
    "is_paidout": false,
    "payout_at": "2019-12-12T16:29:12",
    "payout": 0.286,
    "pending_payout_value": "0.286 HBD",
    "author_payout_value": "0.000 HBD",
    "curator_payout_value": "0.000 HBD",
    "promoted": "0.000 HBD",
    "replies": [],
    "active_votes": [{"voter": "bob", "rshares": "67759296290"}],
    "author_reputation": 47.15,
    "stats": {
      "hide": false,
      "gray": false,
      "total_votes": 12,
      "flag_weight": 0
    },
    "beneficiaries": [],
    "max_accepted_payout": "1000000.000 HBD",
    "percent_steem_dollars": 10000,
    "url": "/wonderland/@alice/that-march-hare",
    "blacklists": []
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_ranked_posts", "params":{"sort":"trending","tag":"","observer":"alice"}, "id":1}' https://api.openhive.network

bridge.account_notifications

Account notifications.

Supported values for type:

The score value is based on the originating account’s rank.

Query Parameters JSON
{"account": "alice", "limit": 100}
Expected Response JSON
[
  {
    "id": 3629306,
    "type": "vote",
    "score": 25,
    "date": "2019-11-20T07:48:06",
    "msg": "@bob voted on your post ($0.013)",
    "url": "@alice/a-post-by-alice"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.account_notifications", "params":{"account":"alice","limit":100}, "id":1}' https://api.openhive.network

bridge.list_community_roles

List community roles and labels for each account in the community.

Query Parameters JSON
{"community": "hive-123456"}
Expected Response JSON
[
  ["hive-123456", "owner", ""],
  ["alice", "admin", "Miss"]
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_community_roles", "params":{"community":"hive-123456"}, "id":1}' https://api.openhive.network

bridge.list_all_subscriptions

List all subscriptions to a community for an account.

Query Parameters JSON
{"account": "alice"}
Expected Response JSON
[
  ["hive-123456", "Wonderland"],
  ["hive-654321", "Tulgey Wood"]
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_all_subscriptions", "params":{"account":"alice"}, "id":1}' https://api.openhive.network

bridge.get_community

Get community details.

Query Parameters JSON
{"name": "hive-123456", "observer": "alice"}
Expected Response JSON
{
  "id": 1332149,
  "name": "hive-123456",
  "title": "@hive-123456",
  "about": "Wonderland",
  "lang": "en",
  "type_id": 1,
  "is_nsfw": false,
  "subscribers": 0,
  "sum_pending": 0,
  "num_pending": 0,
  "created_at": "2019-10-27 08:28:54",
  "context": {
    "role": "admin",
    "title": "Miss",
    "subscribed": true
  },
  "description": "",
  "flag_text": "",
  "settings": {},
  "team": [
    ["hive-123456", "owner", ""],
    ["alice", "admin", "Miss"]
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_community", "params":{"name":"hive-123456","observer":"alice"}, "id":1}' https://api.openhive.network