Masterworks

Masterworks GraphQL API

The single GraphQL endpoint behind the Masterworks web and mobile apps, covering art offerings, artists, auction and repeat-sale data, contributions, agreements and e-signature, KYC and accreditation, payments and payouts, the secondary-market exchange, art events, activity feeds, referrals and internal notification tooling. It is an undocumented first-party backend, not a published developer API: anonymous schema introspection is enabled, but every data field is guarded by an @authenticate directive and returns HTTP 200 with an errors[].extensions.code of invalidAuthentication (status 401) when called without a token.

GitHub

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/authentication/masterworks-authentication.yml

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/graphql/masterworks-graphql.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/errors/masterworks-error-codes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/conventions/masterworks-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/data-model/masterworks-data-model.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/lifecycle/masterworks-lifecycle.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/masterworks/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/masterworks-graphql-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

API entry from apis.yml

apis.yml Raw ↑ 
name: Masterworks GraphQL API
description: 'The single GraphQL endpoint behind the Masterworks web and mobile apps, covering art offerings,
  artists, auction and repeat-sale data, contributions, agreements and e-signature, KYC and accreditation,
  payments and payouts, the secondary-market exchange, art events, activity feeds, referrals and internal
  notification tooling. It is an undocumented first-party backend, not a published developer API: anonymous
  schema introspection is enabled, but every data field is guarded by an @authenticate directive and returns
  HTTP 200 with an errors[].extensions.code of invalidAuthentication (status 401) when called without
  a token.'
humanURL: https://www.masterworks.com/
baseURL: https://api.masterworks.com/graphql
tags:
- Art Investing
- Alternative Investments
- GraphQL
- Securities
- Fintech
properties:
- type: GraphQL
  url: graphql/masterworks-graphql.yml
- type: Authentication
  url: authentication/masterworks-authentication.yml
- type: ErrorCatalog
  url: errors/masterworks-error-codes.yml
- type: Conventions
  url: conventions/masterworks-conventions.yml
- type: DataModel
  url: data-model/masterworks-data-model.yml
- type: Lifecycle
  url: lifecycle/masterworks-lifecycle.yml