Grails API Documentation

GET /api/v1/offers/buyer/:address

Get all offers made by a specific buyer address, ordered by most recent first.

Authentication: None

Cache: None

Path Parameters

Parameter	Type	Required	Description
`address`	string	Yes	Buyer’s Ethereum address

Query Parameters

Parameter	Type	Default	Description
`page`	number	`1`	Page number
`limit`	number	`20`	Results per page
`status`	string	—	Filter by status: `pending`, `accepted`, `rejected`, `expired`, `unfunded`

Sample Request


curl "https://api.grails.app/api/v1/offers/buyer/0x1234...?status=pending"

Response


// 200 OK
{
  "success": true,
  "data": {
    "offers": [
      {
        "id": 99,
        "ens_name_id": 1,
        "buyer_address": "0x1234...",
        "offer_amount_wei": "50000000000000000",
        "currency_address": "0x0000000000000000000000000000000000000000",
        "order_hash": "0xabc123...",
        "order_data": { ... },
        "status": "pending",
        "created_at": "2026-04-07T12:00:00.000Z",
        "expires_at": "2026-05-01T00:00:00.000Z",
        "source": "grails",
        "last_validated_at": "2026-04-07T13:00:00.000Z",
        "unfunded_at": null,
        "unfunded_reason": null,
        "name": "example.eth",
        "token_id": "12345..."
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 5,
      "totalPages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  },
  "meta": {
    "timestamp": "2026-04-07T12:00:00.000Z",
    "version": "1.0.0"
  }
}