Quickstart

Check the API is reachable

The index route works without a key and lists every endpoint:

Code
curl "https://api.moca.qwellco.de/v1"

Authenticate

Send your MOCA API key on every other request — either header works:

Code
curl -H "X-API-Key: moca_YOUR_KEY" \
  "https://api.moca.qwellco.de/v1/collections"

Code
curl -H "Authorization: Bearer moca_YOUR_KEY" \
  "https://api.moca.qwellco.de/v1/collections"

Browse artworks

Page through a collection (use the slug from the previous step):

Code
curl -H "X-API-Key: moca_YOUR_KEY" \
  "https://api.moca.qwellco.de/v1/artworks?collection=genesis&page=1&limit=10"

Each artwork carries render-ready media:

Code
{
  "id": 3643,
  "name": "Tree of Origins",
  "artist_name": "…",
  "media": {
    "url": "https://ipfs.pixura.io/ipfs/Qmf…",
    "type": "image",
    "width": 1026,
    "height": 1431
  },
  "animation": null,
  "ratio": 0.717,
  "opensea_url": "https://opensea.io/assets/…"
}

Meet the DeCC0s

The Art DeCC0s knowledge base is aggregated into the same API:

Code
curl -H "X-API-Key: moca_YOUR_KEY" \
  "https://api.moca.qwellco.de/v1/decc0s/1?include=profiles"

Search everything

Code
curl -H "X-API-Key: moca_YOUR_KEY" \
  "https://api.moca.qwellco.de/v1/search?q=butterfly"