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
namesGet 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
nameGet information about a specific tokenized name.
name
String!
Name to fetch information.
Returns: NameModel!
tokens
tokensGet 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
tokenGet information about a specific token by its ID.
tokenId
String!
Token id to fetch information.
Returns: TokenModel!
command
commandGet 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
nameActivitiesGet 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
tokenActivitiesGet 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
listingsGet 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
offersGet 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
nameStatisticsGet statistics for a specific tokenized name.
tokenId
String!
Name Ownership Token ID that identifies a name to retrieve statistics from.
Returns: NameStatisticsModel!
Mutations
generateMetadata
generateMetadataGenerate metadata for a list of tokens based on their attributes. Useful to pre-create metadata before generating synthetic tokens.
Returns: [String!]!
initiateEmailVerification
initiateEmailVerificationInitiate 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
completeEmailVerificationComplete 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
uploadRegistrantContactsUpload 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
uploadVerifiedRegistrantContactsUpload 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
ChainModelBlockchain network information.
name
String!
Name of the blockchain network.
networkId
String!
Network ID in CAIP-2 format.
PaymentInfoModel
PaymentInfoModelPayment 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
RegistrarModelname
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
CommandModelCommand 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
NameServerModelNameserver information.
ldhName
String!
LDH (Letter-Digit-Hyphen) name of the nameserver.
CurrencyModel
CurrencyModelCurrency information.
name
String!
Currency name.
symbol
String!
Currency symbol.
decimals
Int!
Number of decimals for the currency.
ListingModel
ListingModelSecondary 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
OfferModelOffer 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
TokenModelTokenized 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
TokenMintedActivityActivity 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
TokenTransferredActivityActivity 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
TokenListedActivityActivity 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
TokenOfferReceivedActivityActivity 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
TokenListingCancelledActivityActivity 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
TokenOfferCancelledActivityActivity 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
TokenPurchasedActivityActivity 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
DSKeyModelDNSSEC 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
NameModelTokenized 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
NameClaimedActivityActivity 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
NameRenewedActivityActivity 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
NameDetokenizedActivityActivity 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
NameTokenizedActivityActivity 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
NameListingModelSecondary 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
NameOfferModelOffer 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
NameStatisticsModelStatistics 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
ProofOfContactsVoucherModelProof 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
ProofOfContactsVoucherResponseModelResponse containing proof of contacts voucher and its signature.
signature
String!
Signature for the voucher.
PaginatedNamesResponse
PaginatedNamesResponsePaginated 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
PaginatedTokensResponsePaginated 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
PaginatedTokenActivitiesResponsePaginated 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
PaginatedNameActivitiesResponsePaginated 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
PaginatedNameOffersResponsePaginated 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
PaginatedNameListingsResponsePaginated 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
TokenActivityPossible types: TokenMintedActivity, TokenTransferredActivity, TokenListedActivity, TokenOfferReceivedActivity, TokenListingCancelledActivity, TokenOfferCancelledActivity, TokenPurchasedActivity
NameActivity
NameActivityUnion type for different name activities.
Possible types: NameClaimedActivity, NameRenewedActivity, NameDetokenizedActivity, NameTokenizedActivity
Input Types
TokenMetadataGenerationRequestInput
TokenMetadataGenerationRequestInputInput 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
RegistrantContactInputRegistrant 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
CommandTypeCommand 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
CommandStatusCommand 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
CommandSourceCommand Source
RELAY
Command initiated by the registrar (using Relay API).
USER
Command initiated by the user (e.g. Bridge or Claim).
CommandFailureReason
CommandFailureReasonCommand Failure Reason
INTERNAL_ERROR
Internal error occurred during command execution. Please contact support.
TRANSACTION_FAILED
Transaction failed during command execution.
OrderbookType
OrderbookTypeOrderbook Type
DOMA
Doma orderbook (primary).
OPENSEA
OpenSea orderbook.
TokenType
TokenTypeToken Type
OWNERSHIP
Ownership token.
SYNTHETIC
Synthetic token. Not supported yet.
TokenActivityType
TokenActivityTypeToken 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
NameActivityTypeName Activity Type
TOKENIZED
Name was tokenized.
CLAIMED
Name was claimed by a wallet address.
RENEWED
Name was renewed.
DETOKENIZED
Name was detokenized.
NamesQueryClaimStatus
NamesQueryClaimStatusNames Claim Status
CLAIMED
Name has been claimed.
UNCLAIMED
Name has not been claimed.
ALL
All names, regardless of claim status.
SortOrderType
SortOrderTypeSort Order Type
DESC
Descending order.
ASC
Ascending order.
OfferStatus
OfferStatusOffer Status Filter
ACTIVE
Offer is currently active.
EXPIRED
Offer has expired.
All
All offers, regardless of status.
Last updated