Parse a derivation path

Parses a derivation path back into its components: the network + the value of each route (for static routes, with the matched variant; disabled ones are recognized too). Fails if the prefix isn't m/44/, the coinType isn't connected to the Vault, or the number of segments doesn't match the structure.

curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/test_vault/derivation-path/parse" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "path": "m/44/195/0/0/1/1/0"
}'

import requests
import json

url = "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/test_vault/derivation-path/parse"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
  "path": "m/44/195/0/0/1/1/0"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/test_vault/derivation-path/parse", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
},
  body: JSON.stringify({
  "path": "m/44/195/0/0/1/1/0"
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "path": "m/44/195/0/0/1/1/0"
}`)

    req, err := http.NewRequest("POST", "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/test_vault/derivation-path/parse", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/test_vault/derivation-path/parse')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
  "path": "m/44/195/0/0/1/1/0"
}'

response = http.request(request)
puts response.body

{
  "network": {
    "id": "cmr3f41z20001psp7phmyapw3",
    "coinType": 195,
    "code": "tron_network",
    "slug": "tron",
    "name": "Tron",
    "description": "example_string",
    "logoUri": "https://cdn.example.com/networks/tron.png",
    "type": "TRON",
    "createdAt": "2026-07-02T11:25:15.134000Z",
    "updatedAt": "2026-07-02T11:25:15.134000Z"
  },
  "segments": [
    {
      "route": {
        "id": "cmr3f41z20001psp7phmyapw3",
        "vaultId": "example_string",
        "order": 0,
        "code": "purpose",
        "name": "John Doe",
        "description": "example_string",
        "dynamic": true,
        "createdAt": "2026-07-02T11:25:15.134000Z",
        "updatedAt": "2026-07-02T11:25:15.134000Z",
        "variants": [
          {
            "id": "cmr3f41z20001psp7phmyapw3",
            "routeId": "example_string",
            "pathId": 1,
            "code": "usdt",
            "name": "John Doe",
            "description": "example_string",
            "enabled": true,
            "tokenId": "example_string",
            "createdAt": "2026-07-02T11:25:15.134000Z",
            "updatedAt": "2026-07-02T11:25:15.134000Z"
          }
        ]
      },
      "pathId": 123,
      "variant": {
        "id": "cmr3f41z20001psp7phmyapw3",
        "routeId": "example_string",
        "pathId": 1,
        "code": "usdt",
        "name": "John Doe",
        "description": "example_string",
        "enabled": true,
        "tokenId": "example_string",
        "createdAt": "2026-07-02T11:25:15.134000Z",
        "updatedAt": "2026-07-02T11:25:15.134000Z"
      }
    }
  ]
}

{
  "error": "Bad Request",
  "message": "The request contains invalid parameters or malformed data",
  "code": 400,
  "details": [
    {
      "field": "email",
      "message": "Invalid email format"
    }
  ]
}

POST

/api/v1/vaults/{code}/derivation-path/parse

POST

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

Session token. Mobile/services. The web uses a cookie.

API Key (cookie: session_token)

session_tokenstring

Required

API key (sent in cookie)

path

codestring

Required

Unique Vault code (slug)

Content-Typestring

Required

The media type of the request body

Options: application/json

pathstring

Required

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. Session token. Mobile/services. The web uses a cookie.

path

parameterstring

Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

codestring

Required

Unique Vault code (slug)

Example:

test_vault

Body

application/json

pathstring

Required

Example:

m/44/195/0/0/1/1/0

Responses

networkobject

Required

segmentsarray

Required

Was this page helpful?