交易

List all deals

post

List all deals

Body

application/json

preparationsstring[]Optional

preparation ID or name filter

providersstring[]Optional

provider filter

schedulesinteger[]Optional

schedule id filter

sourcesstring[]Optional

source ID or name filter

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/deal

HTTPcURLJavaScriptPython

POST /api/deal HTTP/1.1
Host: localhost:9090
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "preparations": [
    "text"
  ],
  "providers": [
    "text"
  ],
  "schedules": [
    1
  ],
  "sources": [
    "text"
  ],
  "states": [
    "proposed"
  ]
}

[
  {
    "clientId": "text",
    "createdAt": "text",
    "dealId": 1,
    "endEpoch": 1,
    "errorMessage": "text",
    "id": 1,
    "label": "text",
    "lastVerifiedAt": "text",
    "pieceCid": "text",
    "pieceSize": 1,
    "price": "text",
    "proposalId": "text",
    "provider": "text",
    "scheduleId": 1,
    "sectorStartEpoch": 1,
    "startEpoch": 1,
    "state": "proposed",
    "updatedAt": "text",
    "verified": true
  }
]

Send a manual deal proposal

post

Send a manual deal proposal

Body

application/json

clientAddressstringOptional

Client address

durationstringOptional

Duration in epoch or in duration format, i.e. 1500000, 2400h

Default: 12740h

fileSizeintegerOptional

File size in bytes for boost to fetch the CAR file

httpHeadersstring[]Optional

http headers to be passed with the request (i.e. key=value)

ipnibooleanOptional

Whether the deal should be IPNI

Default: true

keepUnsealedbooleanOptional

Whether the deal should be kept unsealed

Default: true

pieceCidstringOptional

Piece CID

pieceSizestringOptional

Piece size

pricePerDealnumberOptional

Price in FIL per deal

Default: 0

pricePerGbnumberOptional

Price in FIL per GiB

Default: 0

pricePerGbEpochnumberOptional

Price in FIL per GiB per epoch

Default: 0

providerIdstringOptional

Provider ID

rootCidstringOptional

Root CID that is required as part of the deal proposal, if empty, will be set to empty CID

Default: bafkqaaa

startDelaystringOptional

Deal start delay in epoch or in duration format, i.e. 1000, 72h

Default: 72h

urlTemplatestringOptional

URL template with PIECE_CID placeholder for boost to fetch the CAR file, i.e. http://127.0.0.1/piece/{PIECE_CID}.car

verifiedbooleanOptional

Whether the deal should be verified

Default: true

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/send_deal

HTTPcURLJavaScriptPython

POST /api/send_deal HTTP/1.1
Host: localhost:9090
Content-Type: application/json
Accept: */*
Content-Length: 298

{
  "clientAddress": "text",
  "duration": "12740h",
  "fileSize": 1,
  "httpHeaders": [
    "text"
  ],
  "ipni": true,
  "keepUnsealed": true,
  "pieceCid": "text",
  "pieceSize": "text",
  "pricePerDeal": 0,
  "pricePerGb": 0,
  "pricePerGbEpoch": 0,
  "providerId": "text",
  "rootCid": "bafkqaaa",
  "startDelay": "72h",
  "urlTemplate": "text",
  "verified": true
}

{
  "clientId": "text",
  "createdAt": "text",
  "dealId": 1,
  "endEpoch": 1,
  "errorMessage": "text",
  "id": 1,
  "label": "text",
  "lastVerifiedAt": "text",
  "pieceCid": "text",
  "pieceSize": 1,
  "price": "text",
  "proposalId": "text",
  "provider": "text",
  "scheduleId": 1,
  "sectorStartEpoch": 1,
  "startEpoch": 1,
  "state": "proposed",
  "updatedAt": "text",
  "verified": true
}