Grails API Documentation

GET /api/v1/user/history/sales

Names the authenticated user has sold, ordered by most recent.

Authentication: Required

Cache: None

Query Parameters

Parameter	Type	Default	Description
`page`	number	`1`	Page number
`limit`	number	`20`	Results per page (1-100)

Extra Fields

Field	Type	Description
`sale.id`	number	Sale record ID
`sale.price_wei`	string	Sale price in wei
`sale.currency_address`	string	Payment token address
`sale.sale_date`	string	When the sale occurred
`sale.transaction_hash`	string	On-chain transaction hash
`sale.buyer_address`	string	Buyer’s address

Sample Request


curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.grails.app/api/v1/user/history/sales?limit=10"

Response


// 200 OK
{
  "success": true,
  "data": {
    "names": [
      {
        // ... standard SearchResult fields (id, name, token_id, owner, etc.)
        "sale": {
          "id": 77,
          "price_wei": "500000000000000000",
          "currency_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "sale_date": "2026-03-15T09:00:00.000Z",
          "transaction_hash": "0xdef456...",
          "buyer_address": "0xabcdef1234567890abcdef1234567890abcdef12"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 2,
      "totalPages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  },
  "meta": {
    "timestamp": "2026-04-07T12:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
404	`USER_NOT_FOUND`	User account not found