SovAds Docs

Publisher routes

Publisher registration, sites, balance, and withdrawals.

All publisher endpoints check that wallet in the body matches the publisher record on file. There is no API key — wallet ownership is the credential.

EndpointDescription
POST /registerCreate a publisher + site record, returns siteId.
GET /sitesList sites owned by a wallet.
GET /balanceEarned + claimable balance for a site.
POST /topupDeposit G$ to the publisher vault on-chain.
POST /withdrawWithdraw available earnings.
POST /exchangeSwap SOV ↔ G$ at the protocol rate.