Skip to content
ChordChordChord Docs

Submit a signed permit deposit

POST
/crosschain/permit
curl --request POST \
  --url https://api.getchord.xyz/v1/crosschain/permit \
  --header 'Content-Type: application/json' \
  --data '{ "requestId": "0x17900816413eb4c1d4ec4b00d0be87c6b60872ed43d103eb87dc22a0b80ff325", "kind": "eip3009", "api": "swap", "signature": "0x…" }'

Hands a signed signature step from a usePermit quote back to the provider (Relay only): send the step’s post.body fields plus the EIP-712 signature. Then poll /crosschain/status.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
requestId
required
string
/^0x[a-fA-F0-9]{64}$/
kind
required

E.g. eip3009

string
api
required

E.g. swap

string
signature
required

0x… EIP-712 signature

string
Example
{
  "requestId": "0x17900816413eb4c1d4ec4b00d0be87c6b60872ed43d103eb87dc22a0b80ff325",
  "kind": "eip3009",
  "api": "swap",
  "signature": "0x…"
}

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json

Provider-shaped acknowledgement.

object
key
additional properties
any
Examplegenerated
{}

400

Section titled “400”

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

429

Section titled “429”

Over the per-minute limit (RATE_LIMIT_EXCEEDED). Read X-RateLimit-Reset and back off.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

502

Section titled “502”

The routing engine or an upstream did not answer (ENGINE_ERROR, ROUTE_ERROR).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

503

Section titled “503”

The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). Retry later; do not treat it as an empty answer.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}