# DeSo Decentralized Social API
> Live data from DeSo (Decentralized Social), a layer-1 blockchain purpose-built for social media where every profile, post and follow lives on-chain and each creator has their own tradeable creator coin — read from a public DeSo node, no key, nothing stored. The profile endpoint returns a username's on-chain profile: description, verification, profile picture and the creator-coin economy behind it — coin price in DESO, DeSo locked into the coin, coins in circulation and the founder reward. The followers endpoint returns the follower and following counts. The posts endpoint returns a creator's posts, each with its on-chain engagement: likes, diamonds (direct on-chain tips), comments and reposts. The feed endpoint returns the newest posts across the whole network. Look up any DeSo creator, read their reach and creator-coin valuation, and pull their content as structured JSON. This is a social-blockchain cut with a built-in creator-coin economy — distinct from the other decentralized-social platforms and from the crypto price and market APIs in the catalogue.

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

## Pricing
- **Free** (Free) — 24,000 calls/Mo, 3 req/s
- **Creator** ($7/Mo) — 270,000 calls/Mo, 10 req/s
- **Pro** ($21/Mo) — 1,100,000 calls/Mo, 28 req/s
- **Scale** ($49/Mo) — 3,700,000 calls/Mo, 60 req/s

## Endpoints

### Profile

#### `GET /v1/profile` — On-chain profile and creator-coin economy

**Parameters:**
- `username` (query, required, string) — DeSo username Example: `nader`

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

**Response:**
```json
{
    "data": {
        "source": "DeSo",
        "username": "nader",
        "is_hidden": false,
        "public_key": "BC1YLhyuDGeWVgHmh3UQEoKstda525T1LnonYWURBdpgWbFBfRuntP5",
        "description": "Creator of the DeSo blockchain, creator of @focus, creator of $Openfund \n",
        "is_verified": false,
        "creator_coin": {
            "price_deso": 29.750636,
            "deso_locked": 987.5281,
            "founder_reward_pct": 100,
            "coins_in_circulation": 99.5805
        }
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:47.114Z",
        "request_id": "62514de1-e08b-450d-90c6-da9765dd8856"
    },
    "status": "ok",
    "message": "Profile retrieved successfully",
    "success": true
}
```

### Followers

#### `GET /v1/followers` — Follower and following counts

**Parameters:**
- `username` (query, required, string) — DeSo username Example: `nader`

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

**Response:**
```json
{
    "data": {
        "source": "DeSo",
        "username": "nader",
        "followers": 25086,
        "following": 275
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:48.795Z",
        "request_id": "5e95c9bd-404b-43bd-a86e-0664c1fcdd72"
    },
    "status": "ok",
    "message": "Followers retrieved successfully",
    "success": true
}
```

### Posts

#### `GET /v1/posts` — A creator posts with engagement

**Parameters:**
- `username` (query, required, string) — DeSo username Example: `nader`
- `limit` (query, optional, string) — Max posts (1-100) Example: `20`

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

**Response:**
```json
{
    "data": {
        "count": 20,
        "posts": [
            {
                "body": "Hi all, apologies for the issues on Focus. Everything should be resolved now. Thank you for your patience.\n\nThis was a complex technical issue with the Focus api servers that we had to put significant resources into fixing, but everything appears to be running smoothly now. The feed should update soon, and the Openfund live transaction histories should also be updating in real time again (they were powered by the same service).",
                "likes": 0,
                "author": null,
                "reposts": 7,
                "comments": 28,
                "diamonds": 21,
                "post_hash": "d35ec22748229a8e864c402910e9ea5c4b784b505d0c461bc7e8f37a12fe9a01",
                "timestamp": "2026-06-07T06:20:48.294Z"
            },
            {
                "body": "Every platform in crypto right now is competing to the death for the trading of the same core assets (btc, top alts, now RWAs). Some will make money but they're selling a commodity.\n\nThe people who will make real money in the next cycle are the ones who create new assets for people to trade that you can't get anywhere else. As originators they'll make money no matter what frontend people are trading on.\n\nMore to come soon...",
                "likes": 0,
                "author": null,
                "reposts": 12,
                "comments": 48,
                "diamonds": 25,
                "p
…(truncated, see openapi.json for full schema)
```

### Feed

#### `GET /v1/feed` — Newest posts across the network

**Parameters:**
- `limit` (query, optional, string) — Max posts (1-100) Example: `20`

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

**Response:**
```json
{
    "data": {
        "count": 20,
        "posts": [
            {
                "body": "Rainy season seems to be here in Siem Reap, What better way to celebrate than with some cool rainy photos. \n\nThis is a collage but you could see them all online on my Instagram at https://www.instagram.com/ventures_on\n\n#rain #rainphotography #siemreap #Cambodia #pubstreetsiemreap",
                "likes": 0,
                "author": "ventures_on",
                "reposts": 0,
                "comments": 0,
                "diamonds": 0,
                "post_hash": "c6a94baacb7e9046575c20ebcc2a873d46843b4870dcbc28d3413e0ead26352b",
                "timestamp": "2026-06-11T16:41:37.595Z"
            },
            {
                "body": "Good night everyone ",
                "likes": 0,
                "author": "Shawnkark",
                "reposts": 0,
                "comments": 0,
                "diamonds": 0,
                "post_hash": "972f106d1c511d4656a4093838123067923e58c7c7fe161540282d11d6a2a0b8",
                "timestamp": "2026-06-11T16:25:25.842Z"
            },
            {
                "body": "Will Deso give a big comeback Soon or it will late?",
                "likes": 0,
                "author": "Wolverine009",
                "reposts": 0,
                "comments": 0,
                "diamonds": 0,
                "post_hash": "cfe07852cc1265a93dc57702b39398d3e67b84bd1419615d5ee0152f32a9bfcc",
                "timestamp": "2026-06-11T16:17:3
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "On-chain amounts are nanos (1 DESO = 1e9 nanos); coin price, locked value and circulating supply are converted to DESO. Diamonds are on-chain tips. Identify a creator by username (nader, mossified).",
        "source": "Public DeSo node (node.deso.org/api/v0, live)",
        "service": "deso-api",
        "endpoints": {
            "GET /v1/feed": "Newest posts across the whole DeSo network (limit=20).",
            "GET /v1/meta": "This document.",
            "GET /v1/posts": "A creator's posts with likes, diamonds, comments, reposts (username=nader, limit=20).",
            "GET /v1/profile": "On-chain profile and creator-coin economy (username=nader).",
            "GET /v1/followers": "Follower and following counts (username=nader)."
        },
        "description": "Live data from DeSo (Decentralized Social), a layer-1 blockchain built for social media where every profile, post and follow is on-chain and each creator has a tradeable creator coin. The profile endpoint returns a username's on-chain profile (description, verification, picture, and the creator-coin economy: coin price in DESO, DeSo locked, coins in circulation, founder reward); the followers endpoint returns follower and following counts; the posts endpoint returns a creator's posts with engagement (likes, diamonds, comments, reposts); the feed endpoint returns the newest posts across the network. Live, no key, nothing stored. A social-blockchain cut with a creator-coin eco
…(truncated, see openapi.json for full schema)
```


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