# Hive API
> Live data for the Hive blockchain social network, served straight from Hive's public JSON-RPC nodes — no key, no account, nothing cached. Hive is a decentralised blogging and social platform where posts and votes live on-chain and earn crypto rewards. The account endpoint resolves a username to its profile: display name, reputation score, follower and following counts, post count, bio, location, website and join date — @gtg ("Gandalf the Grey") has a 76 reputation and over ten thousand followers. The posts endpoint returns a user's blog posts with each post's up-vote count, the HBD payout it earned, the comment count, the tags and a link. The trending endpoint returns the platform's trending (or hot, new or top-paid) posts right now, optionally filtered by tag — the front page of Hive. This is the profile-posts-and-trends layer for any decentralised-social, blogging or web3 app. Live from the Hive blockchain, nothing stored. Distinct from other social and centralised-blog APIs — this is the on-chain Hive network. 4 endpoints.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/hive-api/..."
```

## Pricing
- **Free** (Free) — 13,200 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 158,000 calls/Mo, 8 req/s
- **Pro** ($16/Mo) — 705,000 calls/Mo, 15 req/s
- **Scale** ($39/Mo) — 3,520,000 calls/Mo, 30 req/s

## Endpoints

### Hive

#### `GET /v1/account` — A Hive user profile

**Parameters:**
- `user` (query, required, string) — Hive username Example: `gtg`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/account?user=gtg"
```

**Response:**
```json
{
    "data": {
        "bio": "IT Wizard, Hive Witness",
        "url": "https://hive.blog/@gtg",
        "cover": null,
        "posts": 7375,
        "avatar": "https://grey.house/img/gandalf.png",
        "created": "2016-06-30T17:22:18",
        "website": null,
        "location": "Hive",
        "username": "gtg",
        "followers": 10955,
        "following": 847,
        "reputation": 76.01,
        "display_name": "Gandalf the Grey"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:52.557Z",
        "request_id": "7b50b88d-3108-490d-82ca-3fbf98ddd55c"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/posts` — A user's blog posts

**Parameters:**
- `user` (query, required, string) — Hive username Example: `gtg`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/posts?user=gtg&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "posts": [
            {
                "url": "https://hive.blog/hive-160391/@gtg/thank-you-for-passing-by",
                "tags": [
                    "hive",
                    "witness-category",
                    "community",
                    "anniversary"
                ],
                "title": "Thank you for passing by",
                "votes": 805,
                "author": "gtg",
                "created": "2026-03-20T15:09:27",
                "excerpt": "Six years of Hive. A decade of the platform. \"Can you promise that I will come back?\" \"No. And if you do, you will not be the same.\" - The Hobbit: An Unexpected Journey I'm a Hive witness, and one of the core developers of the platform. I've spent nearly a decade making sure the chain keeps producin",
                "category": "hive-160391",
                "comments": 134,
                "permlink": "thank-you-for-passing-by",
                "payout_hbd": 62.276
            },
            {
                "url": "https://hive.blog/hive-160391/@gtg/hive-hardfork-28-jump-starter-kit",
                "tags": [
                    "hivepressure",
                    "dev",
                    "witness-category",
                    "hive",
                    "doc",
                    "faq"
                ],
                "title": "Hive HardFork 28 Jump Starter Kit",
                "votes": 881,
                "author": "gtg",
                
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trending` — Platform trending posts

**Parameters:**
- `sort` (query, optional, string) — trending | hot | created | payout Example: `trending`
- `tag` (query, optional, string) — Filter by tag Example: `photography`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/trending?sort=trending&tag=photography&limit=20"
```

**Response:**
```json
{
    "data": {
        "tag": "photography",
        "sort": "trending",
        "count": 20,
        "posts": [
            {
                "url": "https://hive.blog/hive-163772/@onyfest/museu-do-coa-exterior-riding-portugal",
                "tags": [
                    "photography",
                    "gems",
                    "ocd",
                    "creativecoin",
                    "neoxian",
                    "travel",
                    "palnet",
                    "portugal",
                    "lifestyle",
                    "blog"
                ],
                "title": "Museu do Côa - Exterior / Riding Portugal",
                "votes": 860,
                "author": "onyfest",
                "created": "2026-06-08T22:25:00",
                "excerpt": "Hello everyone and welcome to my blog :-) This was the reason that brought us to this part of the country, the famous Côa Museum, and the arrival was one of those moments when I realized that the way it was conceived and built made the building itself compete for attention with the surrounding lands",
                "category": "hive-163772",
                "comments": 8,
                "permlink": "museu-do-coa-exterior-riding-portugal",
                "payout_hbd": 19.745
            },
            {
                "url": "https://hive.blog/hive-163772/@ladytruckview/worth-stopping-for",
                "tags": [
                    "travel",
                    "travelfeed",
      
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Hive public JSON-RPC API (bridge.*, live)",
        "service": "hive-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/posts": "A user's blog posts (user=gtg, limit up to 50): votes, payout, comments.",
            "GET /v1/account": "A user's Hive profile (user=gtg): reputation, followers, posts, bio.",
            "GET /v1/trending": "Platform posts (sort=trending|hot|created|payout, optional tag=, limit up to 50)."
        },
        "description": "Live data for the Hive blockchain social network from its public JSON-RPC nodes: a username's profile (display name, reputation, followers, following, post count, bio, location, website, join date); a user's blog posts with up-votes, HBD payout, comment count and tags; and the platform's trending, hot, new or top-paid posts, optionally by tag. Live, no key, nothing stored. Distinct from other social and centralised-blog APIs — this is the on-chain Hive network.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:55.802Z",
        "request_id": "3c5b7317-0c24-461c-b02e-7b9142b0f802"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/hive-api
OpenAPI spec: https://www.oanor.com/api/hive-api/openapi.json