API

Claim a drop in three calls

# 1. Look up the drop behind shard.dog/lids-xv1
curl "https://sit.shard.dog/api/channels/lids-xv1"
# → { "seriesId": "1764574026444", "contract": "treats.sharddog.near", … }

# 2. Check whether bob.near already has it
curl "https://sit.shard.dog/api/nft/claim-status/check?accountId=bob.near&tokenId=1764574026444&contract=treats.sharddog.near"
# → { "claimed": false, … }

# 3. Claim it for bob.near
curl -X POST "https://sit.shard.dog/api/check-slugs/mint" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "bob.near", "seriesId": "1764574026444", "slug": "lids-xv1"}'

Drops

Every drop has a slug (shard.dog/<slug>) and a series id. Most endpoints take either.

• GET/api/channels/{slug}

  A drop’s details: title, image, owner, contract and series id.

  slug path

  Slug or series id

• GET/api/channels/list

  Every drop an account has made, including inactive ones.

  owner query

  NEAR account

• GET/api/channels/{id}/claim-count

  Claims so far, and how many are left.

  id path

  Slug or series id

• GET/api/channels/{id}/topup

  Prices for adding claims to a drop.

  id path

  Slug or series id

Claiming

Claiming is free for the claimer. ShardDog pays the gas.

• GET/api/nft/claim-status/check

  Whether an account has already claimed a drop.

  accountId query

  NEAR account

  tokenId query

  The drop’s seriesId

  contract query, optional

  The drop’s contract. Recommended.

• POST/api/check-slugs/mint

  Claim a drop for an account.

  walletAddress body

  NEAR account to receive it

  seriesId body

  The drop’s series id

  slug body, optional

  The drop’s slug. Recommended.

  inviteCode body, optional

  For invite-only drops

  Claiming twice is safe: the second call says it’s already collected and mints nothing.

Collections

What people have collected.

• GET/api/getFeed

  An account’s ShardDogs, newest first.

  wallet query

  NEAR account

• GET/api/users/{wallet}/stats

  An account’s totals and collecting streaks.

  wallet path

  NEAR account

• GET/api/getStats

  ShardDog-wide totals.

Lids and creators

Sticker lids, the people who make drops, and who follows them.

• GET/api/lid/{account}

  An account’s lid: every sticker they hold, and where each sits.

  account path

  NEAR account

• GET/api/creators/{wallet}

  A creator’s public drops and follower count.

  wallet path

  The creator’s account

  viewer query, optional

  Sets following for this account

• GET/api/follows/{account}

  Who an account follows, and those creators’ drops from the last 60 days.

  account path

  NEAR account

Images

Many older drop images are on IPFS links that no longer load directly.

• GET/api/media

  A drop image from an IPFS or Arweave link, found and cached for you.

  url query

  The image link

  Images over 4MB redirect to where they’re stored.

Making drops

Make drops on the site at shard.dog/owner/create. Each drop includes 333 free claims. Add more any time, 1,000 for 5 NEAR.