2026-07-29

Fixed — Best-listing availability

Fixed cases where Token.bestListing returned null for tokens with an active applicable listing.

Improved — Currency display fields

When Raster cannot identify a currency's display details, CurrencyAmount returns null for symbol and, when precision is unknown, decimals, rather than placeholder values. The raw currency value and known decimals remain available.

Fixed — Usable media URLs

For embedded media, Artwork.media.contentUrl and Token.media.contentUrl now return Raster's hosted original URL instead of an internal reference clients could not load directly.

2026-07-28

Added — Token market data and sale history

Added Token.bestListing, which returns Raster's active applicable listing when one is available, and Token.sales, which returns completed sales newest first. Listing, CurrencyAmount, Sale, and BlockchainTransaction provide price, marketplace, participant, and transaction data when recorded.

query TokenMarketData($id: ID!) {
  token(id: $id) {
    bestListing {
      unitPrice { amount currency decimals symbol }
      marketplaceId
      validTo
    }
    sales(first: 5) {
      nodes {
        kind
        unitPrice { amount currency }
        transaction { hash timestamp }
      }
    }
  }
}

Added — Token standards

Added Token.tokenStandard, which identifies a token's primary transfer standard when Raster can classify it. The TokenStandard enum covers ERC-721, ERC-1155, FA2, Ordinals inscriptions, and CryptoPunks.

Fixed — Chain-slug token references

tokenByRef accepts registered chain slugs in ref.chainId; its response still uses the canonical CAIP chain ID.

query TokenByRef($ref: TokenRefInput!) {
  tokenByRef(ref: $ref) {
    id
    chainId
    tokenId
  }
}

{
  "ref": {
    "chainId": "ethereum",
    "contractAddress": "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270",
    "tokenId": "108000144"
  }
}

2026-06-20

Added — Full connection counts

Added non-null totalCount to ArtworkConnection, TokenConnection, and TokenOwnershipConnection. It covers the full connection, independent of pagination cursors.

2026-06-18

Added — Artwork platforms

Added Artwork.platform, which provides the release platform's ID and name when Raster knows it.

2026-06-06

Added — Artists for an address

Added Address.artists, which returns the credited artist or artists associated with a minting address. Shared-address collaboration and alias records resolve to public artist identities.

GraphQL API access is issued by API key. Contact Raster for a key before using the API in production.

Send the key on every request in the x-api-key HTTP header:

POST /graphql HTTP/1.1
Host: api.raster.art
Content-Type: application/json
x-api-key: <your-api-key>

Example with curl:

curl https://api.raster.art/graphql \
  -H 'content-type: application/json' \
  -H 'x-api-key: <your-api-key>' \
  --data '{"query":"{ __typename }"}'

Keep the key private. Do not include it in query strings, client-side code, or public repositories.

The API returns media as a Media object (Artwork.media, Token.media) that gives you a previewHash and a previewType — not ready-to-use URLs. This guide explains how to turn those into image/video URLs.

Preview URLs

Preview renditions are served from a CDN, addressed by previewHash:

https://bits.raster.art/{previewHash[:4]}/{previewHash}/{file}

{previewHash[:4]} is the first four characters of the hash (a sharding prefix). {file} is one of:

{file}	What it is
{size}.avif	A still image at {size} px (longest edge)
{size}-anim.avif	An animated AVIF at {size} px
original	The unprocessed original (used for SVG)

Example. A token whose previewHash is f1882baccbad286c0711ed8169778f6068fc853bb126b543561f2be7fdf9357d and previewType is image/2, at 700 px:

https://bits.raster.art/f188/f1882baccbad286c0711ed8169778f6068fc853bb126b543561f2be7fdf9357d/700.avif

Which renditions exist (previewType)

previewType is a handler/version key (it is not a MIME type). It tells you which files were generated, so you can build a valid URL without probing:

previewType	Still sizes ({size}.avif)	Animated ({size}-anim.avif)	Original
image/1	300, 700, 1500	—	—
image/2	350, 700, 1200, 1800, 2400, 3600, 7200	—	—
image-pixelart/1	350, 700, 1200, 1800, 2400, 3600, 7200	—	—
svg/1	—	—	✓ (original, the SVG)
gif/2	—	300, 700, 1500	—
gif/3	300, 700, 1500	300, 700, 1500	—
video/1	300, 700, 1500 (poster frame)	300, 700, 1500	—
video/3	300, 700, 1500 (poster frame)	300, 700, 1500	—

Pick the smallest size that covers your display. All renditions are AVIF except svg/1, whose original is the SVG itself. Older items may carry an earlier type version (e.g. gif/1); the URL scheme is identical — request the still or animated size you need.

The other Media fields

Field	Meaning
previewHash	Content hash; the input to the preview URLs above.
previewType	Rendition type key (the table above). Not a MIME type.
contentType	Kind of the original media — image, video, gif, svg, webapp, … Not a MIME type.
contentUrl	Browser-loadable URL of the original source file when available — frequently null. For embedded media, Raster returns its hosted original URL. For display, prefer the preview renditions above.
contentSize	Size in bytes.
dimensions	Intrinsic pixel width/height, when known.