# Steem API
> Read the Steem blockchain and its social layer (Steemit) live — no key needed. The account endpoint returns a Steemit account's social profile and on-chain stats: display name, about, location, website, reputation score, post count, STEEM and SBD balances and the account-creation date. The trending endpoint returns the posts trending on Steemit right now (author, title, votes, pending payout, optional tag). The network endpoint returns chain-wide stats — head block and current/virtual STEEM supply. Data comes live from Steem's own public RPC node — nothing cached, nothing stored. Steem is a distinct blockchain-social network, separate from Hive since the 2020 fork. Built for social dashboards, creator analytics, on-chain explorers and trend monitoring.

## 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/steem-api/..."
```

## Pricing
- **Free** (Free) — 25,000 calls/Mo, 3 req/s
- **Starter** ($7/Mo) — 330,000 calls/Mo, 10 req/s
- **Pro** ($20/Mo) — 1,420,000 calls/Mo, 25 req/s
- **Scale** ($46/Mo) — 4,950,000 calls/Mo, 50 req/s

## Endpoints

### Account

#### `GET /v1/account` — Account profile and on-chain stats

**Parameters:**
- `username` (query, required, string) — Steem account name Example: `blocktrades`

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

**Response:**
```json
{
    "data": {
        "about": null,
        "source": "Steem",
        "created": "2016-03-30T00:04:33Z",
        "website": null,
        "location": null,
        "username": "blocktrades",
        "last_post": "2020-03-20T04:15:57",
        "post_count": 2751,
        "reputation": 74.56,
        "sbd_balance": 1244.412,
        "display_name": null,
        "steem_balance": 8653.192,
        "steem_power_vests": 0
    },
    "meta": {
        "timestamp": "2026-06-11T16:47:02.391Z",
        "request_id": "e4582b19-6d0b-465b-b377-1204dbef7251"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

### Trending

#### `GET /v1/trending` — Posts trending on Steemit now

**Parameters:**
- `tag` (query, optional, string) — Optional tag filter
- `limit` (query, optional, string) — Max posts (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steem-api/v1/trending?limit=10"
```

**Response:**
```json
{
    "data": {
        "tag": "photography",
        "count": 10,
        "posts": [
            {
                "title": "তারাপিঠের শ্মশান",
                "author": "ritzy-writer",
                "created": "2026-06-10T16:15:06Z",
                "category": "hive-129948",
                "children": 1,
                "permlink": "post-1277-1781108101",
                "net_votes": null,
                "pending_payout": 91.98
            },
            {
                "title": "[카일의 일상#878]The Perfect! 가즈아!",
                "author": "khaiyoui",
                "created": "2026-06-11T09:57:36Z",
                "category": "kr",
                "children": 2,
                "permlink": "878-the-perfect",
                "net_votes": null,
                "pending_payout": 32.159
            },
            {
                "title": "Hardy Chrysanthemums Flowers",
                "author": "photolens",
                "created": "2026-06-10T21:54:57Z",
                "category": "flower",
                "children": 0,
                "permlink": "hardy-chrysanthemums-flowers",
                "net_votes": null,
                "pending_payout": 24.458
            },
            {
                "title": "Peony, Velvet Majesty in Bloom",
                "author": "focusframe",
                "created": "2026-06-10T21:53:03Z",
                "category": "photography",
                "children": 1,
                "
…(truncated, see openapi.json for full schema)
```

### Network

#### `GET /v1/network` — Steem chain-wide stats

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

**Response:**
```json
{
    "data": {
        "time": "2026-06-11T16:47:00Z",
        "chain": "Steem",
        "source": "Steem",
        "head_block": 106851807,
        "sbd_supply": 6580098.606,
        "current_supply": 549682536.119,
        "virtual_supply": 610758372.407,
        "total_vesting_steem": 195463231.061
    },
    "meta": {
        "timestamp": "2026-06-11T16:47:02.952Z",
        "request_id": "242be4a5-5fcb-4567-9860-7ebbb111e6af"
    },
    "status": "ok",
    "message": "Network retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "note": "Usernames are Steem account names (e.g. blocktrades, steemit). Reputation is the familiar display score; balances are in STEEM/SBD; trending accepts an optional tag.",
        "source": "Steem public RPC (api.steemit.com, live)",
        "service": "steem-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/account": "Social profile and on-chain stats for an account (username=blocktrades).",
            "GET /v1/network": "Steem chain-wide stats — head block and STEEM supply.",
            "GET /v1/trending": "Posts trending on Steemit now, optional tag (tag=&limit=10, max 50)."
        },
        "head_block": 106851815,
        "description": "Live data from the Steem blockchain and its social layer (Steemit). The account endpoint returns a Steemit account's social profile and on-chain stats (display name, about, location, website, reputation score, post count, STEEM and SBD balances, creation date); the trending endpoint returns the posts trending on Steemit right now; the network endpoint returns chain-wide stats (head block, current and virtual STEEM supply). Live, no key, nothing stored. A genuine blockchain-social feed, distinct from Hive — Steem is a separate chain since the 2020 fork.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T16:47:24.850Z",
        "request_id": "977d5a9e-312c-491a-87ef-4fc1b51ea25d"
    },
    "status": "ok",
    "message": 
…(truncated, see openapi.json for full schema)
```

### Accounts

#### `GET /v1/followers` — Who follows a user, with total counts

**Parameters:**
- `username` (query, required, string) — Steem account name Example: `steemitblog`
- `limit` (query, optional, string) — Max sampled followers (1-100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steem-api/v1/followers?username=steemitblog&limit=50"
```

**Response:**
```json
{
    "data": {
        "source": "Steem",
        "username": "steemitblog",
        "followers": [
            "javis1225",
            "zeeshanbahi",
            "abbiejamie",
            "ikechukwu77",
            "cekmadcm",
            "archie25",
            "backofgames",
            "bdshahab",
            "writerchoice",
            "carson435",
            "thelucifer",
            "jackxiaoma",
            "mani158",
            "starfall2026",
            "obibtc001",
            "daniwise84",
            "danaljannah",
            "divado",
            "cur8.academy",
            "cur8",
            "christel237",
            "gideonuwas1993",
            "hive-177926",
            "sethare",
            "abucapt",
            "muntazirhassan",
            "youngkeen",
            "majorjack",
            "mjeelifestyle",
            "moses005",
            "steemone.com",
            "shahbazsial",
            "hive-109722",
            "tariqbhai",
            "mikehydes",
            "onlykemzzy",
            "realchampion1",
            "internetexpert",
            "bethrand",
            "effiongd",
            "youngqueen100",
            "alif123",
            "freshjay",
            "adeyemi212",
            "mustafamohameed",
            "nurhaman",
            "drnajiba",
            "fati12",
            "prompttech",
            "engrtitu"
        ],
        "sample_count": 50,
        "follower_count": 40765,
        "following_count": 15
    },
  
…(truncated, see openapi.json for full schema)
```

### Posts

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

**Parameters:**
- `username` (query, required, string) — Steem account name Example: `steemitblog`
- `limit` (query, optional, string) — Max posts (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steem-api/v1/blog?username=steemitblog&limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "posts": [
            {
                "url": "https://steemit.com/@steemitblog/steemit-update-june-8th-2026-steemit-challenge-season-32-week-3",
                "title": "Steemit Update [June 8th, 2026] : Steemit Challenge Season 32 - Week 3",
                "author": "steemitblog",
                "created": "2026-06-08T03:52:00Z",
                "category": "steemitchallenge",
                "children": 5,
                "permlink": "steemit-update-june-8th-2026-steemit-challenge-season-32-week-3",
                "net_votes": 98,
                "total_payout": 0,
                "pending_payout": 2.613
            },
            {
                "url": "https://steemit.com/@steemitblog/steemit-update-may-31st-2026-steemit-challenge-season-32-week-2",
                "title": "Steemit Update [May 31st, 2026] : Steemit Challenge Season 32 - Week 2",
                "author": "steemitblog",
                "created": "2026-05-31T17:09:09Z",
                "category": "steemitchallenge",
                "children": 19,
                "permlink": "steemit-update-may-31st-2026-steemit-challenge-season-32-week-2",
                "net_votes": 110,
                "total_payout": 0,
                "pending_payout": 0
            },
            {
                "url": "https://steemit.com/@steemitblog/steemit-update-may-29th-2026-community-curators-for-june",
                "title": "Steemit Update [May 29th, 2026] : Commun
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/post` — One post in full with body text

**Parameters:**
- `author` (query, required, string) — Post author Example: `steemit`
- `permlink` (query, required, string) — Post permlink (from /v1/blog or /v1/trending) Example: `firstpost`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steem-api/v1/post?author=steemit&permlink=firstpost"
```

**Response:**
```json
{
    "data": {
        "url": "https://steemit.com/@steemit/firstpost",
        "title": "Welcome to Steem!",
        "author": "steemit",
        "source": "Steem",
        "created": "2016-03-30T18:30:18Z",
        "category": "meta",
        "children": 441,
        "permlink": "firstpost",
        "body_text": "Steemit is a social media platform where anyone can earn STEEM points by posting. The more people who like a post, the more STEEM the poster earns. Anyone can sell their STEEM for cash or vest it to boost their voting power.",
        "net_votes": 90,
        "total_payout": 0.942,
        "pending_payout": 0
    },
    "meta": {
        "timestamp": "2026-06-13T13:56:12.197Z",
        "request_id": "a736c308-fba8-451c-8e18-01bca54700c4"
    },
    "status": "ok",
    "message": "Post retrieved successfully",
    "success": true
}
```

#### `GET /v1/replies` — The comment replies on a post

**Parameters:**
- `author` (query, required, string) — Post author Example: `steemit`
- `permlink` (query, required, string) — Post permlink Example: `firstpost`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steem-api/v1/replies?author=steemit&permlink=firstpost"
```

**Response:**
```json
{
    "data": {
        "count": 326,
        "author": "steemit",
        "source": "Steem",
        "replies": [
            {
                "author": "admin",
                "created": "2016-03-30T19:52:30Z",
                "permlink": "firstpost",
                "body_text": "First Reply! Let's get this party started",
                "net_votes": 8
            },
            {
                "author": "proskynneo",
                "created": "2016-03-31T13:54:33Z",
                "permlink": "steemit-firstpost-1",
                "body_text": "Glad to see this live and working! Excited to see where the community goes and excited to be able to use this through a gui instead of the command linne! :D",
                "net_votes": 7
            },
            {
                "author": "red",
                "created": "2016-04-06T19:22:42Z",
                "permlink": "steemit-firstpost-2",
                "body_text": "Did you know you can earn STEEM by commenting on posts?",
                "net_votes": 7
            },
            {
                "author": "business",
                "created": "2016-07-13T08:29:15Z",
                "permlink": "re-steemit-firstpost-20160713t082910980z",
                "body_text": "Welcome to steemit, @steemit.",
                "net_votes": 8
            },
            {
                "author": "gopher",
                "created": "2016-07-18T19:58:09Z",
                "permlink": "re-steemit-firstpost-20160718t1958063
…(truncated, see openapi.json for full schema)
```


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