Look up an on-chain builder
curl --request GET \
--url https://api.route.fun/api/v2/builders/profile \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.route.fun/api/v2/builders/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.route.fun/api/v2/builders/profile"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"builder": {
"code": "<string>",
"owner": "<string>",
"pendingOwner": "<string>",
"recipient": "<string>",
"builderFeeBps": 25,
"maxBuilderFeeBps": 25,
"routeFeeBps": 25,
"enabled": true,
"version": 123,
"policySource": "onchain",
"registry": "<string>",
"policyBlock": "<string>",
"policyBlockHash": "<string>"
}
}Builder registry
Look up an on-chain builder
Requires tokens scope and shares its quota. Reads verified canonical registry state, including suspended codes. Unknown code returns 404; uncommissioned registry returns 503. No local-database fallback.
GET
/
api
/
v2
/
builders
/
profile
Look up an on-chain builder
curl --request GET \
--url https://api.route.fun/api/v2/builders/profile \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.route.fun/api/v2/builders/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.route.fun/api/v2/builders/profile"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"builder": {
"code": "<string>",
"owner": "<string>",
"pendingOwner": "<string>",
"recipient": "<string>",
"builderFeeBps": 25,
"maxBuilderFeeBps": 25,
"routeFeeBps": 25,
"enabled": true,
"version": 123,
"policySource": "onchain",
"registry": "<string>",
"policyBlock": "<string>",
"policyBlockHash": "<string>"
}
}Use your generated workspace builder ID as
Authentication · Builder integration
code. This reads the registered owner, payout wallet, default fee, fee cap and enabled status.
routeFeeBps: null means Route’s standard fee schedule applies. An ID assigned in the portal can return 404 until registered onchain.
curl 'https://api.route.fun/api/v2/builders/profile?code=YOUR_BUILDER_ID' \
-H "x-api-key: $ROUTE_API_KEY"
Authorizations
Server-side key created in an authenticated developer workspace. Builder codes are public attribution, not credentials.
Query Parameters
Pattern:
^[A-Za-z0-9_-]{3,32}$Response
Verified registry or finalized history result
Show child attributes
Show child attributes