RFC 6920 SHA-256 Content Naming
Name exact binary content with a canonical authority-free RFC 6920 SHA-256 NI URI and well-known retrieval path. Accept a strict media-typed RFC 4648 Base64 carrier; refuse malformed/noncanonical encoding before payment. Up to 65536 decoded bytes; no storage, model or upstream compute.
- Price
- from $0.0012 USDC per request (starting price; the 402 response quotes the exact amount for your input)
- Network
- Base mainnet,
eip155:8453, settled in USDC through the Coinbase CDP facilitator - Method and URL
POST https://market.561.group/v1/data/ni-hash- Response type
application/json- Seller
- Causeway Services (561 Group)
Input contract
Input that fails this contract is refused with a 4xx status before any payment is requested.
{
"maxBytes": 102400,
"bodySchema": {
"type": "object",
"additionalProperties": false,
"required": [
"carrier"
],
"properties": {
"carrier": {
"type": "object",
"additionalProperties": false,
"required": [
"mediaType",
"contentBase64"
],
"properties": {
"mediaType": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"contentBase64": {
"type": "string",
"maxLength": 87384
}
}
}
}
}
}
Example request
{
"method": "POST",
"url": "https://market.561.group/v1/data/ni-hash",
"headers": {
"accept": "application/json",
"content-type": "application/json"
},
"body": {
"carrier": {
"mediaType": "application/octet-stream",
"contentBase64": "AAEC/w=="
}
}
}
Output
{
"schema": {
"type": "object",
"additionalProperties": false,
"required": [
"uri",
"wellKnownPath",
"byteLength"
],
"properties": {
"uri": {
"type": "string"
},
"wellKnownPath": {
"type": "string"
},
"byteLength": {
"type": "integer",
"minimum": 0
}
}
},
"example": {
"uri": "ni:///sha-256;PR9XyYSXjvmKGDeMgWbBy47eAsA-62rufi8SHf7uPlY",
"wellKnownPath": "/.well-known/ni/sha-256/PR9XyYSXjvmKGDeMgWbBy47eAsA-62rufi8SHf7uPlY",
"byteLength": 4
}
}
How to buy with x402
- Send the request without payment. The server answers
402 Payment Requiredwith a base64 JSONPAYMENT-REQUIREDheader holding the amount, asset, network and payee. - Have your wallet sign an EIP-3009
transferWithAuthorizationfor exactly those terms (an x402 client library does this for you). - Repeat the identical request with the signed payload in the
PAYMENT-SIGNATUREheader. - The server verifies, runs the operation, settles, and returns
200with the result and aPAYMENT-RESPONSEheader carrying the settlement receipt.
Read the price without paying
curl --include --request POST --header 'accept: application/json' --header 'content-type: application/json' --data-raw '{"carrier":{"mediaType":"application/octet-stream","contentBase64":"AAEC/w=="}}' --url 'https://market.561.group/v1/data/ni-hash'
This request authorizes nothing; it returns the live payment terms. Read the full explanation of x402.
Machine-readable
- /.well-known/x402: x402 discovery document for every offer
- /v1/catalog: full catalog with contracts and examples
- /llms.txt: the market in llms.txt form
- services.561.group: Causeway Services