Skip to main content
POST
/
v1
/
task
cURL
curl --request POST \
  --url https://api.predicate.io/v1/task \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "from": "0x38f6001e8ac11240f903CBa56aFF72A1425ae371",
  "to": "0xe7f2cd31e61b05b7634fc532c59b78a5dfba8080",
  "data": "0x",
  "msg_value": "0",
  "chain_id": 1
}
'
{
  "is_compliant": true,
  "signers": [
    "0xDAc74b6f9B3609E914c924eB87Adff87A30fcDf6"
  ],
  "signature": [
    "0x8e10271f744c41e134d0e4ec92931a93a25c249730c1677d5be723831d68d0c660bb3c3aa409ed06d20a07367b1707908c49ef1209f8c50328cb77d2b4cac3821c"
  ],
  "expiry_block": 123,
  "task_id": "e4732bbe-aa8f-44fb-8c09-c73bdc31eeae"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
from
string
required

Address of the sender (must be a valid Ethereum address)

Example:

"0x1234567890123456789012345678901234567890"

​
to
string
required

Destination address (the target smart contract which enforces the policy)

Example:

"0x1234567890123456789012345678901234567890"

​
data
string
required

Hex-encoded calldata relevant for the contract function call e.g., amount to lend, recipient address, etc.

Example:

"0x"

​
msg_value
string
required

Amount of ETH (in wei) to send with the transaction

Example:

"0"

​
chain_id
integer<uint64>

Optional chain ID for the target blockchain. If not provided, defaults to ethereum mainnet (1)

Example:

1

Response

Successfully processed task

​
is_compliant
boolean

Indicates whether the transaction meets the policy requirements

Example:

true

​
signers
string[]

The addresses that signed off on the users compliance status

​
signature
string[]

A ECDSA Signature from the Predicate attestation server

​
expiry_block
integer<uint64>

Timestamp after which this response is no longer valid (prev block number)

​
task_id
string<uuid>

Unique identifier for the task

Example:

"e4732bbe-aa8f-44fb-8c09-c73bdc31eeae"