Skip to main content

Create KYC Address

Create a new KYC address for a market.

Endpoint: POST /api/v1/integration/kyc-addresses/markets/{market_id}

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration

Path Parameters

ParameterTypeRequiredDescription
market_idstring (UUID)YesMarket ID

Request Body

{
"chain_id": 1,
"name": "kyc det",
"address": "0x1234567890abcdef"
}

Request Parameters

FieldTypeRequiredDescription
chain_idintegerYesBlockchain network ID (e.g., 1 = Ethereum Mainnet, 56 = BSC)
namestringYesKYC address name
addressstringYesBlockchain address

Response

Status: 201 Created

Returns the created KYC address object.

{
"id": "2912b1ca-cb13-49ed-9ed0-1133f81c5110",
"market_id": "262bed05-5a0e-4fff-8171-39fafab66b0c",
"name": "kyc det",
"address": "0x1234567890abcdef",
"chain_id": 1,
"created_at": "2025-12-24T00:26:50.286749+03:00",
"updated_at": "2025-12-24T00:26:50.286749+03:00"
}

Example cURL Request

curl -X POST 'https://<base-url>/api/v1/integration/kyc-addresses/markets/262bed05-5a0e-4fff-8171-39fafab66b0c' \
-H "Content-Type: application/json" \
-H "X-Target-Server: integration" \
-H "Authorization: Bearer <access_token>" \
-d '{
"chain_id": 1,
"name": "kyc det",
"address": "0x1234567890abcdef"
}'