Saturn Documentation
Launch App
  • Saturn
  • Traders
    • Trading in Saturn
    • How to Swap
    • How Saturn Protects Your Trades from MEV Risks
  • Liquidity Providers
    • Open a position in a Liquidity Pool
    • Managing your Portfolio on Saturn
  • Token Creators
    • How to Create a Pool on Saturn
  • Builders
    • Saturn API
      • Pool API
        • Initialize pool
        • Add Shards
        • Open position
        • Increase Liquidity
        • Remove Liquidity
        • Swap
        • Swap Quotes
        • Boost Transaction
        • Wallet
      • Indexer API
        • Collections
        • Pools
        • Prices
        • Positions
        • Transactions
        • Charts
        • Stats
    • Liquidity Pool SDK
  • Saturn V1
    • Overview
    • How-To-Links
      • Setting up Trading Account
        • Withdrawing from Trading account
      • Swap
      • Orderbook
        • Your Profile
          • Trade History
        • How to place a sell order
        • How to place a buy order
        • Positions
      • Collect
      • Charts
      • Tutorial videos
        • Setting up a Trading Account (v3) and preparing for Rings Airdrops
        • Trading on Saturn
    • FAQs
      • What are Satoshi's, Rare SATs, and Rings?
        • More on Rare SATs
      • What is a UTXO
      • What is a PSBT
      • Why are there batch sizes?
      • Compatible Wallets
      • Why is my Available balance different than my Total balance?
Powered by GitBook
On this page
  1. Builders
  2. Saturn API
  3. Indexer API

Collections

PreviousIndexer APINextPools

Last updated 1 month ago

get

Get details for a single collection by ID

Path parameters
idstringRequired

ID of the collection

Responses
200
Collection
application/json
Responseone of
all ofOptional
or
all ofOptional
400
Bad request
get
GET /collection/id/{id} HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*
{
  "id": "1234:5678",
  "name": "text",
  "displayName": "text",
  "symbol": null,
  "divisibility": 1,
  "batchSize": 1,
  "supply": "text",
  "createdAt": "2025-06-10T20:58:51.504Z",
  "updatedAt": "2025-06-10T20:58:51.504Z",
  "type": "btc"
}
get

Get multiple collection details by IDs

Query parameters
idsstring[]Required
Responses
200
List of collections
application/json
400
Bad request
get
GET /collection/ids HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*
[
  {
    "id": "1234:5678",
    "name": "text",
    "displayName": "text",
    "symbol": null,
    "divisibility": 1,
    "batchSize": 1,
    "supply": "text",
    "createdAt": "2025-06-10T20:58:51.504Z",
    "updatedAt": "2025-06-10T20:58:51.504Z",
    "type": "btc"
  }
]
get

Get multiple collection that match the name query

Query parameters
namesstring[]Required
Responses
200
List of collections
application/json
400
Bad request
get
GET /collection/names HTTP/1.1
Host: 127.0.0.1:3000
Accept: */*
[
  {
    "id": "1234:5678",
    "name": "text",
    "displayName": "text",
    "symbol": null,
    "divisibility": 1,
    "batchSize": 1,
    "supply": "text",
    "createdAt": "2025-06-10T20:58:51.504Z",
    "updatedAt": "2025-06-10T20:58:51.504Z",
    "type": "btc"
  }
]
  • POST/collection/mintable/multi-search
  • POST/collection/multi-search
  • POST/collection/mintable/id
  • GET/collection/id/{id}
  • GET/collection/ids
  • GET/collection/names
post

Search mintable collections using filter criteria

Body

Struct used to filter mintable collections.

namestring | nullOptional
sortarray | nullOptional
limitinteger | nullOptional
offsetinteger | nullOptional
Responses
200
Paginated collections
application/json
400
Bad request
post
POST /collection/mintable/multi-search HTTP/1.1
Host: 127.0.0.1:3000
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "name": null,
  "sort": [
    {
      "field": "id",
      "order": "ASC"
    }
  ],
  "limit": null,
  "offset": null
}
{
  "response": [
    {
      "id": "1234:5678",
      "name": "text",
      "displayName": "text",
      "symbol": null,
      "divisibility": 1,
      "batchSize": 1,
      "supply": "text",
      "createdAt": "2025-06-10T20:58:51.504Z",
      "updatedAt": "2025-06-10T20:58:51.504Z",
      "type": "btc"
    },
    {
      "mint": {
        "collection_id": "1234:5678",
        "start": null,
        "end": null,
        "mintable": true,
        "mints": "text",
        "cap": "text",
        "amount": "text"
      }
    }
  ],
  "offset": 1
}
post

Get multiple collections using filter criteria

Body

Struct used to filter collections.

namestring | nullOptional
sortarray | nullOptional
limitinteger | nullOptional
offsetinteger | nullOptional
addressstring | nullOptional
Responses
200
Paginated collections
application/json
400
Bad request
post
POST /collection/multi-search HTTP/1.1
Host: 127.0.0.1:3000
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "name": null,
  "sort": [
    {
      "field": "id",
      "order": "ASC"
    }
  ],
  "limit": null,
  "offset": null,
  "address": null
}
{
  "response": [
    {
      "id": "1234:5678",
      "name": "text",
      "displayName": "text",
      "symbol": null,
      "divisibility": 1,
      "batchSize": 1,
      "supply": "text",
      "createdAt": "2025-06-10T20:58:51.504Z",
      "updatedAt": "2025-06-10T20:58:51.504Z",
      "type": "btc"
    }
  ],
  "offset": 1
}
post

Get mintable collections by ids

Body
idsstring[]Required
Responses
200
List of mintable collections
application/json
400
Bad request
post
POST /collection/mintable/id HTTP/1.1
Host: 127.0.0.1:3000
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "ids": [
    "text"
  ]
}
[
  {
    "id": "1234:5678",
    "name": "text",
    "displayName": "text",
    "symbol": null,
    "divisibility": 1,
    "batchSize": 1,
    "supply": "text",
    "createdAt": "2025-06-10T20:58:51.504Z",
    "updatedAt": "2025-06-10T20:58:51.504Z",
    "type": "btc"
  },
  {
    "mint": {
      "collection_id": "1234:5678",
      "start": null,
      "end": null,
      "mintable": true,
      "mints": "text",
      "cap": "text",
      "amount": "text"
    }
  }
]