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

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