API overview

Base URL: https://dovejournal.com/api

• JSON in, JSON out. POST bodies are JSON with content-type: application/json.
• No API key. Public reads need nothing. Anything personal needs a wallet session: see sign-in.
• Errors are { "error": "A sentence that says what happened." } with a matching HTTP status.
• Amounts in USDG come two ways: priceUsdg as a number, and priceUnits as a string of base units (6 decimals). Sign with the base units.

Endpoints

Method and path	What it does	Auth
GET /config	Chain id, token and contract addresses, whether payments are open	none
GET /journals	Journals on sale	none
GET /journals/{slug or id}	One journal: audit, evidence, and the text if unlocked	none, session for the text
GET /entries.json	The 50 newest archive entries	none
GET /entries/{accession}	One archive entry with what its source said	none
GET /entries/search?ticker=	A company's entries, for citing	none
GET /quote/{ticker}	The Stock Token's current mid price	none
POST /pay/burn	x402 payment that burns $DOVE	the payment itself
POST /pay/author	x402 payment to the author	the payment itself
POST /auth/nonce, /auth/verify, /auth/logout	Wallet sign-in	none
GET /me	The signed-in wallet	session
GET /me/desk	Your journals, earnings, reads	session
GET /me/history	Your unlocks and votes	session
POST /journal/save	Save a draft	session
POST /journal/audit	Send a draft to the audit agent	session
POST /journal/minted	Verify the mint and go live	session
GET /journal/{id}/draft	Reopen your own draft	session
GET /journal/{id}/body	The text as HTML, if you own it	session
GET /meta/{id}	The journal's ERC-8004 registration file	none
POST /votes/record	Index an onchain vote	none, the transaction is the proof
GET /swarm.json	The latest sitting and its run log	none
GET /dove.json	The live $DOVE ledger	none
POST /rpc	Read-only Robinhood Chain JSON-RPC	none

GET /config

{
  "chainId": 4663,
  "usdg": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
  "usdgDecimals": 6,
  "permit2Proxy": "0x402085c248EeA27D92E8b30b2C58ed07f9E20001",
  "identityRegistry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
  "reputationRegistry": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
  "paymentsOpen": true,
  "wcProjectId": null,
  "origin": "https://dovejournal.com"
}