Documentação da API P2P da CoinEx

Para atender às diversas necessidades de negociação dos usuários, a CoinEx agora suporta funcionalidades relacionadas à API P2P. Os detalhes são os seguintes:

Guia de Uso da API P2P da CoinEx

1. Usuários-alvo

Qualquer usuário que tenha concluído a verificação de ID de comerciante P2P na CoinEx. Se você ainda não é um comerciante verificado, precisa solicitar o status de comerciante P2P na página P2P antes de usar os serviços de API.

2. Eficiência de Execução e Conteúdo

Para usuários que operam via serviços de API, a eficiência da recuperação de informações e execução de solicitações é idêntica à da interface da CoinEx. No entanto, o conteúdo retornado pode ser truncado devido a restrições de campo.

3. Módulos Suportados

• Gerenciamento de Status da Loja P2P
• Gerenciamento de Anúncios P2P
• Lista de Anúncios do Usuário P2P
• Lista de Anúncios do Mercado P2P
• Lista de Ordens P2P
• Modificação de Preço de Anúncios P2P
• Dados de Profundidade do Mercado P2P

Documentação do Endpoint da API P2P

Visite a Documentação da API Pública da CoinEx para autenticação antes de usar os endpoints abaixo.

1. Gerenciamento de Status da Loja P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/exchange-status
• Método de Solicitação: POST
• Descrição: Configurar o status de negócios da loja P2P (Aberto ou Fechado)
• Permissão: Autenticação necessária

Parâmetros de Solicitação

Corpo da Solicitação

Exemplo de Solicitação

POST /v2/p2p/exchange-status HTTP/1.1
Host: api.coinex.com
Content-Type: application/json
{
  "status": "OPEN"
}

 

Parâmetros de Resposta

Exemplo de Resposta

{
  "code": 0,
  "mensagem": "OK",
  "dados": {
    "status": "ABERTO"
  }
}

 

2. Gerenciamento de Anúncios P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/manage-ads
• Método de Solicitação: POST
• Descrição: Gerenciar anúncios P2P em lote (Online ou Offline)
• Permissão: Autenticação necessária

Parâmetros de Solicitação

Corpo da Solicitação

Exemplo de Solicitação

POST /v2/p2p/gerenciar-ads HTTP/1.1
Host: api.coinex.com
Tipo de conteúdo: aplicação/json
{
  "status": "ONLINE",
  "ad_ids": ["5f7c8b9d1a2b3c4d5e6f7g8h", "5f7c8b9d1a2b3c4d5e6f7g9i"]
}

 

Parâmetros de Resposta

Exemplo de Resposta

{
  "código": 0,
  "mensagem": "OK",
  "dados": {
    "IDs de anúncios afetados": ["5f7c8b9d1a2b3c4d5e6f7g8h", "5f7c8b9d1a2b3c4d5e6f7g9i"]
  }
}

 

3. Lista de Anúncios do Usuário P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/ads
• Método de Solicitação: GET
• Descrição: Recuperar todos os anúncios do usuário atual
• Permissão: Autenticação necessária

Parâmetros de Solicitação

Nenhum

Exemplo de Solicitação

GET /v2/p2p/ads HTTP/1.1

Host: api.coinex.com

Parâmetros de Resposta

Retorna uma matriz de objetos de anúncios. Cada objeto de anúncio contém os seguintes campos:

Exemplo de Resposta

{
  "código": 0,
  "mensagem": "OK",
  "dados": [
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
      "criado_em": 1618456789000,
      "atualizado_em": 1618456789000,
      "número_do_anúncio": "AD123456789",
      "lado do anúncio": "BUY",
      "base_ccy": "BTC",
      "quote_ccy": "CNY",
      "preço": "200000",
      "quantidade_disponível": "0.5",
      "limite_min_de_citação": "500",
      "citação_limite_máximot": "50000",
      "status": "ONLINE"
    },
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g9i",
      "criado_em": 1618456790000,
      "atualizado_em": 1618456790000,
      "número_do_anúncio": "AD123456790",
      "lado do anúncio": "SELL",
      "base_ccy": "ETH",
      "quote_ccy": "CNY",
      "preço": "10000",
      "quantidade_disponível": "5",
      "limite_min_de_citação": "200",
      "limite_máximo_de_citação": "20000",
      "status": "OFFLINE"
    }
  ]
}

 

4. Lista de Anúncios do Mercado P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/market/ads
• Método de Solicitação: GET
• Descrição: Recuperar a lista de anúncios do mercado P2P
• Permissão: Autenticação não necessária

Parâmetros de Solicitação

Parâmetros de Consulta

Exemplo de Solicitação

GET /v2/p2p/market/ads?base_ccy=BTC&quote_ccy=CNY&order_side=COMPRE&página=1&limite=10 HTTP/1.1

Host: api.coinex.com

Parâmetros de Resposta

Exemplo de Resposta

{
  "código": 0,
  "mensagem": "OK",
  "dados": [
        {
            "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
            "criado_em": 1618456789000,
            "atualizado_em": 1618456789000,
            "número_do_anúncio": "AD123456789",
            "lado do anúncio": "BUY",
            "base_ccy": "BTC",
            "quote_ccy": "CNY",
            "preço": "200000",
            "quantidade_disponível": "0.5",
            "quote_min_limit": "500",
            "quote_max_limit": "50000",
            "status": "ONLINE"
        },
    ],
    "paginação": {
      "total": 50,
      "tem_próximo": true
    }
}

 

5. Lista de Ordens P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/order
• Método de Solicitação: GET
• Descrição: Recuperar a lista de ordens P2P do usuário
• Permissão: Autenticação necessária

Parâmetros de Solicitação

Parâmetros de Consulta

Exemplo de Solicitação

GET /v2/p2p/order?começar_tempo=1618456789000&end_tempo=1618556789000&status=CRIADO&páfina=1&limite=10 HTTP/1.1

Host: api.coinex.com

Parâmetros de Resposta

Cada objeto de ordem contém os seguintes campos:

Exemplo de Resposta

{
  "código": 0,
  "mensagem": "OK",
  "dados": [
      {
        "id_do_pedido": 12345,
        "número_do_pedido": "P2P123456789",
        "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
        "status": "FINISHED",
        "criado_em": 1618456789000,
        "terminado_em": 1618466789000,
        "confirmar_devido_em": 1618476789000,
        "pagamento_devido_em": 1618486789000,
        "lado do pedido": "BUY",
        "preço": "200000",
        "base_ccy": "BTC",
        "base_ccy_amount": "0.1",
        "quote_ccy": "CNY",
        "quote_ccy_quantia": "20000",
        "tipo_de_cancelamento": ""
      },
    ],
    "paginação": {
      "total": 25,
      "tem_próximo": true
    }
}

 

6. Modificação de Preço de Anúncios P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/modify-ads
• Método de Solicitação: POST
• Descrição: Modificar preços de anúncios P2P em lote
• Permissão: Autenticação necessária

Parâmetros de Solicitação

Corpo da Solicitação

Cada elemento na matriz ads contém os seguintes campos:

Exemplo de Solicitação

PUBLICAR /v2/p2p/modify-ads HTTP/1.1
Host: api.coinex.com
Tipo de conteúdo: application/json
{
  "ads": [
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
      "preço": "210000"
    },
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g9i",
      "preço": "11000"
    }
  ]
}

 

Parâmetros de Resposta

A resposta retorna uma matriz de resultados para cada anúncio modificado. Cada elemento contém os seguintes campos:

Exemplo de Resposta

{
  "código": 0,
  "mensagem": "OK",
  "dados": [
    {
      "código": 0,
      "mensagem": "OK",
      "dados": {
        "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
        "criado_em": 1618456789000,
        "atualizado_em": 1618556789000,
        "número_do_anúncio": "AD123456789",
        "lado do anúncio": "BUY",
        "base_ccy": "BTC",
        "quote_ccy": "CNY",
        "preço": "210000",
        "quantidade_disponível": "0.5",
        "limite_min_de_citação": "500",
        "limite_máximo_de_citação": "50000",
        "status": "ONLINE"
      }
    },
    {
      "código": 11002,
      "mensagem": "adv not exists",
      "dados": null
    }
  ]
}

 

7. Dados de Profundidade do Mercado P2P

Informações do Endpoint

• Caminho URL: /v2/p2p/market/depth
• Método de Solicitação: GET
• Descrição: Recuperar dados de profundidade do mercado P2P
• Permissão: Autenticação não necessária

Parâmetros de solicitação

Parâmetros de Consulta

Exemplo de Solicitação

GET /v2/p2p/mercado/profundidade?base_ccy=BTC&quote_ccy=CNY HTTP/1.1

Host: api.coinex.com

Parâmetros de Resposta

Cada elemento nas matrizes de profundidade contém os seguintes campos:

Exemplo de Resposta

{
  "código": 0,
  "mensagem": "OK",
  "dados": {
    "base_ccy": "BTC",
    "quote_ccy": "CNY",
    "index_price": "200000",
    "profundidade": {
      "lances": [
        {
          "preço": "199000",
          "quantia": "1.5",
        },
        {
          "preço": "198000",
          "quantia": "2.0",
        }
      ],
      "pergunta": [
        {
          "preço": "201000",
          "quantia": "1.0",
        },
        {
          "preço": "202000",
          "quantia": "1.8",
        },
      ]
    }
  }
}