Get Offer Information

This endpoint allows you to fetch detailed information about a specific offer.

Endpoint

Mainnet

GET https://api.spacescan.io/offer/HtLDNrF32NzjDSmbub4SYDsHDNBjucVvQvdaBUJBnzjf

Testnet

GET https://api-testnet11.spacescan.io/offer/HtLDNrF32NzjDSmbub4SYDsHDNBjucVvQvdaBUJBnzjf

Parameters

Parameter	Type	Required	Default	Description
offer_id	string	Yes	-	The unique identifier of the offer

Headers

Header	Type	Required	Description
version	string	Yes	API version
network	string	Yes	Network identifier (e.g., 'xch' for mainnet)

Free API

Use api.spacescan.io for free tier access. See our API Plans for rate limits and features.

Pro API

Use pro-api.spacescan.io with your API key in the x-api-key header. See our API Plans for details.

curl -X GET "https://pro-api.spacescan.io/offer/{offer_id}" \
     -H "x-api-key: YOUR_API_KEY" \
     -H "version: v1" \
     -H "network: xch"

Live API Test

Mainnet

🚀 Test API in Browser

Request Examples

cURL

curl -X GET "https://api.spacescan.io/offer/HtLDNrF32NzjDSmbub4SYDsHDNBjucVvQvdaBUJBnzjf" \
     -H "version: v1" \
     -H "network: xch"

Python

import requests

offer_id = "HtLDNrF32NzjDSmbub4SYDsHDNBjucVvQvdaBUJBnzjf"
url = f"https://api.spacescan.io/offer/{offer_id}"
headers = {
    "version": "v1",
    "network": "xch"
}

response = requests.get(url, headers=headers)
data = response.json()
print(data)

JavaScript

const offerId = "HtLDNrF32NzjDSmbub4SYDsHDNBjucVvQvdaBUJBnzjf";
const url = `https://api.spacescan.io/offer/${offerId}`;

fetch(url, {
  headers: {
    "version": "v1",
    "network": "xch"
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Response Schema

Field	Type	Description
status	string	Status of the request ("success" or "failed")
data	object	Offer information
data.id	string	The unique identifier of the offer
data.offer_status	string	Current status of the offer (Active, Pending, Cancelling, Cancelled, Completed, Unknown, Expired)
data.offer	string	Raw offer data
data.offered	array	Array of assets being offered
data.requested	array	Array of assets being requested
data.created	string	Timestamp of offer creation
data.settled	string	Timestamp when offer was settled
data.height	number	Block height of the offer

Asset Object Schema (for offered and requested arrays)

Field	Type	Description
type	string	Asset type (NFT1, CAT2, XCH)
nft_info	object	NFT information (present if type is NFT1)
cat_info	object	CAT information (present if type is CAT1 or CAT2)
symbol	string	Asset symbol
amount	number	Asset amount

Example Response

{
  "status": "success",
  "data": {
    "id": "offer1abc...",
    "offer_status": "Active",
    "offer": "raw_offer_data",
    "offered": [
      {
        "type": "NFT1",
        "nft_info": {
          "id": "nft1...",
          "name": "Sample NFT",
          "preview_url": "https://..."
        }
      },
      {
        "type": "CAT2",
        "cat_info": {
          "asset_id": "cat1...",
          "name": "Sample CAT"
        },
        "symbol": "CAT",
        "amount": 100
      }
    ],
    "requested": [
      {
        "type": "XCH",
        "symbol": "XCH",
        "amount": 1.5
      }
    ],
    "created": "2023-01-01T00:00:00Z",
    "settled": null,
    "height": 1234567
  }
}

Error Responses

HTTP Status Code	Meaning
401	Unauthorized -- Missing required headers
404	Not Found -- The specified offer could not be found
429	Too Many Requests -- You're requesting too many times
500	Internal Server Error -- We had a problem with our server
503	Service Unavailable -- We're temporarily offline for maintenance