Create Token

Create a new token for a node and distributor.

Endpoint: POST /api/v1/integration/tokens/nodes/{node_id}/distributors/{distributor_id}

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration
Content-Type: application/json

Path Parameters

Parameter	Type	Required	Description
`node_id`	string (UUID)	Yes	Node ID
`distributor_id`	string (UUID)	Yes	Distributor ID

Request Body

{
  "name": "My Token",
  "symbol": "MTK",
  "description": "This is a sample token description",
  "chain_id": 1,
  "value": 100.50,
  "supply": 1000000,
  "external_id": "ext_token_12345",
  "contract": {
    "address": "0x1234567890123456789012345678901234567890",
    "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  },
  "rules": {
    "max_purchase_limit": 10000,
    "min_purchase_limit": 100
  },
  "status": 2,
  "integration": {
    "chain_id": 1,
    "abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
    "contract_address": "0x9876543210987654321098765432109876543210",
    "function_name": "transfer",
    "currency_token_address": "0x1111111111111111111111111111111111111111",
    "is_approved": true,
    "args": [
      {
        "type": "address",
        "value": "0x2222222222222222222222222222222222222222",
        "description": "Recipient address"
      },
      {
        "type": "uint256",
        "value": "1000000000000000000",
        "description": "Amount to transfer"
      }
    ]
  },
  "currency_token_address": "0x1111111111111111111111111111111111111111",
  "currency_token_symbol": "USDT",
  "currency_token_decimals": 18,
  "currency_token_name": "Tether USD",
  "meta": {
    "images": [
      {
        "url": "https://example.com/images/token-logo.png",
        "is_default": true,
        "hash": "abc123def456"
      },
      {
        "url": "https://example.com/images/token-banner.jpg",
        "is_default": false,
        "hash": "def456ghi789"
      }
    ],
    "documents": [
      {
        "name": "Whitepaper",
        "url": "https://example.com/documents/whitepaper.pdf",
        "type": 2,
        "hash": "whitepaper_hash_123"
      },
      {
        "name": "Terms of Service",
        "url": "https://example.com/documents/terms.pdf",
        "type": 3,
        "hash": "terms_hash_456"
      }
    ]
  }
}

Request Parameters

Field	Type	Required	Description
`name`	string	Yes	Token name
`symbol`	string	Yes	Token symbol
`description`	string	No	Token description
`chain_id`	integer	Yes	Blockchain network ID
`value`	number	Yes	Token value
`supply`	integer	Yes	Total token supply
`external_id`	string	No	External token identifier
`contract`	object	No	Contract information
`contract.address`	string	No	Contract address
`contract.hash`	string	No	Contract hash
`rules`	object	No	Purchase rules
`rules.max_purchase_limit`	integer	No	Maximum purchase limit
`rules.min_purchase_limit`	integer	No	Minimum purchase limit
`status`	integer	Yes	Token status
`integration`	object	No	Integration configuration
`integration.chain_id`	integer	No	Integration chain ID
`integration.abi`	string	No	Contract ABI (JSON string)
`integration.contract_address`	string	No	Integration contract address
`integration.function_name`	string	No	Function name to call
`integration.currency_token_address`	string	No	Currency token address
`integration.is_approved`	boolean	No	Whether the contract is approved
`integration.args`	array	No	Function arguments
`integration.args[].type`	string	No	Argument type
`integration.args[].value`	string	No	Argument value
`integration.args[].description`	string	No	Argument description
`currency_token_address`	string	No	Currency token address
`currency_token_symbol`	string	No	Currency token symbol
`currency_token_decimals`	integer	No	Currency token decimals
`currency_token_name`	string	No	Currency token name
`meta`	object	No	Metadata (images and documents)
`meta.images`	array	No	Token images
`meta.images[].url`	string	No	Image URL
`meta.images[].is_default`	boolean	No	Whether this is the default image
`meta.images[].hash`	string	No	Image hash
`meta.documents`	array	No	Token documents
`meta.documents[].name`	string	No	Document name
`meta.documents[].url`	string	No	Document URL
`meta.documents[].type`	integer	No	Document type
`meta.documents[].hash`	string	No	Document hash

Response

Status: 201 Created

Returns the created token object with full details.

{
  "id": "4c3e2fd0-cbed-4c01-aad5-e39fa9e17fa4",
  "node_id": "e40efce4-38a3-46c4-a202-e8db95d0409c",
  "distributor_id": "084a5159-1546-4ade-a7ba-956e0234a417",
  "currency_token_id": "c94c94fc-479d-4d08-bba0-123a210c174c",
  "chain_id": 1,
  "name": "My Token",
  "description": "This is a sample token description",
  "symbol": "MTK",
  "value": 100.5,
  "supply": 1000000,
  "external_id": "ext_token_12345",
  "contract": {
    "address": "0x1234567890123456789012345678901234567890",
    "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  },
  "rules": {
    "max_purchase_limit": 10000,
    "min_purchase_limit": 100
  },
  "status": 2,
  "integration": {
    "chain_id": 1,
    "abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
    "contract_address": "0x9876543210987654321098765432109876543210",
    "function_name": "transfer",
    "currency_token_address": "0x1111111111111111111111111111111111111111",
    "is_approved": true,
    "args": [
      {
        "type": "address",
        "value": "0x2222222222222222222222222222222222222222",
        "description": "Recipient address"
      },
      {
        "type": "uint256",
        "value": "1000000000000000000",
        "description": "Amount to transfer"
      }
    ]
  },
  "meta": {
    "images": [
      {
        "id": "073a551e-583f-498d-8b2f-c8d088995d30",
        "url": "https://example.com/images/token-logo.png",
        "is_default": true,
        "hash": "abc123def456",
        "created_at": "2025-12-24T10:05:48.503461Z"
      },
      {
        "id": "c89102a7-ded1-4d97-b503-d85af888ffc8",
        "url": "https://example.com/images/token-banner.jpg",
        "is_default": false,
        "hash": "def456ghi789",
        "created_at": "2025-12-24T10:05:48.504681Z"
      }
    ],
    "documents": [
      {
        "id": "56a00061-8336-4009-9247-01eaad054e7c",
        "name": "Whitepaper",
        "url": "https://example.com/documents/whitepaper.pdf",
        "type": 2,
        "hash": "whitepaper_hash_123",
        "created_at": "2025-12-24T10:05:48.505861Z"
      },
      {
        "id": "fc7a8a2a-7e35-4169-9293-0f272c1fb0eb",
        "name": "Terms of Service",
        "url": "https://example.com/documents/terms.pdf",
        "type": 3,
        "hash": "terms_hash_456",
        "created_at": "2025-12-24T10:05:48.50757Z"
      }
    ]
  },
  "created_at": "2025-12-24T13:05:48.496502+03:00",
  "updated_at": "2025-12-24T13:05:48.496502+03:00"
}

Example cURL Request

curl -X POST 'https://<base-url>/api/v1/integration/tokens/nodes/e40efce4-38a3-46c4-a202-e8db95d0409c/distributors/084a5159-1546-4ade-a7ba-956e0234a417' \
  -H "Content-Type: application/json" \
  -H "X-Target-Server: integration" \
  -H "Authorization: Bearer <access_token>" \
  -d '{
    "name": "My Token",
    "symbol": "MTK",
    "description": "This is a sample token description",
    "chain_id": 1,
    "value": 100.50,
    "supply": 1000000,
    "external_id": "ext_token_12345",
    "contract": {
      "address": "0x1234567890123456789012345678901234567890",
      "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    },
    "rules": {
      "max_purchase_limit": 10000,
      "min_purchase_limit": 100
    },
    "status": 2,
    "integration": {
      "chain_id": 1,
      "abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
      "contract_address": "0x9876543210987654321098765432109876543210",
      "function_name": "transfer",
      "currency_token_address": "0x1111111111111111111111111111111111111111",
      "is_approved": true,
      "args": [
        {
          "type": "address",
          "value": "0x2222222222222222222222222222222222222222",
          "description": "Recipient address"
        },
        {
          "type": "uint256",
          "value": "1000000000000000000",
          "description": "Amount to transfer"
        }
      ]
    },
    "currency_token_address": "0x1111111111111111111111111111111111111111",
    "currency_token_symbol": "USDT",
    "currency_token_decimals": 18,
    "currency_token_name": "Tether USD",
    "meta": {
      "images": [
        {
          "url": "https://example.com/images/token-logo.png",
          "is_default": true,
          "hash": "abc123def456"
        },
        {
          "url": "https://example.com/images/token-banner.jpg",
          "is_default": false,
          "hash": "def456ghi789"
        }
      ],
      "documents": [
        {
          "name": "Whitepaper",
          "url": "https://example.com/documents/whitepaper.pdf",
          "type": 2,
          "hash": "whitepaper_hash_123"
        },
        {
          "name": "Terms of Service",
          "url": "https://example.com/documents/terms.pdf",
          "type": 3,
          "hash": "terms_hash_456"
        }
      ]
    }
  }'

Path Parameters​

Request Body​

Request Parameters​

Response​

Example cURL Request​

Path Parameters

Request Body

Request Parameters

Response

Example cURL Request