Get a collection
Collection info and its NFTs, paginated.
Two endpoints: one for the collection itself, one to list what's in it.
Get collection info
GET /collections/{address}| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
address | path | string | Yes | The collection's address (the collection NFT's mint). |
curl https://api.sarg.am/v1/solana/collections/J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w \
-H "Authorization: Bearer $MAINLY_API_KEY"{
"address": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
"name": "Mad Lads",
"symbol": "MAD",
"description": "Fock it.",
"image": "https://cdn.mainly.dev/assets/J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w.png",
"itemCount": 9967,
"floorPrice": {
"lamports": 42500000000,
"sol": 42.5,
"updatedAt": "2026-08-04T09:30:00Z"
}
}| Field | Type | Description |
|---|---|---|
itemCount | number | Number of verified items in the collection. |
floorPrice | object | null | Lowest current listing across tracked marketplaces. null when no market data is available — treat as display-only, like all prices. |
List a collection's NFTs
GET /collections/{address}/nfts| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
address | path | string | Yes | The collection's address. |
limit | query | number | No | 1–1000, default 100. |
cursor | query | string | No | Pagination cursor. |
curl "https://api.sarg.am/v1/solana/collections/J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w/nfts?limit=1" \
-H "Authorization: Bearer $MAINLY_API_KEY"{
"address": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
"items": [
{
"id": "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk",
"name": "Mad Lads #8420",
"image": "https://cdn.mainly.dev/assets/F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk.png",
"standard": "programmable",
"compressed": false,
"owner": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
}
],
"nextCursor": "eyJwYWdlIjoyfQ"
}Items have the same shape as wallet NFTs, plus the
current owner. Only cryptographically verified members are included —
spoofed "members" of a collection never appear here.
Errors
code | When |
|---|---|
invalid_address | The path parameter isn't valid base58. |
not_found | The address isn't a collection. |
Under the hood
Replaces DAS getAssetsByGroup with collection grouping, verified-membership
filtering, and marketplace floor-price aggregation.