API Reference - PMX API

Base URL

https://api.pmx.trade/v2

All requests require an API key in the X-API-Key header.

Method	Endpoint	Description
POST	`/markets/:slug/trade/buy`	Buy shares
POST	`/markets/:slug/trade/sell`	Sell shares

Method	Endpoint	Description
GET	`/markets/:slug/claim`	Get claim info
POST	`/markets/:slug/claim`	Execute claim

Write operations (create, buy) use the X.402 protocol:

Request

Submit operation details

402 Response

Receive payment instructions with recipient address and amount

Pay

Execute USDC transfer on Solana

Confirm

Resubmit with transaction signature

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid market slug"
  }
}