IdentHash API Reference
Blockchain-native Travel Rule compliance and RWA ownership proof. Integrate in minutes. Zero PII on-chain.
Overview
The IdentHash API allows VASPs and exchanges to record cryptographically bound identity hashes on Polygon Mainnet — satisfying FATF Travel Rule requirements without exposing any personal data on-chain.
✅ Live on Polygon Mainnet — Contract:
All API calls result in real, immutable on-chain transactions verifiable on PolygonScan.
0xa7f305caF79c0189ffC344114fBa571C4D0cD7A8All API calls result in real, immutable on-chain transactions verifiable on PolygonScan.
⚠️ Patent Pending — KR 10-2026-0068484 (46 claims, PCT filing in progress) · TTA Korean Standard Applied (2026-P0873)
Authentication
All API requests require an API key passed in the request header. To obtain an API key, contact us at mearida@hanmail.net or WhatsApp +82 10 5713 1636.
// Include in all requests
x-api-key: your_api_key_here
Base URL
// Production
https://api.identhash.com
// Demo (no API key required)
https://ihashattest.com/identhash-demo.html
Travel Rule Endpoints
POST
/api/record
Record IdentHash on-chain
Records a Travel Rule compliance hash on Polygon Mainnet. The IdentHash cryptographically binds sender and receiver identity without exposing personal data on-chain.
Request Headers
| Header | Description |
|---|---|
| x-api-key required | Your IdentHash API key |
| Content-Type | application/json |
Request Body
| Field | Type | Description |
|---|---|---|
| orderId required | string | Unique transaction/order identifier |
| assetType required | string | Asset type: USDC, USDT, RWA, STO, etc. |
| amount required | number | Transfer amount |
| sender.name required | string | Sender legal name |
| sender.id required | string | Sender ID number |
| sender.wallet required | string | Sender wallet address |
| sender.securitiesId optional | string | Sender securities account ID |
| receiver.name required | string | Receiver legal name |
| receiver.id required | string | Receiver ID number |
| receiver.wallet required | string | Receiver wallet address |
Example Request
POST https://api.identhash.com/api/record
x-api-key: your_api_key
Content-Type: application/json
{
"orderId": "ORD-2026-001",
"assetType": "USDC",
"amount": 1000,
"sender": {
"name": "Hong Gildong",
"id": "KR001",
"wallet": "0xSenderWalletAddress"
},
"receiver": {
"name": "Jane Smith",
"id": "US002",
"wallet": "0xReceiverWalletAddress"
}
}
Response
200 OK 400 Bad Request 401 Unauthorized{
"success": true,
"identHash": "0xabc123...",
"txHash": "0xdef456...",
"polygonScan": "https://polygonscan.com/tx/0xdef456...",
"blockNumber": 65432100,
"timestamp": "2026-06-29T12:00:00Z"
}
GET
/api/record/:identHash
Verify existing record
Verify an existing IdentHash record on Polygon Mainnet.
Example Request
GET https://api.identhash.com/api/record/0xabc123...
x-api-key: your_api_key
Response
200 OK{
"found": true,
"identHash": "0xabc123...",
"txHash": "0xdef456...",
"blockNumber": 65432100,
"timestamp": "2026-06-29T12:00:00Z",
"polygonScan": "https://polygonscan.com/tx/0xdef456..."
}
GET
/api/health
Server health check
GET https://api.identhash.com/api/health
{
"status": "ok",
"version": "2.2",
"network": "polygon-mainnet"
}
IdentHash Standard
The IdentHash standard defines how identity is cryptographically bound to asset transfers.
// IdentHash Formula (Patent Pending: KR 10-2026-0068484)
IdentHash = H( asset_id ‖ S_bundle ‖ R_bundle ‖ amount ‖ nonce )
// S_bundle (Sender)
S_bundle = ( wallet ‖ securities_id ‖ PII_commitment )
// R_bundle (Receiver)
R_bundle = ( wallet ‖ securities_id ‖ PII_commitment )
// PII_commitment — No plaintext personal data on-chain ever
PII_commitment = H( name ‖ ID_number ‖ address ‖ salt )
// H = SHA-256 or Keccak-256 · salt = 32 bytes random
Smart Contract
IdentHash TRP v2.2 is deployed on Polygon Mainnet.
| Property | Value |
|---|---|
| Network | Polygon Mainnet (Chain ID: 137) |
| Contract Address | 0xa7f305caF79c0189ffC344114fBa571C4D0cD7A8 |
| Version | v2.2 |
| Standard | AML Compliant · FATF Travel Rule |
| Explorer | View on PolygonScan → |
Error Codes
| Code | Message | Description |
|---|---|---|
| 400 | Bad Request | Missing required fields or invalid format |
| 401 | Unauthorized | Invalid or missing API key |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Blockchain transaction failed |
📧 Need help? Contact us at mearida@hanmail.net or WhatsApp +82 10 5713 1636