Doma Multi-Chain Subgraph
Doma Subgraph could be used to get consolidated data about names tokenized on Doma Protocol. This data includes information about names, name tokens, and associated activities. Also, it includes aggregated marketplaces offers and listing information.
Endpoints:
Testnet: https://api-testnet.doma.xyz/graphql
Mainnet: Coming soon...
Queries
names
names
Get paginated list of tokenized names, with optional filters and sorting.
skip
Int
Number of records to skip for pagination.
take
Int
Number of records to return per page (max 100).
ownedBy
[AddressCAIP10!]
Filter by owner addresses (CAIP-10 format).
name
String
Filter by name (domain).
networkIds
[String!]
Filter by network IDs (CAIP-2 format).
registrarIanaIds
[Int!]
Filter by registrar IANA IDs.
tlds
[String!]
Filter by TLDs.
Returns: PaginatedNamesResponse!
name
name
Get information about a specific tokenized name.
name
String!
Name to fetch information.
Returns: NameModel!
tokens
tokens
Get paginated list of tokens, with optional filters and sorting.
skip
Int
Number of records to skip for pagination.
take
Int
Number of records to return per page (max 100).
name
String!
Name (domain) to query tokens for.
Returns: PaginatedTokensResponse!
token
token
Get information about a specific token by its ID.
tokenId
String!
Token id to fetch information.
Returns: TokenModel!
command
command
Get information about a specific command by its correlation ID. Useful to track status of client-initiated operations (e.g. bridging a name).
correlationId
String!
Command correlation (relay) id to fetch information.
Returns: CommandModel!
nameActivities
nameActivities
Get paginated list of activities related to a specific name.
name
String!
Name (domain) to query activities for.
skip
Float
Number of records to skip for pagination.
take
Float
Number of records to return per page (max 100).
Returns: PaginatedNameActivitiesResponse!
tokenActivities
tokenActivities
Get paginated list of activities related to a specific token.
tokenId
String!
Token ID to query activities for.
skip
Float
Number of records to skip for pagination.
take
Float
Number of records to return per page (max 100).
Returns: PaginatedTokenActivitiesResponse!
listings
listings
Get paginated list of "Buy Now" secondary sale listings for tokenized names, with optional filters.
skip
Float
Number of records to skip for pagination.
take
Float
Number of records to return per page (max 100).
tlds
[String!]
Filter by TLDs.
createdSince
DateTime
Filter listings created since this date.
sld
String
Second-level domain (SLD) name.
networkIds
[String!]
Filter by network IDs (CAIP-2 format).
registrarIanaIds
[Int!]
Filter by registrar IANA IDs.
Returns: PaginatedNameListingsResponse!
offers
offers
Get paginated list of offers for tokenized names, with optional filters.
tokenId
String
Token ID to query offers for.
offeredBy
[AddressCAIP10!]
Filter by offerer addresses (CAIP-10 format).
skip
Float
Number of records to skip for pagination.
take
Float
Number of records to return per page (max 100).
Returns: PaginatedNameOffersResponse!
nameStatistics
nameStatistics
Get statistics for a specific tokenized name.
tokenId
String!
Name Ownership Token ID that identifies a name to retrieve statistics from.
Returns: NameStatisticsModel!
Mutations
generateMetadata
generateMetadata
Generate metadata for a list of tokens based on their attributes. Useful to pre-create metadata before generating synthetic tokens.
Returns: [String!]!
initiateEmailVerification
initiateEmailVerification
Initiate email verification process for a given email address. Used to verify contact information before claiming a tokenized name.
email
String!
Email address to initiate email verification.
Returns: Boolean!
completeEmailVerification
completeEmailVerification
Complete email verification process by providing the verification code sent to the email address. Returns a proof of email verification that can be used to upload registrant contacts.
code
String!
Email verification code.
email
String!
Email that was used to initiate verification.
Returns: String!
uploadRegistrantContacts
uploadRegistrantContacts
Upload registrant contact information along with proof of email verification. This is used to claim a tokenized name and associate it with the provided contact details.
emailVerificationProof
String!
Proof of email verification, obtained after completing the email verification process.
networkId
String!
Network ID (CAIP-2 format) where the name is being claimed.
registrarIanaId
Int!
IANA ID of the registrar where the name is being claimed.
Returns: ProofOfContactsVoucherResponseModel!
uploadVerifiedRegistrantContacts
uploadVerifiedRegistrantContacts
Upload verified registrant contact information without email verification proof. This is used to claim a tokenized name with pre-verified email. Requires additional VERIFIED_CONTACTS_UPLOAD permission to use.
contact
Registrant contact information, including name, email, address, and phone.
networkId
String!
Network ID (CAIP-2 format) where the name is being claimed.
registrarIanaId
Int!
IANA ID of the registrar where the name is being claimed.
Returns: ProofOfContactsVoucherResponseModel!
Models
ChainModel
ChainModel
Blockchain network information.
name
String!
Name of the blockchain network.
networkId
String!
Network ID in CAIP-2 format.
PaymentInfoModel
PaymentInfoModel
Payment information for token transactions.
price
BigInt!
Price of the token in the specified currency.
tokenAddress
String!
Contract address of the payment token.
currencySymbol
String!
Symbol of the currency used for payment.
RegistrarModel
RegistrarModel
name
String!
Registrar name.
ianaId
ID!
IANA ID of the registrar.
publicKeys
[String!]!
Registrar public keys.
websiteUrl
String
Registrar website URL.
supportEmail
String
Registrar support email address.
CommandModel
CommandModel
Command information for tracking client-initiated operations.
serverCommandId
String!
Server command ID.
clientCommandId
String!
Client command ID.
createdAt
DateTime!
Date and time when the command was created.
updatedAt
DateTime!
Date and time when the command was last updated.
NameServerModel
NameServerModel
Nameserver information.
ldhName
String!
LDH (Letter-Digit-Hyphen) name of the nameserver.
CurrencyModel
CurrencyModel
Currency information.
name
String!
Currency name.
symbol
String!
Currency symbol.
decimals
Int!
Number of decimals for the currency.
ListingModel
ListingModel
Secondary sale listing for a tokenized name.
id
ID!
Listing ID.
externalId
String!
External order ID.
price
BigInt!
Listing price.
offererAddress
AddressCAIP10!
Offerer address in CAIP-10 format.
expiresAt
DateTime!
Expiration date of the listing.
createdAt
DateTime!
Date and time when the listing was created.
updatedAt
DateTime!
Date and time when the listing was last updated.
OfferModel
OfferModel
Offer for a tokenized name.
id
ID!
Offer ID.
externalId
String!
External offer ID.
price
BigInt!
Offer price.
offererAddress
AddressCAIP10!
Offerer address in CAIP-10 format.
expiresAt
DateTime!
Expiration date of the offer.
createdAt
DateTime!
Date and time when the offer was created.
TokenModel
TokenModel
Tokenized name ownership information.
tokenId
ID!
Token ID.
networkId
String!
Network ID in CAIP-2 format.
ownerAddress
AddressCAIP10!
Owner address in CAIP-10 format.
startsAt
DateTime
Start date of the token validity.
expiresAt
DateTime!
Expiration date of the token.
explorerUrl
String!
Explorer URL for the token.
tokenAddress
String!
Token contract address.
createdAt
DateTime!
Date and time when the token was created.
openseaCollectionSlug
String
OpenSea collection slug for the token contract.
TokenMintedActivity
TokenMintedActivity
Activity representing a token mint.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
TokenTransferredActivity
TokenTransferredActivity
Activity representing a token transfer.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
transferredTo
String!
Address the token was transferred to.
transferredFrom
String!
Address the token was transferred from.
TokenListedActivity
TokenListedActivity
Activity representing a token listing in the marketplace.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
orderId
String!
Unique identifier for the marketplace order.
startsAt
DateTime
Date and time when the listing becomes active.
expiresAt
DateTime!
Date and time when the listing expires.
seller
String!
Address of the token seller.
buyer
String
Address of the token buyer, if applicable.
TokenOfferReceivedActivity
TokenOfferReceivedActivity
Activity representing an offer received for a token.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
orderId
String!
Unique identifier for the marketplace order.
expiresAt
DateTime!
Date and time when the offer expires.
buyer
String!
Address of the potential buyer making the offer.
seller
String!
Address of the token seller receiving the offer.
TokenListingCancelledActivity
TokenListingCancelledActivity
Activity representing a cancelled token listing.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
orderId
String!
Unique identifier for the cancelled marketplace order.
reason
String
Reason for cancelling the listing, if provided.
TokenOfferCancelledActivity
TokenOfferCancelledActivity
Activity representing a cancelled offer for a token.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
orderId
String!
Unique identifier for the cancelled marketplace order.
reason
String
Reason for cancelling the offer, if provided.
TokenPurchasedActivity
TokenPurchasedActivity
Activity representing a token purchase in the marketplace.
networkId
String!
Network ID in CAIP-2 format.
txHash
String
Transaction hash associated with the activity.
finalized
Boolean!
Whether the activity is finalized on-chain.
tokenId
String!
Token ID.
createdAt
DateTime!
Date and time when the activity was created.
orderId
String!
Unique identifier for the marketplace order.
purchasedAt
DateTime!
Date and time when the token was purchased.
seller
String!
Address of the token seller.
buyer
String!
Address of the token buyer.
DSKeyModel
DSKeyModel
DNSSEC DS Key information.
keyTag
Int!
DS Key Tag.
algorithm
Int!
DS Key Algorithm.
digest
String!
DS Key Digest.
digestType
Int!
DS Key Digest Type.
NameModel
NameModel
Tokenized name information.
name
ID!
Name (domain).
expiresAt
DateTime!
Expiration date of the name.
tokenizedAt
DateTime!
Date and time when the name was tokenized.
eoi
Boolean!
Whether the name is an expression of interest (EOI).
transferLock
Boolean
Whether transfer lock is enabled for the name ownership token.
claimedBy
AddressCAIP10
Wallet address that claimed the name.
NameClaimedActivity
NameClaimedActivity
Activity representing a name claim.
txHash
String
Transaction hash associated with the activity.
sld
String!
Second-level domain (SLD) name.
tld
String!
Top-level domain (TLD) name.
createdAt
DateTime!
Date and time when the activity was created.
claimedBy
String!
Wallet address that claimed the name.
NameRenewedActivity
NameRenewedActivity
Activity representing a name renewal.
txHash
String
Transaction hash associated with the activity.
sld
String!
Second-level domain (SLD) name.
tld
String!
Top-level domain (TLD) name.
createdAt
DateTime!
Date and time when the activity was created.
expiresAt
DateTime!
Expiration date of the renewed name.
NameDetokenizedActivity
NameDetokenizedActivity
Activity representing a name detokenization.
txHash
String
Transaction hash associated with the activity.
sld
String!
Second-level domain (SLD) name.
tld
String!
Top-level domain (TLD) name.
createdAt
DateTime!
Date and time when the activity was created.
networkId
String!
Network ID in CAIP-2 format.
NameTokenizedActivity
NameTokenizedActivity
Activity representing a name tokenization.
txHash
String
Transaction hash associated with the activity.
sld
String!
Second-level domain (SLD) name.
tld
String!
Top-level domain (TLD) name.
createdAt
DateTime!
Date and time when the activity was created.
networkId
String!
Network ID in CAIP-2 format.
NameListingModel
NameListingModel
Secondary sale listing for a tokenized name, including name and registrar info.
id
ID!
Listing ID.
externalId
String!
External order ID.
price
BigInt!
Listing price.
offererAddress
AddressCAIP10!
Offerer address in CAIP-10 format.
expiresAt
DateTime!
Expiration date of the listing.
createdAt
DateTime!
Date and time when the listing was created.
updatedAt
DateTime!
Date and time when the listing was last updated.
name
String!
Name (domain) associated with the listing.
nameExpiresAt
DateTime!
Expiration date of the name.
tokenId
String!
Token ID associated with the listing.
tokenAddress
String!
Token contract address.
NameOfferModel
NameOfferModel
Offer for a tokenized name, including name and registrar info.
id
ID!
Offer ID.
externalId
String!
External offer ID.
price
BigInt!
Offer price.
offererAddress
AddressCAIP10!
Offerer address in CAIP-10 format.
expiresAt
DateTime!
Expiration date of the offer.
createdAt
DateTime!
Date and time when the offer was created.
name
String!
Name (domain) associated with the offer.
nameExpiresAt
DateTime!
Expiration date of the name.
tokenId
String!
Token ID associated with the offer.
tokenAddress
String!
Token contract address.
NameStatisticsModel
NameStatisticsModel
Statistics for a specific tokenized name.
name
String!
Name (domain).
activeOffers
Int!
Number of active offers for the name.
offersLast3Days
Int!
Number of offers received in the last 3 days.
ProofOfContactsVoucherModel
ProofOfContactsVoucherModel
Proof of contacts voucher for registrant contact verification.
registrantHandle
String!
Registrant handle.
nonce
String!
Nonce for the voucher.
publicKey
String!
Registrar Public key that was used for contact information encryption.
proofSource
Int!
Proof source type.
expiresAt
Float!
Expiration timestamp for the voucher.
ProofOfContactsVoucherResponseModel
ProofOfContactsVoucherResponseModel
Response containing proof of contacts voucher and its signature.
signature
String!
Signature for the voucher.
PaginatedNamesResponse
PaginatedNamesResponse
Paginated response for querying tokenized names. Contains a list of NameModel items and pagination metadata.
totalCount
Int!
Total number of items matching the query.
pageSize
Int!
Number of items per page.
currentPage
Int!
Current page number (1-based).
totalPages
Int!
Total number of pages available.
hasPreviousPage
Boolean!
Indicates if there is a previous page.
hasNextPage
Boolean!
Indicates if there is a next page.
PaginatedTokensResponse
PaginatedTokensResponse
Paginated response for querying tokenized name ownership tokens. Contains a list of TokenModel items and pagination metadata.
totalCount
Int!
Total number of items matching the query.
pageSize
Int!
Number of items per page.
currentPage
Int!
Current page number (1-based).
totalPages
Int!
Total number of pages available.
hasPreviousPage
Boolean!
Indicates if there is a previous page.
hasNextPage
Boolean!
Indicates if there is a next page.
PaginatedTokenActivitiesResponse
PaginatedTokenActivitiesResponse
Paginated response for querying token activities. Contains a list of TokenActivity items and pagination metadata.
totalCount
Int!
Total number of items matching the query.
pageSize
Int!
Number of items per page.
currentPage
Int!
Current page number (1-based).
totalPages
Int!
Total number of pages available.
hasPreviousPage
Boolean!
Indicates if there is a previous page.
hasNextPage
Boolean!
Indicates if there is a next page.
PaginatedNameActivitiesResponse
PaginatedNameActivitiesResponse
Paginated response for querying name activities. Contains a list of NameActivity items and pagination metadata.
totalCount
Int!
Total number of items matching the query.
pageSize
Int!
Number of items per page.
currentPage
Int!
Current page number (1-based).
totalPages
Int!
Total number of pages available.
hasPreviousPage
Boolean!
Indicates if there is a previous page.
hasNextPage
Boolean!
Indicates if there is a next page.
PaginatedNameOffersResponse
PaginatedNameOffersResponse
Paginated response for querying offers for tokenized names. Contains a list of NameOfferModel items and pagination metadata.
totalCount
Int!
Total number of items matching the query.
pageSize
Int!
Number of items per page.
currentPage
Int!
Current page number (1-based).
totalPages
Int!
Total number of pages available.
hasPreviousPage
Boolean!
Indicates if there is a previous page.
hasNextPage
Boolean!
Indicates if there is a next page.
PaginatedNameListingsResponse
PaginatedNameListingsResponse
Paginated response for querying listings for tokenized names. Contains a list of NameListingModel items and pagination metadata.
totalCount
Int!
Total number of items matching the query.
pageSize
Int!
Number of items per page.
currentPage
Int!
Current page number (1-based).
totalPages
Int!
Total number of pages available.
hasPreviousPage
Boolean!
Indicates if there is a previous page.
hasNextPage
Boolean!
Indicates if there is a next page.
Unions
TokenActivity
TokenActivity
Possible types: TokenMintedActivity
, TokenTransferredActivity
, TokenListedActivity
, TokenOfferReceivedActivity
, TokenListingCancelledActivity
, TokenOfferCancelledActivity
, TokenPurchasedActivity
NameActivity
NameActivity
Union type for different name activities.
Possible types: NameClaimedActivity
, NameRenewedActivity
, NameDetokenizedActivity
, NameTokenizedActivity
Input Types
TokenMetadataGenerationRequestInput
TokenMetadataGenerationRequestInput
Input for generating token metadata, including name, network, type, and validity period.
name
String!
Name (domain) for which to generate metadata.
networkId
String!
Network ID in CAIP-2 format.
startsAt
DateTime
Optional start date for the token validity period.
expiresAt
DateTime!
Expiration date for the token.
RegistrantContactInput
RegistrantContactInput
Registrant contact information for domain registration.
name
String!
Full name of the registrant.
organization
String
Organization name of the registrant (optional).
email
String!
Email address of the registrant.
phone
String!
Phone number of the registrant.
fax
String
Fax number of the registrant (optional).
street
String!
Street address of the registrant.
city
String!
City of the registrant.
state
String!
State or province of the registrant.
postalCode
String!
Postal code of the registrant.
countryCode
String!
Country code of the registrant (ISO 3166-1 alpha-2).
Enums
CommandType
CommandType
Command Type
TOKENIZE
Tokenize a domain name.
EOI_CLAIM
(Deprecated) Transfer EOI name from an escrow.
APPROVE_TOKENIZATION
Approve a tokenization request.
REJECT_TOKENIZATION
Reject a tokenization request.
APPROVE_CLAIM_REQUEST
Approve a claim request for a domain.
REJECT_CLAIM_REQUEST
Reject a claim request for a domain.
RENEW
Renew a domain name.
UPDATE
Update domain (both nameservers and DNSSEC DS keys).
UPDATE_NAMESERVERS
Update nameservers for a domain.
UPDATE_DS_KEYS
Update DNSSEC DS keys for a domain.
DETOKENIZE
Detokenize a domain name. Checks if current owner has claimed a domain.
DELETE
Delete a domain or token (only for expired domains).
COMPLIANCE_LOCK_STATUS_CHANGE
Change compliance lock status for an ownership token.
COMPLIANCE_DETOKENIZE
Detokenize a domain due to compliance reasons.
UPDATE_METADATA
Update metadata for a token.
SET_REVERSE_MAPPING
Set reverse mapping for an address.
VOUCHER_PAYMENT
Process a voucher payment.
REQUEST_TOKENIZATION
User-initiated request to tokenize a domain.
TRANSFER_HOOK
Transfer hook event.
REQUEST_CLAIM
User-initiated request to claim a domain.
REQUEST_DETOKENIZATION
User-initiated request to detokenize a domain.
REQUEST_BRIDGE
User-initiated request to bridge a token.
UNKNOWN
Unknown or unsupported command type.
CommandStatus
CommandStatus
Command Status
PENDING
Command is pending.
FINALIZING
Command is finalizing
SUCCEEDED
Command has been cancelled.
FAILED
Command has failed.
PARTIALLY_SUCCEEDED
Command partially succeeded. Used for bulk commands.
CommandSource
CommandSource
Command Source
RELAY
Command initiated by the registrar (using Relay API).
USER
Command initiated by the user (e.g. Bridge or Claim).
CommandFailureReason
CommandFailureReason
Command Failure Reason
INTERNAL_ERROR
Internal error occurred during command execution. Please contact support.
TRANSACTION_FAILED
Transaction failed during command execution.
OrderbookType
OrderbookType
Orderbook Type
DOMA
Doma orderbook (primary).
OPENSEA
OpenSea orderbook.
TokenType
TokenType
Token Type
OWNERSHIP
Ownership token.
SYNTHETIC
Synthetic token. Not supported yet.
TokenActivityType
TokenActivityType
Token Activity Type
MINTED
Token was minted.
TRANSFERRED
Token was transferred.
LISTED
Token was listed for sale in the marketplace
OFFER_RECEIVED
An offer was received for the token
LISTING_CANCELLED
A listing for the token was cancelled
OFFER_CANCELLED
An offer for the token was cancelled
PURCHASED
Token was purchased in the marketplace
NameActivityType
NameActivityType
Name Activity Type
TOKENIZED
Name was tokenized.
CLAIMED
Name was claimed by a wallet address.
RENEWED
Name was renewed.
DETOKENIZED
Name was detokenized.
NamesQueryClaimStatus
NamesQueryClaimStatus
Names Claim Status
CLAIMED
Name has been claimed.
UNCLAIMED
Name has not been claimed.
ALL
All names, regardless of claim status.
SortOrderType
SortOrderType
Sort Order Type
DESC
Descending order.
ASC
Ascending order.
OfferStatus
OfferStatus
Offer Status Filter
ACTIVE
Offer is currently active.
EXPIRED
Offer has expired.
All
All offers, regardless of status.
Last updated