API & Integrations

Bring your NFT collection, creator discoveries and merch into a connected dashboard.

Connect your account

1. Sign in to your Splot account and open key management. Regular accounts can manage their own key.
2. Generate a personal read-only key and copy it when shown. If a key is already active, use your saved copy or coordinate replacement before revoking it.
3. Connect the key to your trusted dashboard. Send it in the Authorization: Bearer YOUR_KEY header from your server.

Keep keys encrypted on the server. Do not place them in URLs, public pages, browser code, source control or shared documents. Revoke a key on the source site to stop future API reads; data already cached by a dashboard may remain until its private cache expires.

Available calls

Append a route below to this base URL:

Expand a call to see its parameters, request and response. Examples use fictional data and may omit fields; they are not your account data or a live quote.

curl --request GET \
  --url 'https://splot.io/wp-json/splot/v1/me' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_KEY'

{
  "id": 42,
  "username": "example_user",
  "display_name": "Example User"
}

curl --request GET \
  --url 'https://splot.io/wp-json/splot/v1/me/nfts?page=1&per_page=6' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_KEY'

{
  "items": [
    {
      "title": "Example artwork",
      "permalink": "https://splot.io/example-artwork/",
      "image": null
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 6,
    "total": 1,
    "total_pages": 1
  }
}

curl --request GET \
  --url 'https://splot.io/wp-json/splot/v1/me/merch?page=1&per_page=6' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_KEY'

{
  "items": [
    {
      "name": "Example shirt",
      "permalink": "https://splot.io/example-shirt/",
      "image": null,
      "price_min": "20.00",
      "currency": "USD",
      "in_stock": true
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 6,
    "total": 1,
    "total_pages": 1
  }
}

curl --request GET \
  --url 'https://splot.io/wp-json/splot/v1/nft-details?slug=loteria-tabla-069-nft-134633' \
  --header 'Accept: application/json'

{
  "title": "Example artwork",
  "image": null,
  "owner": {
    "id": 42,
    "name": "Example User",
    "handle": "example_user",
    "url": "https://splot.io/profile/example_user"
  },
  "minter": {
    "id": 43,
    "name": "Example Artist",
    "handle": "example_artist",
    "url": "https://splot.io/profile/example_artist"
  },
  "history": [],
  "network": "Millix · DAG",
  "mint_timestamp": null,
  "mint_transaction_id": null
}

curl --request GET \
  --url 'https://splot.io/wp-json/splot/v1/artist-card/134633' \
  --header 'Accept: application/json'

{
  "name": "Example Artist",
  "handle": "example_artist",
  "bio": "Example artist biography",
  "avatar": null,
  "profile": "https://splot.io/profile/example_artist/",
  "gallery": "https://splot.io/profile/example_artist/#main",
  "collections": "",
  "store": "https://splot.io/stores/example_artist?tab=merch",
  "minted": 12,
  "available": 3,
  "works": [
    {
      "title": "Example work",
      "url": "https://splot.io/example-work/",
      "image": null
    }
  ]
}

Parameters and limits

Owned NFT and merch lists support page and per_page (1–100). NFT lists also accept creator, the original creator’s handle. Public artist cards use an NFT post ID, not a user ID. No shared rate-limit contract is published for these existing routes; cache sensibly and handle HTTP 429.

Amounts such as MLX and USD cents may be decimal strings. Preserve their precision instead of converting large values to floating-point numbers. Use the returned pagination totals. Times shown in examples are ISO 8601 UTC; display dates in the user’s timezone.

What the data means

Owned NFTs are current recorded ownership, not works originally minted by you. Merch means published products authored by your account, not purchase history. Prices are listing information, not an appraisal. Historical provenance may have missing dates.

Response handling

Use the HTTP status for error handling. Error bodies vary by route. Keep cached personal data private and short-lived; handle missing values and empty lists.

Optional PHP client

The API works with any language that can make HTTPS requests. A WordPress PHP reference client and README are also available as a convenience.