Skip to navigation

List market ads

Active ads of the single CorpX book: ads of every tenant with p2p_crypto on, never saying which tenant they belong to. side=sell lists ads where the advertiser sells (you buy). Price is computed from the current Binance spot for spread and offset ads; an ad without a usable quote is omitted. A buy ad is also omitted while its advertiser could not pay for it: cashout blocked, or outside the account’s cashout hours. Off for every tenant until CorpX enables p2p_crypto (403 feature_disabled).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Query parameters

sideenumOptional
Advertiser side.
Allowed values:
pairstringOptional
Pair code.
amountstringOptional
Only ads whose limits accept this BRL amount.
sortenumOptionalDefaults to price
Ordering.
Allowed values:
pageintegerOptionalDefaults to 1

Page (1-based).

sizeintegerOptionalDefaults to 50

Page size (1–100).

Response

Ads
itemslist of objectsOptional
totalintegerOptional
Ads matching the filter.

Errors

400
Bad Request Error
403
Forbidden Error