Retrieves swap quotes for a specified token pair
Profile//
- Retrieves supported tokens for a specified chain
Retrieves swap quotes
Retrieves swap transaction plan
Retrieves a list of supported swap chains
Retrieves supported token...
Profile API (1.0.0)
The Profile API allows clients to retrieve and update domain profile details. There are both public and authenticated endpoints available for domain profiles. For authenticated endpoints, the API requires request signatures generated using the domain owner's private key.
These endpoints are available without any authentication.
- Retrieve public profile data associated with a domain
- Domain owner controls which fields are public or private
- Private data is always the default
- Retrieve NFTs for addresses associated with domain
- Domain can have any number of blockchain addresses associated for resolution services
- Resolution addresses are stored on-chain
- Query on-chain data for NFTs
- Retrieve badges data for addresses associated with domain
- Retrieve the following status of two domains
The owner of a domain may use this API to view or edit their private profile data. When managing profile data, authentication headers must be provided using the approach described below.
- Determine the message that must be signed through the message generator endpoint
- Request GET /api/user/{domain}/signature?device=true&expiry={timestamp}
- Replace '{domain}' with desired domain
- Replace '{expiry}' with desired Unix epoch timestamp
- Response contains the message that must be signed
- Message is a unique hash value
- Represents combination of provided request parameters
- Includes an expiration timestamp
- Request GET /api/user/{domain}/signature?device=true&expiry={timestamp}
- User must sign the message returned by the message generator API
- For example, the Metamask wallet could be used to sign the message
- Generated signature is used in header of subsequent GET or POST request
- Construct a request to the desired endpoint that requires user authentication
- Must include headers
- x-auth-domain - Must equal the {domain} in context
- x-auth-expiration - Must equal the {expiry} timestamp in the signed message
- x-auth-signature - Must be set to the value of the user generated signature
- Must include headers
Languages
Servers
Production
https://api.unstoppabledomains.com/profile/
Staging
https://api.ud-staging.com/profile/
Query
The source token chain. Must be one of the supported chains (Bitcoin, Ethereum, Polygon, Base or Solana)
The desired swap amount, specified in token currency. A value in fromTokenAmount is prioritized over fromTokenAmountUsd.
The desired swap amount, specified in US Dollars. A value in fromTokenAmount is prioritized over fromTokenAmountUsd.
The destination token chain. Must be one of the supported chains (Bitcoin, Ethereum, Polygon, Base or Solana)
- Productionhttps://api.unstoppabledomains.com/profile/public/{address}/swap
- Staginghttps://api.ud-staging.com/profile/public/{address}/swap
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
curl -i -X GET \
'https://api.unstoppabledomains.com/profile/public/{address}/swap?fromChain=string&fromToken=string&fromTokenAmount=string&fromTokenAmountUsd=string&toChain=string&toToken=string&toWalletAddress=string'Response
application/json
[ { "duration": 0, "gas": "string", "quote": { … }, "route": [ … ], "gasUsd": "string" } ]
Request
Retrieves a swap transaction plan containing the required transactions that must be signed by the wallet to complete the swap. The wallet must sign each transaction in the order it is returned in the response. For example, the list of transactions may include a first a token approval transaction, and then a swap transaction.
Query
Bodyapplication/jsonrequiredThe source token chain. Must be one of the supported chains (Bitcoin, Ethereum, Polygon, Base or Solana)
The desired swap amount, specified in token currency. A value in fromTokenAmount is prioritized over fromTokenAmountUsd.
The desired swap amount, specified in US Dollars. A value in fromTokenAmount is prioritized over fromTokenAmountUsd.
The destination token chain. Must be one of the supported chains (Bitcoin, Ethereum, Polygon, Base or Solana)
A user selected quote to describe the desired swap. The quote must be one that was retrieved from the associated GET /swap API endpoint.
- Productionhttps://api.unstoppabledomains.com/profile/public/{address}/swap
- Staginghttps://api.ud-staging.com/profile/public/{address}/swap
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
curl -i -X POST \
'https://api.unstoppabledomains.com/profile/public/{address}/swap?fromChain=string&fromToken=string&fromTokenAmount=string&fromTokenAmountUsd=string&toChain=string&toToken=string&toWalletAddress=string' \
-H 'Content-Type: application/json' \
-d '{
"duration": 0,
"gas": "string",
"quote": {
"integration": "string",
"type": "string",
"bridgeFee": "string",
"bridgeFeeInNativeToken": "string",
"amount": "string",
"decimals": 0,
"amountUSD": "string",
"bridgeFeeUSD": "string",
"bridgeFeeInNativeTokenUSD": "string",
"priceImpact": "string"
},
"route": [
{
"bridge": "string"
}
],
"gasUsd": "string"
}'Response
application/json
[ { "id": "string", "type": "string", "transaction": { … } } ]
- Productionhttps://api.unstoppabledomains.com/profile/public/swap/chains
- Staginghttps://api.ud-staging.com/profile/public/swap/chains
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
curl -i -X GET \
https://api.unstoppabledomains.com/profile/public/swap/chainsResponse
application/json
[ "string" ]
- Productionhttps://api.unstoppabledomains.com/profile/public/swap/tokens
- Staginghttps://api.ud-staging.com/profile/public/swap/tokens
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
curl -i -X GET \
'https://api.unstoppabledomains.com/profile/public/swap/tokens?chain=string&token=string'Response
application/json
[ { "symbol": "string", "name": "string", "address": "string", "chain": "string", "decimals": 0, "logo": "string", "price": 0, "liquidityUsd": 0, "tags": [ … ] } ]